Migration

Batch- und Sammelunterstützung verschiedener Anbieter im Vergleich

Anforderungen an die Massen-Geokodierung, etwa die Verarbeitung einer Tabelle mit einigen tausend Adressen auf einmal oder die Geokodierung einer gesamten Kundendatenbank als einmaliges Bereinigungsprojekt, werden von Anbietern unterschiedlich abgedeckt, und diese Unterschiede spielen bei der Planung einer Migration eine größere Rolle, als es auf den ersten Blick scheinen mag.

Manche Anbieter bieten eine eigene Weboberfläche für Massenaufträge: CSV hochladen, auf die Verarbeitung warten, die Ergebnisse mit angehängten neuen Spalten herunterladen. Das eignet sich für technisch weniger versierte Nutzer, etwa jemanden aus Betrieb oder Marketing, der Adressen einmalig geokodieren lassen muss und keinen Code schreiben möchte, ist aber eine vom programmatischen API getrennte Produktoberfläche und braucht einen eigenen Migrationsplan, wenn Sie darauf angewiesen sind.

Andere Anbieter erwarten, dass die Massen-Geokodierung vollständig über das programmatische API erfolgt: Sie senden viele einzelne Anfragen, oft mit einer gewissen Parallelität, und setzen die Ergebnisse selbst zusammen. Das gibt der aufrufenden Anwendung mehr Kontrolle, einschließlich der Entscheidung über Wiederholungsverhalten, Parallelitätsgrenzen und den Umgang mit Teilfehlern innerhalb eines großen Batches.

Einige wirklich anbieterunabhängige Lehren gelten unabhängig davon, welchen Ansatz ein Anbieter verfolgt:

  • Bauen Sie immer eine Wiederholungslogik für einzelne fehlgeschlagene Anfragen innerhalb eines größeren Batches ein, denn ein Batch-Job, der komplett scheitert, weil eine von zehntausend Adressen einen Fehler zurückgegeben hat, ist unabhängig vom Anbieter ein fragiles Design
  • Halten Sie das Ratenlimit oder die Kontingentstruktur ein, die das API dokumentiert, denn eine naive Schleife, die Anfragen so schnell wie möglich abfeuert, ist der häufigste Grund, warum ein Massenjob gedrosselt wird oder unerwartete Kosten verursacht
  • Protokollieren Sie genug Details pro Anfrage, nicht nur pro Batch, damit ein fehlgeschlagener Teil identifiziert und erneut verarbeitet werden kann, ohne den gesamten Job von vorn zu starten

My Geocode folgt bei Massenaufträgen dem programmatischen Muster: Anfragen laufen über dieselben Endpunkte wie jede andere Abfrage, mit denselben Authentifizierungsoptionen (ein X-API-Key-Header, Authorization: Bearer, HTTP Basic Auth oder ein Query-Parameter) und derselben Sichtbarkeit des Kontingents über Antwort-Header wie X-Quota-Used und X-Quota-Free-Remaining bei jeder einzelnen Anfrage, dokumentiert unter /docs/rate-limits/. Bei einem großen einmaligen Massenjob ist diese Sichtbarkeit des Kontingents wirklich nützlich, um einen Job automatisch zu takten, denn ein Skript kann bei jeder Antwort X-Quota-Free-Remaining prüfen und sich entsprechend selbst drosseln, statt eine sichere Anfragerate zu erraten.

Da die Preise für alle Endpunkte gleich sind, Prepaid-Guthaben zu 0,0001 € pro Anfrage oder ein Unlimited-Schlüssel zu 50 € im Monat, sind die Kosten eines großen Massenjobs eine einfache Multiplikation, sobald Sie wissen, wie viele Adressen verarbeitet werden müssen, ohne eine separate Preisstufe für Massenaufträge, die Sie verhandeln oder mit Ihrer laufenden Nutzung pro Anfrage vergleichen müssten. Für Teams, die einen wiederkehrenden Massen-Workflow migrieren, ob monatliche Bereinigung der Kundenliste oder einmaliges Datenmigrationsprojekt, macht dieser einheitliche und planbare Preis pro Anfrage die Budgetierung meist zum einfachsten Teil des ganzen Umzugs.