My Geocode

Migration

Migration von PositionStack

· 2 Min. Lesezeit · My Geocode · #positionstack#migration#geocoding#compatibility#api-keys

PositionStack hält die Dinge so einfach, wie es bei einer Geokodierungs-API nur geht: ein access_key-Query-Parameter und ein JSON-Array data, in dem jeder Eintrag latitude, longitude, label und eine Handvoll flacher Adressfelder enthält statt einer tief verschachtelten Struktur. Genau diese flache Struktur ist oft der Grund, warum sich ein kleines Team überhaupt dafür entschieden hat, denn vor dem ersten erfolgreichen Aufruf gibt es weniger zu lernen.

Eine Migration weg von einer bewusst einfachen API sollte keine Komplexität zurückbringen. Das ist eigentlich die Kernanforderung an jeden kompatibilitätsbasierten Ansatz im Gegensatz zu einer vollständigen Neuentwicklung. Die Frage, die man sich vor dem Start stellen sollte, lautet: Behält der Drop-in-Host des neuen Anbieters diese flache Struktur tatsächlich bei, oder verlagert er die Komplexität nur an eine andere Stelle im Prozess?

Der PositionStack-Kompatibilitäts-Host von My Geocode bildet das data-Array und seine flache Feldstruktur exakt nach, bis hin zu den Namen latitude, longitude und label. Nur die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz unterscheiden sich von der Antwort von PositionStack selbst. Die Referenz finden Sie unter /compatibility/positionstack/. Bei den meisten Integrationen, die für diese API gebaut wurden, braucht der Code, der data[0].latitude liest, außer bei Host und Schlüssel keine Änderungen.

Eine kurze Liste dessen, was Sie vor der Umstellung prüfen sollten:

  • Ob Ihr Code ein bestimmtes Muster von HTTP-Statuscodes prüft, das an die eigenen Fehlerantworten von PositionStack gebunden ist, da die Fehlerstrukturen separat unter /docs/errors/ dokumentiert sind und einen direkten Vergleich wert sind
  • Ob der Parametername access_key irgendwo fest einprogrammiert ist, da der neue Host einen Schlüssel auch als X-API-Key-Header, als Authorization: Bearer-Header oder per HTTP Basic Auth akzeptiert, falls Sie bei der Migration lieber vom Query-Parameter wegkommen möchten
  • Ob clientseitiger Code den Schlüssel direkt preisgibt. Das ist ein guter Moment, diesen Aufruf hinter einen serverseitigen Proxy zu verlagern, unabhängig davon, welcher Anbieter am Ende auf der anderen Seite steht

Der Kostenvergleich ist hier wirklich einfach, weil beide Ansätze auf geringe Hürden setzen. My Geocode bietet 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, dann 2.500 weitere kostenlos 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 zu 50 € pro Monat. Jeder Endpunkt, einschließlich dieses Kompatibilitäts-Hosts, kostet gleich viel, sodass für eine Massen- oder Hochvolumen-Last von PositionStack nach dem Umzug keine gesonderte Berechnung nötig ist.

Bei einem kleinen Projekt, das über das hinausgewachsen ist, wofür ein Nebenkonto gedacht war, ist eine solche Migration meist ein einziger Nachmittag mit Tests und kein eigenes Projekt. Richten Sie einen Staging-Build auf den neuen Host aus, vergleichen Sie eine Stichprobe von Adressen, und wenn die Struktur übereinstimmt, ist der Wechsel selbst eine Konfigurationsänderung.

Mehr zu Migration