Ein großer Teil des Codes, der für Mapbox Geocoding geschrieben wurde, steckt in Frontend-Anwendungen, mobilen Apps und internen Tools, in denen der Geokodierungsaufruf selbst ein kleines, leicht zu übersehendes Detail in einem größeren System ist. Einen Anbieter dort zu wechseln bedeutet meist, erst einmal jede Stelle zu finden, an der dieses Detail steckt, bevor irgendetwas anderes passieren kann. Unser Kompatibilitäts-Host soll diese Aufgabe auf fast nichts reduzieren.
Er bildet das Anfrageformat und die Antwortstruktur von Mapbox exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von My Geocode stammen. Wo immer Ihr Code derzeit eine Anfrage im Mapbox-Format sendet, kann er dieselbe Anfrage stattdessen an unseren Host senden, und die zurückkommende Antwort lässt sich genauso auswerten, wie Ihr bestehender Code es bereits erwartet.
Auch die Authentifizierung folgt unserem üblichen Muster, statt ein Neuschreiben dieses Teils zu erzwingen. Senden Sie Ihren Schlüssel als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter, je nachdem, wie sich Ihr Client derzeit authentifiziert. Alle vier funktionieren auf jedem Host und jedem Endpunkt, den wir betreiben.
Die Preise ändern sich nicht danach, welcher Host die Anfrage verarbeitet hat. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz statt pro einzelnem Aufrufer. Ein Schlüssel fügt weitere 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. Der Kompatibilitäts-Host kostet genau so viel wie unsere nativen Endpunkte /v1/forward und /v1/reverse.
Kontingent-Header werden jeder Antwort unabhängig vom Format beigefügt und bieten eine Transparenz, die eine reine Mapbox-Integration von sich aus nicht liefert: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit und X-Quota-Reset erscheinen auf diesem Host genauso wie überall sonst.
Für alles, was über die kompatible Antwortstruktur hinausgeht, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale zusätzliche Felder hinzu, ohne die Grundstruktur zu verändern. Standardmäßig ist es deaktiviert, sodass die Antwort der Mapbox-Struktur entspricht, bis Sie ausdrücklich mehr anfordern.
Der Host ist unter /compatibility/mapbox/ zu finden, allgemeine Hinweise zur Umstellung einer Integration unter /docs/compatibility/. Wenn Sie heute eine Integration im Mapbox-Format pflegen, kostet ein Test Sie einen Schlüssel und eine geänderte Basis-URL.