Remplacement compatible de Mapbox Geocoding

L'ancienne API Geocoding v5 comme les endpoints v6 actuels répondent sur mapbox.mygeocode.com. Les résultats sont des FeatureCollections GeoJSON avec les mêmes tableaux context, les mêmes valeurs place_type et le même ordre des coordonnées que ceux sur lesquels s'appuient les clients Mapbox.

Changez un seul nom d'hôte

Hôte d'origine	`api.mapbox.com`
À utiliser à la place	`mapbox.mygeocode.com`
Paramètre de clé	`access_token` (facultatif : toute adresse dispose de 2 500 requêtes par jour sans clé ; mettez ici votre clé My Geocode pour le crédit, les forfaits et un historique d'utilisation)

Avant

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

Après

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

Pourquoi changer

Mapbox facture différemment le géocodage temporaire et permanent, et rattache l'utilisation à un compte avec une carte bancaire enregistrée. Ici, vous pouvez conserver les résultats, et les 2 500 premières requêtes de chaque clé sont gratuites chaque jour.

Le même quota gratuit, avec ou sans clé. Les requêtes vers mapbox.mygeocode.com sont décomptées des mêmes 2 500 requêtes gratuites par jour dont votre adresse, ou votre clé, dispose sur nos propres endpoints. Au-delà, crédit prépayé à 0,0001 € par requête, ou 50 € par mois pour une clé Unlimited. L'inscription ne demande qu'une adresse e-mail, rien d'autre.

Voir les tarifs Obtenir une clé gratuite

Endpoints

Chemin sur mapbox.mygeocode.com	Rôle	Fourni par
`/geocoding/v5/mapbox.places/{query}.json`	Géocodage direct, v5	Géocodage direct
`/geocoding/v5/mapbox.places/{lon},{lat}.json`	Géocodage inverse, v5	Géocodage inverse
`/search/geocode/v6/forward?q=...`	Géocodage direct, v6	Géocodage direct
`/search/geocode/v6/reverse?longitude=...&latitude=...`	Géocodage inverse, v6	Géocodage inverse
`/search/searchbox/v1/suggest?q=...`	Suggestions Search Box	Saisie semi-automatique d'adresses

Exemple de réponse

Voici ce que renvoie la requête ci-dessus. Les noms de champs, l'imbrication et les types suivent Mapbox. Seules les données qu'ils contiennent sont les nôtres.

Réponse de 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/"
}

Détails et différences

Aucune clé n'est nécessaire pour les 2 500 premières requêtes de la journée. Pour utiliser une clé My Geocode, placez-la là où se trouvait votre clé Mapbox : le paramètre de requête access_token. L'en-tête X-API-Key, Authorization: Bearer et l'authentification HTTP Basic (la clé comme nom d'utilisateur) fonctionnent aussi sur tous les hôtes, de sorte que les bibliothèques clientes qui s'authentifient à leur manière continuent de fonctionner sans modification.

Les mentions de copyright, noms de licence, conditions et liens de confidentialité de la réponse sont les nôtres et non ceux du fournisseur d'origine. Tout le reste conserve la structure d'origine.

Les endpoints v5 Places et v6 search sont tous deux routés, ainsi que l'endpoint suggest de Search Box.
POST /search/geocode/v6/batch avec un tableau JSON de 1 000 objets de requête au maximum (direct q ou inverse longitude/latitude) renvoie {"batch": [...]} avec une FeatureCollection par requête, comme Mapbox ; chaque requête compte pour une, comme Mapbox les compte.

Si votre client dépend d'un champ ou d'un comportement qui ne figure pas ici, dites-le-nous. Les écarts de compatibilité sont corrigés rapidement, car ils sont généralement minimes.

Autres hôtes compatibles

Fonctionnement des hôtes compatibles, la vue d'ensemble et les remplacements compatibles pour bibliothèques JavaScript.