Drop-in-Ersatz für Google Maps Platform

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. Ändern Sie den Host, setzen Sie Ihren My Geocode Schlüssel in den Parameter key ein, und der Rest Ihres Codes bleibt, wie er ist.

Einen Hostnamen ändern

Ursprünglicher Host	`maps.googleapis.com`
Stattdessen verwenden	`gapi.mygeocode.com`
Schlüsselparameter	`key` (optional: Jede Adresse erhält 2.500 Anfragen pro Tag ohne Schlüssel; setzen Sie hier Ihren My Geocode Schlüssel ein für Guthaben, Pakete und einen Nutzungsverlauf)

Vorher

curl "https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_GOOGLE_KEY"

Nachher

curl "https://gapi.mygeocode.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

Google verlangt bei jedem Aufruf ein Rechnungskonto und einen Schlüssel und rechnet pro Anfrage über jede SKU ab. Hier deckt ein kostenloser Schlüssel die ersten 2.500 Aufrufe pro Tag ab, und danach kostet es 0,0001 € pro Anfrage oder pauschal 50 € pro Monat.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an gapi.mygeocode.com zählen zu denselben 2.500 kostenlosen Anfragen pro Tag, die Ihre Adresse oder Ihr Schlüssel auf unseren eigenen Endpunkten erhält. Darüber hinaus Prepaid-Guthaben zu 0,0001 € pro Anfrage oder 50 € pro Monat für einen Unlimited-Schlüssel. Für die Registrierung brauchen Sie nur eine E-Mail-Adresse, sonst nichts.

Preise ansehen Kostenlosen Schlüssel holen

Endpunkte

Pfad auf gapi.mygeocode.com	Funktion	Basiert auf
`/maps/api/geocode/json?address=...`	Geokodierung	Geokodierung
`/maps/api/geocode/json?latlng=lat,lng`	Reverse-Geokodierung	Reverse-Geokodierung
`/maps/api/place/autocomplete/json?input=...`	Places Autocomplete (Vorschläge mit Koordinaten)	Adress-Autovervollständigung
`/maps/api/timezone/json?location=lat,lng&timestamp=...`	Time Zone API	Zeitzonen-Abfrage
`/maps/api/elevation/json?locations=lat,lng\|lat,lng`	Elevation API	Höhenabfrage

Beispielantwort

Das liefert die obige Anfrage. Feldnamen, Verschachtelung und Typen folgen Google Maps. Nur die Daten dahinter stammen von uns.

Antwort von gapi.mygeocode.com

{
  "results": [
    {
      "address_components": [
        { "long_name": "1600", "short_name": "1600", "types": ["street_number"] },
        { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": ["route"] },
        { "long_name": "Mountain View", "short_name": "Mountain View", "types": ["locality", "political"] },
        { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": ["administrative_area_level_2", "political"] },
        { "long_name": "California", "short_name": "CA", "types": ["administrative_area_level_1", "political"] },
        { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
        { "long_name": "94043", "short_name": "94043", "types": ["postal_code"] }
      ],
      "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "geometry": {
        "location": { "lat": 37.4224428, "lng": -122.0842467 },
        "location_type": "ROOFTOP",
        "viewport": {
          "northeast": { "lat": 37.4237918, "lng": -122.0828977 },
          "southwest": { "lat": 37.4210938, "lng": -122.0855957 }
        }
      },
      "place_id": "mg.us.addr.5e1b2c7a9f",
      "plus_code": { "compound_code": "CWC8+W5 Mountain View, CA, USA", "global_code": "849VCWC8+W5" },
      "types": ["street_address"]
    }
  ],
  "status": "OK"
}

Details und Unterschiede

Für die ersten 2.500 Anfragen pro Tag ist kein Schlüssel nötig. Um einen My Geocode Schlüssel zu verwenden, setzen Sie ihn dort ein, wo Ihr Google-Schlüssel stand: im Query-Parameter key oder im Header X-Goog-Api-Key. Der Header X-API-Key, Authorization: Bearer und HTTP-Basic-Authentifizierung (der Schlüssel als Benutzername) funktionieren ebenfalls auf jedem Host, sodass Client-Bibliotheken, die sich auf ihre eigene Weise authentifizieren, unverändert weiter funktionieren.

Fehlerantworten entsprechen der aufgerufenen API: Die Time Zone API antwortet mit errorMessage und status, die anderen mit error_message, der leeren Ergebnisliste und dann status.
Zeitzonen-Antworten verwenden über offenem Wasser ZERO_RESULTS, wie bei Google, und berücksichtigen language.
Elevation akzeptiert locations, eine mit enc: kodierte Polylinie sowie path mit samples, bis zu 512 Punkte, wie Google es erlaubt; jeder Punkt zählt hier als eine Anfrage.

Wenn Ihr Client von einem Feld oder Verhalten abhängt, das hier nicht aufgeführt ist, sagen Sie es uns. Kompatibilitätslücken werden schnell geschlossen, weil sie meist klein sind.

Weitere Drop-in-Hosts

So funktionieren die Drop-in-Hosts, der Überblick und die Drop-ins für JavaScript-Bibliotheken.