Drop-in-Ersatz für Mapbox Geocoding

Sowohl die ältere Geocoding API v5 als auch die aktuellen v6-Endpunkte antworten unter mapbox.mygeocode.com. Die Ergebnisse sind GeoJSON-FeatureCollections mit denselben context-Arrays, place_type-Werten und derselben Reihenfolge der Koordinaten, auf die sich Mapbox-Clients verlassen.

Einen Hostnamen ändern

Ursprünglicher Host	`api.mapbox.com`
Stattdessen verwenden	`mapbox.mygeocode.com`
Schlüsselparameter	`access_token` (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://api.mapbox.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MAPBOX_TOKEN"

Nachher

curl "https://mapbox.mygeocode.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MYGEOCODE_KEY"

Warum Nutzer wechseln

Mapbox rechnet temporäre und dauerhafte Geokodierung unterschiedlich ab und bindet die Nutzung an ein Konto mit hinterlegter Karte. Hier dürfen Sie die Ergebnisse behalten, und die ersten 2.500 Anfragen pro Tag sind für jeden Schlüssel kostenlos.

Gleiches kostenloses Kontingent, mit oder ohne Schlüssel. Anfragen an mapbox.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 mapbox.mygeocode.com	Funktion	Basiert auf
`/geocoding/v5/mapbox.places/{query}.json`	Geokodierung, v5	Geokodierung
`/geocoding/v5/mapbox.places/{lon},{lat}.json`	Reverse-Geokodierung, v5	Reverse-Geokodierung
`/search/geocode/v6/forward?q=...`	Geokodierung, v6	Geokodierung
`/search/geocode/v6/reverse?longitude=...&latitude=...`	Reverse-Geokodierung, v6	Reverse-Geokodierung
`/search/searchbox/v1/suggest?q=...`	Search-Box-Vorschläge	Adress-Autovervollständigung

Beispielantwort

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

Antwort von mapbox.mygeocode.com (v5)

{
  "type": "FeatureCollection",
  "query": ["1", "market", "st", "san", "francisco"],
  "features": [
    {
      "id": "address.mg.us.4d2e8b10",
      "type": "Feature",
      "place_type": ["address"],
      "relevance": 1,
      "properties": { "accuracy": "rooftop" },
      "text": "Market Street",
      "place_name": "1 Market Street, San Francisco, California 94105, United States",
      "center": [-122.394626, 37.793858],
      "geometry": { "type": "Point", "coordinates": [-122.394626, 37.793858] },
      "address": "1",
      "context": [
        { "id": "neighborhood.mg.us.fidi", "text": "Financial District" },
        { "id": "postcode.mg.us.94105", "text": "94105" },
        { "id": "place.mg.us.sanfrancisco", "wikidata": "Q62", "text": "San Francisco" },
        { "id": "region.mg.us.ca", "short_code": "US-CA", "text": "California" },
        { "id": "country.mg.us", "short_code": "us", "text": "United States" }
      ]
    }
  ],
  "attribution": "My Geocode, https://www.mygeocode.com/terms/"
}

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 Mapbox-Schlüssel stand: im Query-Parameter access_token. 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.

Copyright-Zeilen, Lizenznamen, Nutzungsbedingungen und Datenschutz-Links in der Antwort stammen von uns statt vom ursprünglichen Anbieter. Alles andere behält die ursprüngliche Struktur.

Sowohl die v5-Places- als auch die v6-Such-Endpunkte werden weitergeleitet, ebenso der Suggest-Endpunkt der Search Box.
POST /search/geocode/v6/batch mit einem JSON-Array von bis zu 1.000 Abfrageobjekten (Geokodierung mit q oder Reverse-Geokodierung mit longitude/latitude) wird mit {"batch": [...]} beantwortet, mit einer FeatureCollection pro Abfrage, wie bei Mapbox; jede Abfrage zählt als eine Anfrage, so wie Mapbox zählt.

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.