Übersicht

Die API für umgekehrte Geokodierung gibt den oder die nächstgelegenen Standorte zu einem gegebenen Breiten- und Längengrad zurück. Nützlich, um Gerätekoordinaten in einen benannten Standort umzuwandeln.

Endpoint

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

Parameter

Parameter	Erforderlich	Standard	Beschreibung
`lat`	Ja	—	Breitengrad (-90 bis 90)
`lon`	Ja	—	Längengrad (-180 bis 180)
`language`	Nein	`en`	Sprachcode für lokalisierte Ergebnisse (z.B. `de`, `it`, `fr`)
`limit`	Nein	`1`	Anzahl der nächstgelegenen Standorte (max. 50)

Beispielanfrage

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

Beispielantwort

{
  "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
}

Antwortfelder

Alle standardmäßigen Geokodierungs-Antwortfelder sind enthalten, plus:

Feld	Typ	Beschreibung
`distance_km`	float	Entfernung von der Abfragekoordinate zum Standort in Kilometern

Fehler

Status	Beschreibung
`400`	Parameter `lat` oder `lon` fehlt
`503`	Geokodierungsdaten noch nicht geladen