Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen
Wenn Sie Ihre Kontingent-Header laufend beobachten, wissen Sie, wann ein Limit näher rückt, lange bevor eine Anfrage tatsächlich abgelehnt wird.
Eine Postleitzahl vor dem Speichern validieren
Ein Postleitzahlfeld, das nur Länge und Zeichenformat prüft, akzeptiert bereitwillig eine Postleitzahl, die perfekt formatiert und völlig falsch ist. Echte Validierung bedeutet zu prüfen, ob die Postleitzahl zu einem realen Ort aufgelöst wird.
Der Validierungsaufruf
Übergeben Sie die Postleitzahl und den ISO-3166-1-Alpha-2-Code des Landes an /v1/postcode. Eine gültige Kombination liefert mindestens ein Ergebnis mit Koordinaten und Standortbestandteilen.
GET /v1/postcode?code=SW1A 1AA&country=GB{
"status": "ok",
"postcode": "SW1A 1AA",
"country_code": "GB",
"results": [
{"lat": 51.5014, "lon": -0.1419, "components": {"city": "London", "region": "Greater London", "country": "GB"}}
]
}Ein leeres Ergebnis als ungültig behandeln
Wenn results leer zurückkommt, entspricht die Kombination aus Postleitzahl und Land keinem bekannten Ort. Das ist Ihr Signal, das Formularfeld mit einer klaren Meldung abzulehnen, statt eine erfundene Postleitzahl später bis auf ein Versandetikett durchrutschen zu lassen.
Validierung ist nicht dasselbe wie ein exakter Adresstreffer
Eine Postleitzahl deckt ein Gebiet ab, je nach Land manchmal ein kleines und manchmal ein großes. Eine bestandene Validierung bestätigt daher, dass die Postleitzahl existiert, nicht dass sie zu der konkreten Straßenadresse passt, die ebenfalls im Formular eingegeben wurde. Kombinieren Sie eine Postleitzahlvalidierung mit einer Geokodierungsprüfung der vollständigen Adresse, wenn sowohl die Postleitzahl als auch die Straße übereinstimmen müssen.
Ein Fehler, den Sie vermeiden sollten
Eine Postleitzahl allein deshalb abzulehnen, weil sie nicht Ihren eigenen Formatierungserwartungen entspricht, noch bevor Sie sie überhaupt an die API gesendet haben, verwirft gültige Eingaben wegen eines kosmetischen Unterschieds. Eine Postleitzahl, die mit fehlendem Leerzeichen, zusätzlichen Leerzeichen oder uneinheitlicher Groß- und Kleinschreibung eingegeben wurde, ist nach der Normalisierung oft trotzdem gültig. Entfernen und normalisieren Sie Leerzeichen und Schreibweise im Feld, bevor Sie /v1/postcode aufrufen, statt die Eingabe wegen einer Formatierungseigenheit, die die Abfrage selbst toleriert hätte, von vornherein abzulehnen.
Ein Grenzfall: richtige Postleitzahl, falsches Land
Eine syntaktisch gültige Postleitzahl kann die Prüfung trotzdem nicht bestehen, schlicht weil dazu das falsche Land ausgewählt wurde, denn dasselbe numerische oder alphanumerische Muster kann im System mehrerer Länder eine gültige Postleitzahl sein. Wenn eine Abfrage für eine Postleitzahl leer zurückkommt, die der Kunde für korrekt hält, prüfen Sie, ob das Länderfeld dem entspricht, was der Kunde tatsächlich gemeint hat, bevor Sie die Postleitzahl selbst als Problem ansehen.
Wo diese Prüfung laufen sollte
Führen Sie die Prüfung aus, wenn das Feld den Fokus verliert oder das Formular abgeschickt wird, nicht bei jedem Tastendruck, denn eine Postleitzahl wird in der Regel vollständig eingetippt, bevor eine Prüfung überhaupt sinnvoll ist. So bleibt es bei einer Anfrage pro Absendeversuch statt einer pro eingegebenem Zeichen.
Was es kostet, das überall zu tun
Ein Prüfaufruf pro Formularabsendung ist eine einzige Anfrage. Selbst ein Formular mit hohem Traffic verbraucht allein für die Prüfung von Postleitzahlen nur einen kleinen Bruchteil der 2.500 kostenlosen Anfragen pro Tag, die in jedem Schlüssel enthalten oder ohne Schlüssel von einer einzelnen Adresse aus verfügbar sind.
Eine fehlerhafte Postleitzahl abzufangen, bevor sie auf einem Versandetikett landet, ist die eine zusätzliche Anfrage wert. Alle Details zu den Parametern finden Sie in der Dokumentation zur Postleitzahlen-Abfrage.