Panoramica

L’API di geocodifica inversa restituisce la o le località più vicine a una data latitudine e longitudine. Utile per convertire le coordinate del dispositivo in una località con nome.

Endpoint

GET /geocoding/reverse?lat={latitude}&lon={longitude}

Parametri

Parametro	Obbligatorio	Predefinito	Descrizione
`lat`	Sì	—	Latitudine (da -90 a 90)
`lon`	Sì	—	Longitudine (da -180 a 180)
`language`	No	`en`	Codice lingua per risultati localizzati (es. `de`, `it`, `fr`)
`limit`	No	`1`	Numero di località più vicine da restituire (max 50)

Richiesta di esempio

GET /geocoding/reverse?lat=47.37&lon=8.55

Risposta di esempio

{
  "results": [
    {
      "id": "3704415940",
      "name": "Zürich",
      "lat": 47.36667,
      "lon": 8.55,
      "distance_km": 0.4,
      "country_code": "CH",
      "country_name": "Switzerland",
      "admin1_name": "Kanton Zürich",
      "timezone": "Europe/Zurich",
      "population": 341730,
      "feature_code": "PPLA"
    }
  ],
  "count": 1
}

Campi della risposta

Tutti i campi standard della risposta di geocodifica sono inclusi, più:

Campo	Tipo	Descrizione
`distance_km`	float	Distanza dalla coordinata di ricerca alla località, in chilometri

Errori

Status	Descrizione
`400`	Parametro `lat` o `lon` mancante
`503`	Dati di geocodifica non ancora caricati