Viele Karten-Integrationen wurden vor Jahren gegen die Bing Maps REST Services gebaut und laufen seitdem einfach weiter, unangetastet, weil es nie einen zwingenden Grund gab, sie neu zu schreiben. Wir glauben, dass es jetzt einen gibt: einen kompatiblen Host, der dieselben Anfragen annimmt und dieselbe Antwortstruktur zurückgibt, mit einer Preis- und Kontingentstruktur, die vom ersten Aufruf an transparent ist.
Unser Kompatibilitäts-Host für die Bing Maps REST Services bildet die Anfrageparameter und den Antwortinhalt des Originaldienstes exakt nach, mit Ausnahme der Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die sich auf My Geocode statt auf den ursprünglichen Anbieter beziehen. Bestehender Code, der Anfragen im Bing-Format erstellt, Antworten im Bing-Format auswertet oder beides tut, lässt sich ohne Neuschreiben auf unseren Host umstellen.
Dafür ändern Sie zwei Dinge: den Hostnamen, an den Ihre Anfragen gehen, und den Schlüssel, mit dem Sie sich authentifizieren. Dieser Schlüssel kann so übermittelt werden, wie Ihre Integration es bereits vorsieht, als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als einfacher Query-Parameter. Alle vier Varianten funktionieren auf jedem Host von My Geocode identisch, auch auf diesem.
Die Preise hinter der Kompatibilitätsschicht sind dieselben wie überall sonst auf der Plattform. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag, ganz ohne Schlüssel, gezählt pro Netz, damit ein gemeinsam genutzter Anschluss nicht auf viele Schlüssel verteilt werden kann, um das kostenlose Kontingent zu vervielfachen. Jeder Schlüssel fügt darüber hinaus eigene 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits dieser Kontingente wird Prepaid-Guthaben zu 0,0001 € pro Anfrage verbraucht oder ein Unlimited-Paket zu 50 € im Monat genutzt, und dieser Preis gilt unabhängig davon, an welchen Host oder Endpunkt die Anfrage ging.
Die Sicht auf das Kontingent verschwindet nicht, nur weil die Antwortstruktur der eines anderen Anbieters entspricht. Jeder Aufruf liefert weiterhin X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining und die übrigen Header unseres Standardsatzes, sodass Sie immer genau wissen, wo ein bestimmter Schlüssel oder ein Netz steht, etwas, das der Originaldienst in dieser Form nicht bietet.
Für Teams, die mehr als die streng kompatible Antwort möchten, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale Felder zur Standardstruktur hinzu, ohne diese zu verändern. Lassen Sie das Flag ganz weg, ist die Antwort in ihrer Struktur nicht von dem zu unterscheiden, was die Original-API zurückgegeben hätte.
Migrationsanleitungen, die den Umzug einer bestehenden Integration Endpunkt für Endpunkt durchgehen, finden Sie unter /docs/compatibility/, und der Host selbst ist unter /compatibility/bing-maps/ dokumentiert. Ein Test kostet Sie nichts außer ein paar freien Minuten und einem Schlüssel.