Postleitzahlen-Abfrage

Eine Postleitzahl hinein, der zugehörige Ort heraus. Deckt 160 Länder ab.

GEThttps://api.mygeocode.com/v1/postcode

Parameter

Parameter	Typ	Beschreibung
`code`erforderlich	String	Die Postleitzahl. Leerzeichen, Bindestriche und Groß-/Kleinschreibung werden normalisiert.
`country`optional	String	ISO 3166-1 Alpha-2-Code. Dringend empfohlen; Postleitzahlen sind nicht länderübergreifend eindeutig. Ohne ihn werden Ergebnisse aus allen passenden Ländern zurückgegeben, das bevölkerungsreichste zuerst.
`lang`optional	String	ISO 639-1 Code für Orts- und Regionsnamen. Standard `en`.
`key`optional	String	API-Schlüssel, falls nicht als Header gesendet.

Beispiel

curlJavaScriptPython

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=75008&country=fr"

const url = new URL("https://api.mygeocode.com/v1/postcode");
url.searchParams.set("code", "75008");
url.searchParams.set("country", "fr");

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

import requests

r = requests.get("https://api.mygeocode.com/v1/postcode", params={"code": "75008", "country": "fr"}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5)
first = r.json()["results"][0]
print(first["place"], first["lat"], first["lon"])

Antwort

{
  "status": "ok",
  "postcode": "75008",
  "country_code": "FR",
  "results": [
    {
      "postcode": "75008",
      "place": "Paris 8e Arrondissement",
      "region": "Ile-de-France",
      "region_code": "IDF",
      "country": "France",
      "country_code": "FR",
      "lat": 48.8727,
      "lon": 2.3125
    }
  ]
}

Antwortfelder

Feld	Typ	Beschreibung
`postcode`	String	Der Code nach der Normalisierung.
`country_code`	String oder null	Der angewendete Länderfilter, falls vorhanden.
`results`	Array	Orte, die der Code abdeckt. Meist einer; mehrere bei ländlichen Codes, die sich über mehrere Dörfer erstrecken. Leer, wenn der Code unbekannt ist.
`results[].place`	String	Ortsname, wie ihn die Postbehörde verwendet.
`results[].region`, `region_code`	String	Verwaltungseinheit der ersten Ebene und ihr ISO 3166-2 Suffix.
`results[].lat`, `lon`	Zahl	Der Punkt der Postbehörde, sofern veröffentlicht, andernfalls der Schwerpunkt der Adressen im Code.

Hinweise

Teilcodes funktionieren, wo das System des Landes hierarchisch ist: SW1A liefert für Großbritannien den Bezirk; 750 liefert für Frankreich nichts, weil französische Codes keine Präfixe sind.
Länder ohne Postleitzahlen (Irland vor Eircode, mehrere in Afrika und im Nahen Osten) liefern ein leeres Array results mit status: ok.
Für eine vollständige Adresse mit Hausnummer verwenden Sie die Geokodierung; die Postleitzahl hilft auch dort.

Fehler

400 invalid_request, wenn code leer oder länger als 16 Zeichen ist oder country kein gültiger Alpha-2-Code ist.