Geokodierung

Wandelt Text in Koordinaten um. Akzeptiert vollständige Adressen, Teiladressen, Postleitzahlen, Ortsnamen und Points of Interest, in jeder Sprache.

Parameter

Beispiel

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=Dam+1,+Amsterdam&countries=nl&limit=1"

const url = new URL("https://api.mygeocode.com/v1/forward");
url.searchParams.set("q", "Dam 1, Amsterdam");
url.searchParams.set("countries", "nl");
url.searchParams.set("limit", "1");

const data = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(data.results[0]);

import requests

r = requests.get("https://api.mygeocode.com/v1/forward",
                 params={"q": "Dam 1, Amsterdam", "countries": "nl", "limit": 1}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
print(r.json()["results"][0])

{
  "status": "ok",
  "query": "Dam 1, Amsterdam",
  "results": [
    {
      "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
      "lat": 52.373119,
      "lon": 4.893604,
      "type": "address",
      "precision": "house",
      "confidence": 0.98,
      "place_id": "nl.addr.c21d40e8",
      "components": {
        "house_number": "1",
        "road": "Dam",
        "neighbourhood": "Centrum",
        "city": "Amsterdam",
        "state": "North Holland",
        "state_code": "NH",
        "postcode": "1012 JS",
        "country": "Netherlands",
        "country_code": "nl"
      },
      "bounds": { "north": 52.373519, "south": 52.372719, "east": 4.894204, "west": 4.893004 }
    }
  ]
}

Antwortfelder

Komponenten-Schlüssel

Nur zutreffende Schlüssel sind vorhanden. In jedem Land werden dieselben Schlüssel verwendet.

Hinweise

• Die Ergebnisse sind nach einer Kombination aus Konfidenz, Genauigkeit und Nähe sortiert. Verwenden Sie das erste Ergebnis, es sei denn, Sie zeigen eine Auswahl an.
• Wenn eine Hausnummer auf einer bekannten Straße nicht gefunden wird, hat das Ergebnis type: street und precision: street, wobei die Nummer interpoliert wird, soweit die Daten es erlauben. Prüfen Sie precision, wenn Ihnen das wichtig ist.
• Postleitzahlen allein sind als q in Ordnung. Für reine Postleitzahl-Abfragen ist der Postleitzahl-Endpunkt schneller und liefert den Ortsnamen der Postbehörde.
• Eine Abfrage in einer Schrift für einen Ort, der eine andere verwendet (etwa Kyrillisch für eine japanische Adresse), funktioniert, aber lang bestimmt die Schrift der Antwort.

Dieselbe Abfrage in den Formaten anderer Anbieter

Wenn Sie bereits Code für einen dieser Anbieter geschrieben haben, behalten Sie ihn: Der Drop-in-Host akzeptiert denselben Pfad und dieselben Parameter und antwortet in der Antwortstruktur dieses Anbieters, mit diesem Endpunkt dahinter. Siehe So funktionieren die Drop-in-Hosts.

Massenabfragen

Senden Sie per POST einen JSON-Body an denselben Pfad mit queries, einem Array mit bis zu 100 Adressen, und die Antwort enthält ein Array results mit einem Eintrag pro Abfrage in der gesendeten Reihenfolge. Jeder Eintrag zählt als eine Anfrage, und ein Batch, der größer ist als das verbleibende Kontingent, wird vollständig abgelehnt.

$ curl -X POST "https://api.mygeocode.com/v1/forward" -H "Content-Type: application/json" -d '{"queries": ["Brandenburg Gate, Berlin", "Bahnhofstrasse 1, Zurich"]}'

Fehler

400 invalid_request, wenn weder q noch ein strukturiertes Feld noch place_id vorhanden ist, wenn limit außerhalb von 1 bis 10 liegt oder wenn bounds oder proximity fehlerhaft ist. Den Rest finden Sie unter Fehler.