Neuigkeiten

Eine öffentliche Kompatibilitätsmatrix: siebzehn Hosts, ein Schlüssel

Siebzehn Kompatibilitäts-Hosts sind viel, um sie Ankündigung für Ankündigung im Blick zu behalten, deshalb haben wir sie alle an einem Ort zusammengefasst: eine Kompatibilitätsmatrix unter /compatibility/, die jeden unterstützten Drop-in-Host nebeneinander auflistet, mit einem direkten Link zur jeweiligen Dokumentation.

Die Liste umfasst Google Maps Platform, Bing Maps REST Services, HERE Geocoding and Search, Mapbox Geocoding, Geocode.Farm, OpenStreetMap Nominatim, OpenCage, LocationIQ, Geoapify, TomTom Search, MapQuest Geocoding, Geocodio, PositionStack, ip-api.com, ipinfo.io, ipstack und Open-Elevation. Zusammen decken sie Geokodierung, IP-Geolokalisierung und Höhenabfragen ab und bilden die Anfrage- und Antwortstruktur jedes ursprünglichen Anbieters exakt nach, abgesehen von Copyright-, Nutzungs- und Datenschutztexten, die von uns stammen.

Sie auf einer Seite zusammenzufassen, dient nicht nur der Ordnung. Ein Team, das abwägt, von welchem Anbieter es wechseln will, sieht so das gesamte Feld auf einmal, statt Kompatibilitäts-Hosts einzeln über separate Ankündigungen zu entdecken. Wenn Ihr Stack mehr als einen dieser Anbieter nutzt, ob Mapbox für die Geokodierung und ipinfo.io für IP-Abfragen oder eine andere Kombination, macht die Matrix deutlich, dass sich alle hinter einem My Geocode Konto und einem Schlüssel bündeln lassen.

Diese Bündelung ist der eigentliche Vorteil des Kompatibilitätsansatzes insgesamt. Ein einziger Schlüssel authentifiziert sich bei jedem Host auf der Liste, mit derjenigen unserer vier Standardmethoden, die Ihre Integration bereits bevorzugt: ein X-API-Key-Header, ein Authorization: Bearer-Header, HTTP-Basic-Authentifizierung oder ein Query-Parameter. Die Nutzung über alle Hosts hinweg zählt auf dasselbe kostenlose Kontingent, dasselbe Prepaid-Guthaben oder dasselbe Unlimited-Paket, und jede Antwort, egal von welchem Host, enthält dieselben Kontingent-Header. Ein Konto, ein Schlüssel, eine Rechnung, für beliebig viele separate Anbieter, von denen Ihre Integration bisher abhing.

Für Teams, die eine umfassendere Migration statt des Austauschs eines einzelnen Anbieters erwägen, ist diese Matrix der natürliche Ausgangspunkt, und allgemeine Hinweise zur Migration finden Sie daneben unter /docs/compatibility/. Die Dokumentationsseite jedes Hosts behandelt die jeweiligen Anfrageparameter und alle Details, die man vor dem Wechsel kennen sollte.

Wir werden diese Seite aktuell halten, während sich die Kompatibilitätsabdeckung weiterentwickelt, damit sie die zentrale Referenz für das Verfügbare bleibt und nicht zwischen einzelnen Ankündigungen veraltet.