Die Google Maps Platform gehört zu den am häufigsten integrierten Geokodierungsdiensten überhaupt, und genau deshalb ist ein Wechsel weg von ihr besonders schwierig. Anfrage-Builder und Antwort-Parser in einer ganzen Codebasis neu zu schreiben, nur um einen anderen Anbieter auszuprobieren, ist den Entwicklungsaufwand selten wert. Deshalb haben wir einen Host gebaut, bei dem Sie nichts neu schreiben müssen.
Unser Kompatibilitäts-Host für die Google Maps Platform bildet die Anfrageparameter und die Antwortstruktur des Originaldienstes exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen. Was auch immer Ihre Integration derzeit an die Geokodierungs-Endpunkte von Google sendet, kann sie stattdessen an unsere senden. Ein Anbieterwechsel wird so zu einer Frage von Hostname und Schlüssel, nicht zu einem Entwicklungsprojekt.
Das ergänzt unsere eigenen nativen Endpunkte. Wenn Sie neu beginnen, sind /v1/forward, /v1/reverse, /v1/autocomplete und /v1/postcode unter /docs/ dokumentiert und liefern Ihnen direkt unsere Anfragestruktur. Wenn Sie bereits Code für das Google-Format geschrieben haben, können Sie ihn mit dem Kompatibilitäts-Host unter /compatibility/google-maps/ unverändert beibehalten.
Die Authentifizierung funktioniert auf dieselbe flexible Weise wie überall bei My Geocode: 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. Welches Muster Ihre bestehende Client-Bibliothek auch für die Google-API verwendet, eine dieser vier Varianten passt dazu, sodass auch der Authentifizierungscode Ihrer Integration selten geändert werden muss.
Die Preise auf dem Kompatibilitäts-Host sind dieselben wie überall sonst bei My Geocode. Jeder Schlüssel erhält 2.500 kostenlose Anfragen pro Tag, zusätzlich zu den 2.500 pro Tag, die jeder Adresse ganz ohne Schlüssel zur Verfügung stehen, gezählt pro Netz. Darüber hinaus kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab. Es gibt keinen gesonderten, höheren Preis für die Nutzung eines Kompatibilitäts-Hosts anstelle eines nativen Endpunkts. Jeder Endpunkt und jeder Drop-in-Host kostet gleich viel.
Jede Antwort enthält außerdem dieselben Kontingent-Header wie der Rest der API, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining und die übrigen, und gibt Ihnen so einen Einblick in die Nutzung, den ein einfacher Anbieterwechsel sonst nicht kostenlos bieten würde.
Wenn Ihre Integration mehr als die Standardantwort benötigt, fügt mg_extras=1 in einer Anfrage oder der X-MG-Extras-Header optionale zusätzliche Felder wie die Geländehöhe zur kompatiblen Struktur hinzu. Das ist rein additiv: Lassen Sie es weg, entspricht die Antwort genau dem Format des ursprünglichen Anbieters.
Das Ausprobieren dauert Minuten, keinen Sprint. Richten Sie einen Testaufruf mit einem neuen Schlüssel an /compatibility/google-maps/ und vergleichen Sie die Antwort mit dem, was Sie heute schon erhalten.