My Geocode

Drop-in-Ersatz für andere Geocoding-APIs

Ein Wechsel des Geocoding-Anbieters bedeutet meist, den Code neu zu schreiben, der die Antworten verarbeitet. Das möchten wir Ihnen lieber ersparen. Jeder der folgenden Hosts akzeptiert die Pfade und Parameter der API eines Anbieters und antwortet im JSON-Format dieses Anbieters, mit unseren Daten dahinter. Ändern Sie den Hostnamen, setzen Sie Ihren My Geocode Schlüssel dort ein, wo der alte stand, und gehen Sie live. Für einen kostenlosen Schlüssel brauchen Sie Ihren Namen, eine E-Mail-Adresse und eine Minute.

  1. Finden Sie unten Ihren Anbieter

    Jede Seite nennt den ursprünglichen Host, den Ersatz-Host und jeden unterstützten Pfad.

  2. Ändern Sie den Host in Ihrer Konfiguration

    Zum Beispiel wird maps.googleapis.com zu gapi.mygeocode.com. Pfade und Parameter bleiben gleich.

  3. Tauschen Sie den Schlüssel aus

    Setzen Sie Ihren My Geocode Schlüssel in denselben Parameter ein, den der alte Schlüssel verwendet hat. Ein kostenloser Schlüssel hat 2.500 Anfragen pro Tag.

REST-Hosts

Google Maps Platform

maps.googleapis.com → gapi.mygeocode.com

Die Webdienste Geocoding, Places Autocomplete, Time Zone und Elevation antworten alle unter denselben Pfaden auf gapi.mygeocode.com, mit derselben JSON-Struktur, die Google liefert.

Endpunkte und Antwortformat

Bing Maps REST Services

dev.virtualearth.net → bing.mygeocode.com

Microsoft stellt Bing Maps for Enterprise ein.

Endpunkte und Antwortformat

HERE Geocoding and Search

geocode.search.hereapi.com, revgeocode.search.hereapi.com, autosuggest.search.hereapi.com, autocomplete.search.hereapi.com → here.mygeocode.com

HERE verteilt seine Such-API auf mehrere Hosts.

Endpunkte und Antwortformat

Mapbox Geocoding

api.mapbox.com → mapbox.mygeocode.com

Sowohl die ältere Geocoding API v5 als auch die aktuellen v6-Endpunkte antworten unter mapbox.mygeocode.com.

Endpunkte und Antwortformat

Geocode.Farm

api.geocode.farm, www.geocode.farm → farm.mygeocode.com

Die Forward- und Reverse-Endpunkte von Geocode.Farm antworten in den URL-Stilen von v3 und v4 unter farm.mygeocode.com.

Endpunkte und Antwortformat

OpenStreetMap Nominatim

nominatim.openstreetmap.org → osm.mygeocode.com

Die öffentliche Nominatim-Instanz erlaubt höchstens eine Anfrage pro Sekunde und keine intensive Nutzung.

Endpunkte und Antwortformat

OpenCage

api.opencagedata.com → opencage.mygeocode.com

OpenCage verwendet einen Endpunkt für Geokodierung und Reverse-Geokodierung und liefert einen umfangreichen annotations-Block.

Endpunkte und Antwortformat

LocationIQ

us1.locationiq.com, eu1.locationiq.com → locationiq.mygeocode.com

Die Endpunkte search, reverse, autocomplete und timezone von LocationIQ antworten unter locationiq.mygeocode.com.

Endpunkte und Antwortformat

Geoapify

api.geoapify.com → geoapify.mygeocode.com

Die Geocoding-Endpunkte von Geoapify liefern GeoJSON-FeatureCollections mit einem flachen properties-Objekt.

Endpunkte und Antwortformat

TomTom Search

api.tomtom.com → tomtom.mygeocode.com

Die Endpunkte Geocode, Reverse Geocode und Fuzzy Search von TomTom antworten unter tomtom.mygeocode.com mit derselben summary- und results-Struktur, einschließlich des Feldes freeformAddress, das die meisten Integrationen anzeigen.

Endpunkte und Antwortformat

MapQuest Geocoding

www.mapquestapi.com, open.mapquestapi.com → mapquest.mygeocode.com

Sowohl die lizenzierten als auch die Open-Data-Geocoding-Endpunkte von MapQuest antworten unter mapquest.mygeocode.com, mit der Hülle aus info, options und results und der Benennung adminArea1 bis adminArea6, die MapQuest-Clients auswerten.

Endpunkte und Antwortformat

Geocodio

api.geocod.io → geocodio.mygeocode.com

Geocodio konzentriert sich auf die Vereinigten Staaten und Kanada.

Endpunkte und Antwortformat

PositionStack

api.positionstack.com → positionstack.mygeocode.com

Die Forward- und Reverse-Endpunkte von PositionStack antworten unter positionstack.mygeocode.com mit demselben data-Array und denselben flachen Feldnamen.

Endpunkte und Antwortformat

ip-api.com

ip-api.com, pro.ip-api.com → ipapi.mygeocode.com

Der JSON-Endpunkt von ip-api ist eines der am häufigsten nachgebildeten Formate für IP-Abfragen.

Endpunkte und Antwortformat

ipinfo.io

ipinfo.io → ipinfo.mygeocode.com

Das kompakte JSON von ipinfo mit einem loc-String und einem org-String, dem die AS-Nummer vorangestellt ist, wird unter ipinfo.mygeocode.com nachgebildet.

Endpunkte und Antwortformat

ipstack

api.ipstack.com → ipstack.mygeocode.com

Die Standard-Lookup- und check-Endpunkte von ipstack antworten unter ipstack.mygeocode.com mit denselben Feldern auf oberster Ebene und demselben location-Objekt, über HTTPS in jedem Tarif.

Endpunkte und Antwortformat

Open-Elevation

api.open-elevation.com → openelevation.mygeocode.com

Der öffentliche Server von Open-Elevation ist ein ehrenamtliches Projekt ohne Verfügbarkeitszusage.

Endpunkte und Antwortformat

JavaScript-Bibliotheken

Derselbe Ansatz funktioniert für Karten- und Geocoder-Bibliotheken. Laden Sie die Google Maps JavaScript API von gapi.mygeocode.com, und google.maps.Map, Geocoder und places.Autocomplete funktionieren weiter mit unseren Kacheln und Daten, ohne Gebühren für Kartenaufrufe. Es gibt Loader für das Bing Maps V8 Control, HERE Maps for JavaScript und MapQuest.js sowie Konfigurationen für MapLibre und Mapbox GL mit mapbox-gl-geocoder und für die Leaflet-Geocoder-Plugins.

JavaScript-Drop-ins Vollständige Referenz und Migrations-Checkliste

Was gleich ist und was nicht

Gleich

  • Pfade, Query-Parameter und HTTP-Methoden, wie vom Anbieter dokumentiert.
  • Antwortstruktur: Feldnamen, Verschachtelung, Arrays, Typen und Reihenfolge der Koordinaten.
  • Statuswerte, zum Beispiel OK und ZERO_RESULTS bei Google oder statusCode bei Bing.
  • Fehlerstrukturen, damit Ihre bestehende Fehlerbehandlung weiter funktioniert.
  • Preise. Eine Anfrage an einen Kompatibilitäts-Host kostet dasselbe wie eine Anfrage an unseren eigenen Endpunkt und wird vom selben Schlüsselkontingent abgezogen.

Anders

  • Die Daten. Koordinaten, formatierte Adressen und Konfidenzwerte stammen von uns und stimmen daher nicht Ziffer für Ziffer mit dem ursprünglichen Anbieter überein.
  • Kennungen. Place IDs stammen von uns und sind stabil, können aber nicht an den ursprünglichen Anbieter übergeben werden.
  • Funktionen außerhalb von Geokodierung, IP, Zeitzone und Höhe, etwa Routing, Place Details und Fotos, sind nicht enthalten. Jede Seite listet auf, was fehlt.
  • Schlüssel. Ein nutzungsbasierter Schlüssel funktioniert von zwei IP-Adressen innerhalb von rollierenden 24 Stunden und ein Unlimited-Schlüssel von drei, wie bei unseren eigenen Endpunkten. Verwenden Sie für größere Flotten mehr Schlüssel oder Pakete.

Ihr Anbieter ist nicht aufgeführt?

Einen Kompatibilitäts-Host hinzuzufügen, ist ein paar Tage Arbeit, wenn das Format des Anbieters dokumentiert ist. Wenn Sie einen Dienst nutzen, der hier nicht aufgeführt ist, sagen Sie uns, welchen und ungefähr wie viele Anfragen pro Tag Sie senden.