Migration

Migration von Geocodio

Geocodio hat sich einen guten Ruf speziell für die Adressgenauigkeit in den Vereinigten Staaten und Kanada aufgebaut, zusammen mit einem Workflow zum Massen-Upload von CSV-Dateien, mit dem man eine Tabelle voller Adressen geokodieren kann, ohne überhaupt Integrationscode zu schreiben. Der API-Schlüssel wird als Query-Parameter (api_key) gesendet, und Antworten für einzelne Adressen enthalten ein results-Array mit address_components und einem accuracy-Feld, das die Treffersicherheit beschreibt.

Den CSV-Massen-Workflow sollten Sie als eigenen Migrationspunkt behandeln, getrennt von allen programmatischen API-Aufrufen Ihrer Anwendung. Ein Marketingteam oder ein Analyst im operativen Bereich, der einmal im Monat eine Tabelle über ein Webformular hochlädt, ist von Änderungen an Ihrem Backend-Code nicht betroffen, und dieser Workflow braucht einen eigenen Plan, ob das nun bedeutet, einen Batch-Job gegen die neue API zu skripten oder ihn für eine Übergangszeit manuell zu erledigen.

Für die programmatische Seite bildet der Kompatibilitätshost von My Geocode für Geocodio das results-Array und die address_components-Struktur nach, die Geocodio zurückgibt, wobei nur die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz geändert sind. Referenzdetails finden Sie unter /compatibility/geocodio/. Code, der results[0].address_components.city liest, sollte weiter funktionieren, sobald Host und Schlüssel aktualisiert sind.

Einige Punkte, die Sie wegen des regionalen Schwerpunkts von Geocodio gezielt einplanen sollten:

  • Wenn Ihre Integration auf US-spezifische Zusatzfelder angewiesen ist, etwa Informationen zu Kongresswahlbezirken, prüfen Sie, ob dieser Datenpunkt zum Umfang Ihrer Migration gehört oder künftig eine separate Abfrage braucht
  • Klären Sie, ob Batch-Jobs mit einem Ratenlimit laufen, das speziell auf die dokumentierten Limits von Geocodio abgestimmt ist, denn ein Wiederholungstiming, das auf den Zahlen eines Anbieters beruht, passt nicht unbedingt zu denen eines anderen
  • Testen Sie einen Stapel echter historischer Adressen aus Ihren eigenen Daten mit dem neuen Host, bevor Sie volle Gleichwertigkeit annehmen, insbesondere bei Randfällen wie Postfächern oder Adressen auf ländlichen Zustellrouten

Die Authentifizierung unterstützt einen X-API-Key-Header, einen Authorization: Bearer-Header, HTTP Basic Auth oder einen Query-Parameter, sodass es für jeden Stil, den Ihr bestehender Geocodio-Client für seinen api_key-Parameter verwendet, hier eine Entsprechung gibt.

Bei den Kosten müssen Sie über keine separate Preisstufe für Massenverarbeitung nachdenken: Jeder Endpunkt, einschließlich dieses Kompatibilitätshosts, kostet gleich viel, mit 2.500 kostenlosen Anfragen pro Tag ganz ohne Schlüssel, weiteren 2.500 kostenlosen pro Schlüssel und Tag, gezählt pro Netzwerk, und darüber hinaus Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einem Unlimited-Schlüssel für 50 € pro Monat. Ein großer einmaliger Massenjob und ein stetiger Strom von API-Aufrufen kosten pro Anfrage in beiden Fällen gleich viel, sodass sich die Kosten einer Massenmigration durch eine einfache Multiplikation schätzen lassen statt durch das Nachschlagen einer Preisstufe.