LocationIQ hat sich einen Platz in vielen Stacks erarbeitet, die klein anfingen und gewachsen sind, oft weil es sich früh leicht einsetzen ließ. Unser Kompatibilitäts-Host zielt genau auf diese Art von Integration: eine, die heute gut funktioniert, nie als Dauerlösung gedacht war und sich einfach nie gelohnt hat, neu geschrieben zu werden.
Der Host bildet die Anfrageparameter und den Antwortinhalt von LocationIQ exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von My Geocode stammen. Anfragen im Format der LocationIQ-Endpunkte können unverändert an unseren Host gesendet werden, und die zurückgegebene Antwort lässt sich genauso auswerten, wie bestehender Code es bereits erwartet.
Diese Genauigkeit ist kein Zufall des Aufwands, der pro Anbieter betrieben wird. Jeder Kompatibilitäts-Host sitzt auf demselben Abrechnungs-, Kontingent- und Kontosystem, das auch den Rest von My Geocode betreibt, sodass der Bau eines neuen Hosts vor allem eine Zuordnungsaufgabe ist: Feldnamen und Parameterstrukturen werden dem angepasst, was die Clients eines bestimmten Anbieters bereits senden, statt ein separates Backend aufzusetzen. Deshalb verhalten sich Preise, Authentifizierung und Kontingenterfassung auf allen siebzehn Hosts identisch, statt im Lauf der Zeit auseinanderzudriften.
Die Authentifizierung folgt demselben Muster wie auf jedem Host der Plattform. 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, passend zu dem, was Ihre aktuelle LocationIQ-Integration bereits tut. Alle vier werden hier ausnahmslos akzeptiert, sodass Sie bei einem Wechsel Ihren HTTP-Client selten überhaupt anfassen müssen.
Die Preise ändern sich nicht danach, welcher Host oder Endpunkt einen Aufruf verarbeitet. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz, sodass sich das Kontingent sinnvoll auf einen gemeinsam genutzten Anschluss bezieht statt auf jedes Gerät dahinter. Ein Schlüssel fügt weitere eigene 2.500 kostenlose Anfragen pro Tag hinzu, die getrennt vom schlüssellosen Kontingent im selben Netz erfasst werden. Darüber hinaus kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab.
Jede Antwort enthält unseren vollständigen Satz an Kontingent-Headern, unabhängig davon, welcher Kompatibilitäts-Host sie verarbeitet hat: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining werden den Antworten dieses Hosts genauso beigefügt wie denen unserer nativen Endpunkte, sodass alles, was auf diesen Headern aufbaut, unverändert weiterfunktioniert.
Wenn ein Projekt mehr benötigt, als die kompatible Antwort liefert, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale zusätzliche Felder hinzu, rein optional. Bei einem Geokodierungsaufruf kann das die Geländehöhe für die zurückgegebenen Koordinaten umfassen, aus derselben Quelle, die auch /v1/elevation direkt beantwortet. Lassen Sie es weg, entspricht das Antwortformat exakt der Struktur von LocationIQ, ohne Überraschungen für bestehende Parsing-Logik.
Konten, die den Wechsel vollziehen und feststellen, dass er unter echtem Traffic standhält, empfehlen ihn oft allen anderen im Team weiter, die noch für den ursprünglichen Anbieter bezahlen. Das Empfehlungsprogramm im Dashboard unter /dashboard/referrals ist genau für diese Art von Mundpropaganda gedacht.
Der Host ist unter /compatibility/locationiq/ dokumentiert, allgemeine Hinweise zum Anbieterwechsel finden Sie unter /docs/compatibility/. Ein einzelner Testaufruf mit einem neuen Schlüssel reicht meist, um zu bestätigen, dass er sich sauber in eine bestehende Integration einfügt.