Remplacement compatible de MapQuest Geocoding

Les endpoints de géocodage MapQuest sous licence comme Open Data répondent sur mapquest.mygeocode.com, avec l'enveloppe info, options et results et la nomenclature adminArea1 à adminArea6 qu'analysent les clients MapQuest.

Changez un seul nom d'hôte

Hôte d'origine	`www.mapquestapi.com` `open.mapquestapi.com`
À utiliser à la place	`mapquest.mygeocode.com`
Paramètre de clé	`key` (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://www.mapquestapi.com/geocoding/v1/address?key=YOUR_MAPQUEST_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Après

curl "https://mapquest.mygeocode.com/geocoding/v1/address?key=YOUR_MYGEOCODE_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Pourquoi changer

L'offre gratuite de MapQuest s'est réduite au fil des années et ses offres développeur sont des paliers mensuels. Ici, vous disposez de 2 500 par jour gratuitement, puis d'une tarification à la requête ou forfaitaire.

Le même quota gratuit, avec ou sans clé. Les requêtes vers mapquest.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 mapquest.mygeocode.com	Rôle	Fourni par
`/geocoding/v1/address?location=...`	Géocodage direct	Géocodage direct
`/elevation/v1/profile?latLngCollection=lat,lng,lat,lng` (ainsi que `shapeFormat=cmp`/`cmp6`, `unit=m\|f`, POST JSON)	Profil d'altitude	Recherche d'altitude
`/geocoding/v1/reverse?location=lat,lng`	Géocodage inverse	Géocodage inverse
`/geocoding/v1/batch?location=...&location=...`	Géocodage par lots	Géocodage direct

Exemple de réponse

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

Réponse de mapquest.mygeocode.com

{
  "info": {
    "statuscode": 0,
    "copyright": { "text": "My Geocode", "imageUrl": "https://www.mygeocode.com/assets/img/logo.svg", "imageAltText": "My Geocode" },
    "messages": []
  },
  "options": { "maxResults": -1, "thumbMaps": false, "ignoreLatLngInput": false },
  "results": [
    {
      "providedLocation": { "location": "233 S Wacker Dr, Chicago, IL" },
      "locations": [
        {
          "street": "233 S Wacker Dr",
          "adminArea6": "Loop",
          "adminArea6Type": "Neighborhood",
          "adminArea5": "Chicago",
          "adminArea5Type": "City",
          "adminArea4": "Cook County",
          "adminArea4Type": "County",
          "adminArea3": "IL",
          "adminArea3Type": "State",
          "adminArea1": "US",
          "adminArea1Type": "Country",
          "postalCode": "60606",
          "geocodeQualityCode": "P1AAA",
          "geocodeQuality": "POINT",
          "dragPoint": false,
          "sideOfStreet": "R",
          "linkId": "0",
          "unknownInput": "",
          "type": "s",
          "latLng": { "lat": 41.878876, "lng": -87.635918 },
          "displayLatLng": { "lat": 41.878876, "lng": -87.635918 }
        }
      ]
    }
  ]
}

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é MapQuest : le paramètre de requête key. 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.

Le profil d'altitude accepte latLngCollection sous forme de paires brutes ou de tracé compressé cmp ou cmp6, en mètres ou en pieds, par GET ou POST.
Le géocodage par lots fonctionne avec des paramètres location= répétés ou une liste locations envoyée en POST, et renvoie une entrée par élément envoyé.
Un lot accepte jusqu'à 100 emplacements et compte une requête par emplacement, comme MapQuest.
Les points sans données indiquent une hauteur de -32768, comme chez MapQuest.

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.