Geoapify kombiniert Geokodierung mit einer breiteren Palette von Standortwerkzeugen, weshalb darauf aufbauende Integrationen manchmal mehr von einer Codebasis berühren, als ein einzelner API-Aufruf vermuten lässt. Unser Kompatibilitäts-Host konzentriert sich gezielt auf die Anfrage- und Antwortstruktur der Geokodierung, exakt nachgebildet, damit dieser Teil umziehen kann, ohne alles drumherum zu stören.
Der Host bildet die Anfrageparameter und den Antwortinhalt von Geoapify präzise nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen statt vom ursprünglichen Anbieter. Eine Anfrage, die derzeit für die Geokodierungs-Endpunkte von Geoapify erstellt wird, kann unverändert an unseren Host gesendet werden, und das zurückgegebene JSON lässt sich genau so auswerten, wie bestehender Code es bereits erwartet.
Diese Eingrenzung ist gewollt. Die Plattform von Geoapify umfasst neben der Geokodierung auch Routing, Isochronen und Ortssuche, und der Versuch, all das in einem einzigen Kompatibilitäts-Host nachzubilden, würde dessen Veröffentlichungsplan an Funktionen weit außerhalb der eigentlichen Geokodierung binden. Die Beschränkung des Hosts auf die Geokodierungs-Endpunkte macht ihn einfach gegen den Originaldienst zu überprüfen und leicht auf dem aktuellen Stand zu halten, während My Geocode eigene Funktionen hinzufügt.
Für den Wechsel ändern Sie einen Hostnamen und einen Schlüssel, sonst nichts. Dieser Schlüssel authentifiziert sich auf dieselbe flexible Weise wie auf jedem Host, den wir betreiben: als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter. Was auch immer Ihr aktueller Client sendet, wird auch hier akzeptiert.
Die Preise dahinter sind dieselben wie auf dem Rest der Plattform. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt darüber hinaus eigene 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits beider Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab, wobei derselbe Preis gilt, ob ein Aufruf an diesen Host oder direkt an /v1/forward ging.
Auch hier begleiten Kontingent-Header jede Antwort: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit und X-Quota-Reset sind alle dabei und bieten eine Transparenz, die eine reine Geoapify-Integration von sich aus nicht mitbringt.
Der Umzug einer Geokodierungs-Integration zu einem neuen Anbieter ist auch ein guter Moment, die Kontosicherheit insgesamt zu verschärfen. Die Einstellung für die Zwei-Faktor-Authentifizierung im Dashboard befindet sich direkt neben API-Schlüsseln und Abrechnung, sodass ihre Aktivierung für ein Konto, das jetzt einen neuen Schlüssel besitzt, nur einen zusätzlichen Schritt erfordert statt eines eigenen Projekts.
Für alles, was über die kompatible Standardantwort hinausgeht, fügt mg_extras=1 in einer Anfrage oder ein X-MG-Extras-Header optionale Felder hinzu, ohne die Grundstruktur zu ändern, sofern dies nicht ausdrücklich angefordert wird.
Die vollständige Dokumentation des Hosts finden Sie unter /compatibility/geoapify/, und die umfassende Kompatibilitätsreferenz für alle siebzehn Hosts unter /docs/compatibility/. Wenn Geoapify bereits hinter einem Teil Ihres Stacks steckt, ist dies ein Weg mit wenig Aufwand, es mit unserem Angebot zu vergleichen.