Torna alla lista

Luoghi Sicilia v1

Restituisce i luoghi georeferenziati della Sicilia pubblicati su Lexiper. Endpoint pubblico, utilizzato dal Toolkit Mappa per visualizzare i luoghi su cartografia interattiva.

→ Pagina di test

Endpoint

GET /api/v1/geo_luoghi_sicilia

Autenticazione

Autenticazione: none

Ogni richiesta deve includere la chiave API nell'header HTTP X-API-Key.

X-API-Key: <api_key>

Se la chiave è assente o non valida l'API risponde con HTTP 401.

Parametri

Parametro Tipo Obbligatorio Descrizione
q string Opzionale Filtro per nome del luogo (ricerca parziale, case-insensitive).
limit integer Opzionale Numero massimo di risultati. Default: 500. Massimo: 1000.
offset integer Opzionale Offset per la paginazione. Default: 0.

Note

  • Restituisce solo i luoghi con stato 'Pubblicato'.
  • I campi geonames_id e osm_id sono presenti solo se valorizzati.
  • I luoghi privi di coordinate (latitudine/longitudine) sono esclusi dalla risposta.
  • Endpoint pensato per uso diretto dal Toolkit Mappa: <script src="https://lexiper.it/toolkit/mappa.js?risorsa=luoghi_sicilia"></script>

Esempio richiesta

GET https://lexiper.it/api/v1/geo_luoghi_sicilia
GET https://lexiper.it/api/v1/geo_luoghi_sicilia?q=aci&limit=20

Esempio risposta

{
    "status": "success",
    "data": [
        {
            "nome": "Aci Trezza",
            "lat": 37.5623,
            "lng": 15.1641,
            "nota": "Borgo marinaro del Comune di Aci Castello.",
            "geonames_id": "2525068",
            "osm_id": "node\/12345"
        },
        {
            "nome": "Siracusa",
            "lat": 37.0755,
            "lng": 15.2866
        }
    ]
}