Übersicht

Die Geokodierungs-API ermöglicht die weltweite Suche nach Standorten und den Abruf von Standortdetails. Sie unterstützt unscharfe Suche, lokalisierte Ergebnisse und direkte ID-Abfragen.

Suche

Nach Standorten anhand des Namens suchen, mit optionaler unscharfer Zuordnung.

GET /geocoding/lookup?q={query}

Parameter

Parameter	Erforderlich	Standard	Beschreibung
`q`	Ja	—	Suchanfrage (mindestens 2 Zeichen)
`language`	Nein	`en`	Sprachcode für lokalisierte Ergebnisse (z.B. `de`, `it`, `fr`)
`field`	Nein	`name`	Suchbereich. `name` durchsucht nur Standortnamen. `all` durchsucht Name, Verwaltungsregion und Land.
`country`	Nein	—	ISO 3166-1 Alpha-2-Ländercode zum Filtern der Ergebnisse (z.B. `AT`, `CH`, `US`)
`limit`	Nein	`10`	Maximale Anzahl der Ergebnisse (max. 50)

Beispielanfrage

GET /geocoding/lookup?q=Zurich&language=en&limit=5

Beispielantwort

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

Abfrage per ID

Einen bestimmten Standort anhand seiner eindeutigen ID abrufen.

GET /geocoding/lookup?id={location_id}

Parameter

Parameter	Erforderlich	Beschreibung
`id`	Ja	Die eindeutige öffentliche ID des Standorts

Beispielanfrage

GET /geocoding/lookup?id=3704415940

Beispielantwort

{
  "id": "3704415940",
  "name": "Zürich",
  "lat": 47.36667,
  "lon": 8.55,
  "country_code": "CH",
  "country_name": "Switzerland",
  "admin1_name": "Kanton Zürich",
  "admin2_name": "Bezirk Zürich",
  "timezone": "Europe/Zurich",
  "population": 341730,
  "elevation": null,
  "feature_code": "PPLA"
}

Antwortfelder

Feld	Typ	Beschreibung
`id`	string	Eindeutiger Standortbezeichner
`name`	string	Standortname (lokalisiert, wenn der `language`-Parameter gesetzt ist)
`lat`	float	Breitengrad
`lon`	float	Längengrad
`country_code`	string	ISO 3166-1 Alpha-2-Ländercode
`country_name`	string	Ländername
`admin1_name`	string	Verwaltungseinheit erster Ebene (z.B. Bundesland, Kanton)
`admin2_name`	string	Verwaltungseinheit zweiter Ebene (z.B. Bezirk, Landkreis)
`timezone`	string	IANA-Zeitzonen-Bezeichner
`population`	integer	Einwohnerzahl (kann null sein)
`elevation`	integer	Höhenlage in Metern (kann null sein)
`feature_code`	string	Feature-Code für den Standorttyp (z.B. `PPL` für Stadt, `PPLA` für Hauptstadt, `AIRP` für Flughafen)

Fehler

Status	Beschreibung
`400`	Erforderlicher Parameter fehlt (`id` oder `q`)
`404`	Standort nicht gefunden (nur bei ID-Abfrage)
`503`	Geokodierungsdaten noch nicht geladen