Nicht jede Standortfrage ist wirklich eine Geokodierungsfrage. Manchmal braucht eine Anwendung nur die Postleitzahl für ein bestimmtes Gebiet oder das Gebiet, das eine bestimmte Postleitzahl abdeckt, ohne die umfassendere Adressauflösung, die Geokodierung oder Reverse-Geokodierung bieten. /v1/postcode existiert genau für diese engere Frage, als eigener Endpunkt und nicht als Nebeneffekt einer allgemeineren Abfrage.
Die Trennung von /v1/forward und /v1/reverse ist aus einigen praktischen Gründen wichtig. Die Anfragestruktur kann gezielt um Postleitzahlen-Parameter herum aufgebaut werden, statt aus einer umfassenderen Adressstruktur abgeleitet zu werden. Die Antwort kann sich genau auf das konzentrieren, was eine reine Postleitzahlen-Integration braucht, ohne zusätzliche Adressfelder, die herausgefiltert werden müssen. Und die Dokumentation, vollständig verfügbar unter /docs/postal-code-lookup/, kann das Verhalten von Postleitzahlen eigenständig erklären, statt als Unterabschnitt einer längeren Geokodierungsanleitung.
Die Authentifizierung folgt denselben Regeln wie bei jedem anderen Endpunkt: ein X-API-Key-Header, ein Authorization: Bearer-Header, HTTP-Basic-Authentifizierung mit dem Schlüssel als Benutzername oder ein Query-Parameter, alle gleichermaßen akzeptiert. Auch die Preise sind dieselben: Es wird dasselbe kostenlose Tageskontingent genutzt, ob aus dem aufrufenden Netzwerk oder vom Schlüssel, und darüber hinaus gelten dieselben 0,0001 € pro Anfrage aus dem Prepaid-Guthaben oder die Abdeckung durch ein Unlimited-Paket.
Batch-Anfragen funktionieren hier genau wie überall sonst auf der Plattform: Jede Postleitzahl oder Adresse, die in einem einzigen Aufruf übermittelt wird, zählt als eine Anfrage, nicht der Aufruf als Ganzes. Ein Team, das Postleitzahlen in einer großen Kundenliste validiert, kann diese Liste als Batch senden und mit derselben Zählung pro Eintrag rechnen, die für jeden anderen Bulk-Vorgang bei My Geocode gilt.
Ein eigener Endpunkt macht außerdem die Postleitzahlen-Kompatibilität über unsere siebzehn Kompatibilitäts-Hosts präziser, da Anbieter, die eine eigene Postleitzahlensuche anbieten, exakt abgebildet werden können, statt über eine umfassendere Geokodierungsstruktur angenähert zu werden.
Wenn Ihre Anwendung nur Postleitzahlen-Informationen benötigt und bisher umfassendere Geokodierungsanfragen gesendet hat, nur um dieses eine Feld herauszuziehen, lohnt sich der direkte Wechsel zu /v1/postcode. Der Endpunkt ist vollständig unter /docs/postal-code-lookup/ dokumentiert, neben der übrigen Endpunkt-Referenz unter /docs/.