Migration

Migration von Geocode.Farm

Geocode.Farm ist ein kleinerer Name in der Geokodierung und wird oft von Teams gewählt, die eine unkomplizierte, schnörkellose Option statt einer großen Unternehmensplattform suchen. Der API-Schlüssel authentifiziert Anfragen, die als Query-Parameter gesendet werden, und die JSON-Antworten enthalten ein geometry-Objekt mit Standortkoordinaten und ein accuracy-Feld, das die Treffersicherheit angibt, eingebettet in eine Struktur, die die Antwort im Vergleich zu einigen größeren Anbietern recht flach hält.

Bei einem kleineren Anbieter gibt es eine besondere Art von Migrationsmotiv, die man direkt benennen sollte: Teams wechseln manchmal von einem kleineren Anbieter weg, nicht weil etwas schiefgelaufen ist, sondern weil sie die Gewissheit einer Plattform mit mehr Kompatibilitätsoptionen und einer klareren langfristigen Roadmap wollen, besonders sobald ein Projekt, das klein angefangen hat, deutlich mehr Verkehr oder geschäftskritischere Workflows bewältigt.

Der Kompatibilitätshost von My Geocode für Geocode.Farm bildet die Feldstruktur mit geometry und accuracy nach, die Geocode.Farm zurückgibt, wobei nur die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz in der Antwort geändert sind. Die Feldreferenz finden Sie unter /compatibility/geocode-farm/. Anwendungscode, der auf dieser Antwortform aufbaut, sollte nur eine Änderung von Host und Schlüssel brauchen, um weiter zu funktionieren.

Einige Punkte, die Sie speziell bei dieser Migration prüfen sollten:

  • Ob Ihre Integration Ratenlimit-Fehler mit einer Logik behandelt, die auf die spezifischen Antworten von Geocode.Farm abgestimmt ist, da sich Fehlerformen zwischen Anbietern unterscheiden; für diese Plattform sind sie unter /docs/errors/ dokumentiert
  • Ob Ihr Schlüssel derzeit direkt im Anwendungscode statt in der Konfiguration steht, was Sie bei diesem Umzug unabhängig vom Ziel beheben sollten
  • Ob Sie Geocode.Farm auch für Reverse-Geokodierung nutzen, da sich dieses Anfragemuster von der Geokodierung von Adressen zu Koordinaten unterscheidet und einen eigenen Testdurchlauf verdient

Die Authentifizierung akzeptiert einen X-API-Key-Header, einen Authorization: Bearer-Header, HTTP Basic Auth oder einen Query-Parameter und deckt damit ab, was Ihr bestehender Geocode.Farm-Client bereits tut.

Bei den Preisen bedeutet der Wechsel von einem kleineren, spezialisierteren Anbieter zu einer breiteren Plattform hier keine kompliziertere Kostenstruktur. Es gibt 2.500 kostenlose Anfragen pro Tag, ohne dass ein Schlüssel nötig ist, weitere 2.500 kostenlose pro Schlüssel und Tag, gezählt pro Netzwerk, und darüber hinaus Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einen Unlimited-Schlüssel für 50 € pro Monat, wobei jeder Endpunkt, einschließlich dieses Kompatibilitätshosts, gleich viel kostet. Da My Geocode insgesamt 17 Kompatibilitätshosts abdeckt, erhält ein Team, das von einem kleineren Anbieter wegmigriert, außerdem die Möglichkeit, später die Antwortformen anderer Anbieter direkt nebeneinander zu testen, ohne dafür anderswo ein zweites Konto zu eröffnen.