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.
Postleitzahlen einer Kundenliste im Batch auflösen
Ein Kundenexport mit einer Spalte für die Postleitzahl, aber ohne Koordinaten ist ein häufiger Ausgangspunkt für alles, was mit Versandzonen, regionalen Auswertungen oder der Zuordnung zu Filialen zu tun hat. Die ganze Spalte auf einmal aufzulösen, geht schneller, als eine Schleife zu schreiben.
Den Batch senden
Senden Sie per POST ein Array aus Objekten mit code und country an /v1/postcode. Jede Position wird unabhängig aufgelöst und kommt in derselben Reihenfolge zurück.
POST /v1/postcode
Content-Type: application/json
[{"code": "10115", "country": "DE"}, {"code": "75001", "country": "FR"}]{
"status": "ok",
"results": [
{"postcode": "10115", "country_code": "DE", "results": [{"lat": 52.5300, "lon": 13.3800, "components": {"city": "Berlin", "region": "Berlin"}}]},
{"postcode": "75001", "country_code": "FR", "results": [{"lat": 48.8630, "lon": 2.3360, "components": {"city": "Paris", "region": "Ile-de-France"}}]}
]
}Ergebnisse den Kundendatensätzen zuordnen
Bewahren Sie vor dem Senden der Anfrage den ursprünglichen Zeilenindex oder die Kunden-ID zu jedem Paar aus Postleitzahl und Land auf und ordnen Sie die Ergebnisse anhand derselben Position den Kundendatensätzen zu. Das ist derselbe Ansatz, der auch bei der Bulk-Geokodierung und der Bulk-Reverse-Geokodierung funktioniert.
Vor dem Senden deduplizieren
Eine Kundenliste von nennenswerter Größe enthält in der Regel weit weniger unterschiedliche Postleitzahlen als Zeilen, da viele Kunden in einer Stadt oder einem Viertel dieselbe Postleitzahl haben. Erstellen Sie zuerst eine eindeutige Liste der Paare aus Postleitzahl und Land, lösen Sie diese kleinere Liste in einem Batch auf und ordnen Sie die Ergebnisse dann jeder Kundenzeile mit der jeweiligen Postleitzahl zu, statt einen Array-Eintrag pro Kunde zu senden und immer wieder für dasselbe Paar aus Postleitzahl und Land zu bezahlen.
Umgang mit Postleitzahlen, die sich nicht auflösen lassen
Ein leeres Array results für eine bestimmte Position bedeutet meist, dass das Paar aus Postleitzahl und Land nicht existiert, was bei einem alten Export mit Tippfehlern oder einer veralteten Postleitzahl häufig vorkommt. Markieren Sie diese Zeilen zur manuellen Prüfung, statt sie stillschweigend aus Ihrer Auswertung zu entfernen.
Ein Sonderfall: Unterschiede in der Formatierung
Eine als „SW1A1AA“ ohne Leerzeichen gespeicherte Postleitzahl und eine als „SW1A 1AA“ mit Leerzeichen gespeicherte werden je nachdem, wie einheitlich Ihr eigener Export Postleitzahlen formatiert, möglicherweise gleich aufgelöst oder auch nicht. Wenn Sie Leerzeichen sowie Groß- und Kleinschreibung in Ihrem Export vereinheitlichen, bevor Sie das Batch-Array erstellen, sinkt die Zahl der Zeilen, die allein wegen der Formatierung und nicht wegen einer tatsächlich falschen Postleitzahl nicht aufgelöst werden.
Was es kostet
Ein Batch wird mit einer Anfrage pro Position abgerechnet, eine Kundenliste mit 2.000 Zeilen kostet also 2.000 Anfragen, egal ob sie als ein Bulk-Aufruf oder als 2.000 einzelne Aufrufe gesendet wird. Sie als einen Aufruf zu senden, lohnt sich trotzdem, wegen des geringeren Overheads und weil nur ein Satz Kontingent-Header zu prüfen ist, auch wenn die Zahl der Anfragen gegen Ihr Kontingent in beiden Fällen identisch ist. Was die Zahl der Anfragen tatsächlich senkt, ist das vorherige Deduplizieren wie oben beschrieben, nicht die Wahl zwischen Bulk- und Einzelaufrufen.
Das Kontingent während eines Batches im Blick behalten
Bei einer Liste, die groß genug ist, um die 2.500 kostenlosen Anfragen pro Tag zu überschreiten, prüfen Sie X-Quota-Free-Remaining, bevor Sie sich entscheiden, alles in einem Durchgang auszuführen, oder verteilen Sie sie auf ein paar Tage, wenn Sie für einen einmaligen Auftrag nicht auf Prepaid-Guthaben umsteigen möchten.
Die Postleitzahlen einer ganzen Kundenliste mit einem einzigen Aufruf aufzulösen, macht aus einem früher langsamen Hintergrundauftrag eine einfache Anfrage. Die Dokumentation zur Postleitzahlabfrage beschreibt die vollständige Feldliste.