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.
Adressen aus einem CRM-Export per Batch geokodieren
Ein CRM-Export ist meist eine flache Datei mit Kundendatensätzen, die ein Adressfeld und sonst nichts Standortbezogenes enthält: keine Koordinaten, keine geprüften Adressbestandteile. Um daraus etwas zu machen, das Sie auf einer Karte darstellen oder regional segmentieren können, müssen Sie den gesamten Export geokodieren.
Den Export vorbereiten
Ziehen Sie die Adressspalte aus Ihrem CRM-Export als einfaches Array heraus und halten Sie die Kunden-ID über die Position mit jeder Adresse abgeglichen, denn Sie müssen die Ergebnisse danach wieder den Datensätzen zuordnen.
POST /v1/forward
Content-Type: application/json
["1600 Pennsylvania Avenue, Washington", "221B Baker Street, London"]{
"status": "ok",
"results": [
{"formatted": "1600 Pennsylvania Avenue NW, Washington, DC 20500", "lat": 38.8977, "lon": -77.0365, "type": "address", "precision": "house", "confidence": 0.97, "place_id": "def456", "components": {}},
{"formatted": "221B Baker Street, London, UK", "lat": 51.5237, "lon": -0.1585, "type": "address", "precision": "house", "confidence": 0.95, "place_id": "abc123", "components": {}}
]
}Ergebnisse zurück ins CRM schreiben
Ordnen Sie jedes Ergebnis anhand der Position, die Sie vor dem Senden der Anfrage festgehalten haben, seinem Kunden zu, und schreiben Sie Koordinaten und Adressbestandteile dann zurück in Ihr CRM, entweder über dessen eigene API oder per Massenimport, je nachdem, was Ihr CRM unterstützt. Speichern Sie auch die Felder confidence und precision, damit alles mit einem schwachen Treffer zur Bereinigung markiert werden kann, statt als geprüft zu gelten.
Ein zweites Beispiel: ein internationaler Kundenstamm
Ein CRM mit Kunden in mehreren Ländern profitiert davon, den Parameter countries zusammen mit dem Batch jeder Region zu übergeben. Das beschränkt die möglichen Treffer auf das erwartete Land und verringert den seltenen Fall, dass ein Straßenname, der in mehr als einem Land vorkommt, dem falschen zugeordnet wird. Den Export vor dem Senden in Batches pro Land aufzuteilen und jeden als eigene Massenanfrage zu senden, ist ein sinnvoller Weg, dies umzusetzen, ohne sonst etwas am Ablauf zu ändern.
Ein häufiger Fehler, den Sie vermeiden sollten
Entfernen Sie keine Duplikate aus dem Adress-Array und ändern Sie seine Reihenfolge nicht vor dem Senden, ohne eine separate Zuordnung zu den ursprünglichen Kunden-IDs aufzubewahren. Die Ergebnisse kommen in derselben Reihenfolge zurück wie das gesendete Array, und sobald diese Reihenfolge ohne gespeicherten Index von Ihren Kundendatensätzen entkoppelt ist, gibt es danach keinen zuverlässigen Weg mehr, ein Koordinatenpaar dem richtigen Kunden zuzuordnen. Halten Sie die Zuordnung von Position zu ID für die Dauer des Jobs im Speicher oder in einer temporären Spalte.
Nur neue Datensätze erneut verarbeiten
Sobald der erste Export geokodiert ist, müssen Sie den gesamten Kundenstamm später nicht erneut verarbeiten. Verfolgen Sie, welche Datensätze bereits Koordinaten haben, und senden Sie bei späteren Durchläufen nur neue Datensätze oder solche mit geänderter Adresse an den Endpunkt. So bleibt der laufende Anfrageverbrauch proportional zur neuen Aktivität und nicht zur Gesamtzahl Ihrer Kunden.
Umgang mit schlecht aufgelösten Datensätzen
Einen Datensatz mit niedrigem Konfidenzwert oder mit mehreren fehlenden erwarteten Adressbestandteilen sollten Sie in einer Prüfwarteschlange markieren, statt ihn stillschweigend neben Ihre vollständig geprüften Datensätze zu schreiben. So verhindern Sie, dass eine fehlerhafte Adresse unbemerkt einen regionalen Bericht oder eine Kartenansicht verfälscht, die auf den nachgetragenen Daten beruht.
Was es kostet
Ein einmaliges Nachtragen für ein bestehendes CRM kostet eine Anfrage pro Kundendatensatz mit Adresse, ausgeführt als einzelner Massenaufruf oder in wenigen Blöcken. Ein CRM mit einigen tausend Kunden kann in einem Durchgang mehr als die 2.500 kostenlosen Anfragen pro Tag verbrauchen. Das ist ein guter Zeitpunkt, den Job entweder auf ein paar Tage zu verteilen oder für diesen einmaligen Schub auf Prepaid-Guthaben umzusteigen.
Sobald das Nachtragen abgeschlossen ist, ist die laufende Geokodierung für neue Kunden gering und gleichmäßig, statt ein wiederkehrender Massenjob zu sein. Die vollständige Struktur von Anfrage und Antwort finden Sie in der Dokumentation zur Geokodierung.