Postleitzahlen-Abfrage-API

Ermitteln Sie aus einer Postleitzahl den Ort, zu dem sie gehört: Stadt oder Gemeinde, Region, Land und eine Koordinate. Abgedeckt sind ZIP-Codes, britische Postcodes, kanadische Postal Codes, indische PIN-Codes, japanische 郵便番号 und ihre Entsprechungen in 160 Ländern. Nützlich für sich allein in Adressformularen und als schnelle, günstige Möglichkeit, einen Datensatz zu verorten, wenn Sie nur eine Postleitzahl haben.

GEThttps://api.mygeocode.com/v1/postcode?code=...&country=...

In der Demo ausprobieren Vollständige Referenz

Beispiel

Anfrage

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

# UK postcodes resolve to a street or a handful of buildings
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=SW1A+1AA&country=gb"

Senden Sie immer country, wenn Sie es kennen. Postleitzahlen sind nicht länderübergreifend eindeutig: 10001 liegt in New York und in mehreren anderen Ländern. Ohne Land erhalten Sie Ergebnisse aus jedem Land, in dem die Postleitzahl existiert, das bevölkerungsreichste zuerst.

Die Formatierung ist tolerant. Leerzeichen, Bindestriche und Groß-/Kleinschreibung werden normalisiert, sodass sw1a1aa und SW1A 1AA gleich sind.

Antwort

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

Was Sie zurückbekommen

Feld	Bedeutung
`results`	Ein Eintrag pro Ort, den die Postleitzahl abdeckt. Die meisten Postleitzahlen gehören zu einem Ort; manche ländlichen Postleitzahlen decken mehrere Dörfer ab und liefern mehrere Einträge.
`place`	Der Name der Stadt, Gemeinde oder Ortschaft, wie ihn die Postbehörde verwendet.
`region`, `region_code`	Bundesland, Provinz oder Grafschaft und ihr ISO-3166-2-Code, sofern vorhanden.
`lat`, `lon`	Der Punkt der Postbehörde für die Postleitzahl, sofern veröffentlicht, andernfalls der Mittelpunkt der Adressen, die wir dafür haben.

Wo sie eingesetzt wird

Adressformulare

Fragen Sie zuerst nach der Postleitzahl und füllen Sie Stadt und Region aus. Nutzer tippen weniger und machen weniger Fehler.

Liefergebiete und Preise

Entscheiden Sie anhand der Koordinaten der Postleitzahl, welches Depot einen Kunden beliefert oder welche Versandzone gilt.

Umfragedaten kartieren

Datensätze, die nur eine Postleitzahl erfassen, lassen sich mit Postleitzahlgenauigkeit kartieren, was ohnehin oft alles ist, was der Datenschutz zulässt.

Preis und Limits

Ein Aufruf, eine Anfrage, unabhängig davon, wie viele Orte die Postleitzahl abdeckt. Jeder Schlüssel hat 2.500 kostenlose Anfragen pro Tag; darüber hinaus 0,0001 € pro Anfrage aus Prepaid-Guthaben oder nichts mit einem Unlimited-Schlüssel (50 € pro Monat). Preise. Für eine vollständige Adresse mit Hausnummer verwenden Sie stattdessen die Geokodierung.