Reemplazo compatible de MapQuest Geocoding

Tanto los endpoints de geocodificación con licencia de MapQuest como los de Open Data responden en mapquest.mygeocode.com, con la envoltura info, options y results y la nomenclatura de adminArea1 a adminArea6 que analizan los clientes de MapQuest.

Cambia un nombre de host

Host original	`www.mapquestapi.com` `open.mapquestapi.com`
Usa en su lugar	`mapquest.mygeocode.com`
Parámetro de la clave	`key` (opcional: cualquier dirección recibe 2.500 solicitudes al día sin clave; pon aquí tu clave de My Geocode para tener crédito, paquetes y un historial de uso)

Antes

curl "https://www.mapquestapi.com/geocoding/v1/address?key=YOUR_MAPQUEST_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"

Después

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

Por qué se cambia la gente

El nivel gratuito de MapQuest se ha reducido con los años y sus planes para desarrolladores son niveles mensuales. Aquí tienes 2.500 al día gratis y, a partir de ahí, precios por solicitud o una tarifa fija.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a mapquest.mygeocode.com cuentan para las mismas 2.500 solicitudes gratuitas al día que tu dirección, o tu clave, recibe en nuestros propios endpoints. Por encima de eso, crédito prepago a 0,0001 € por solicitud, o 50 € al mes por una clave Unlimited. Para registrarte solo necesitas una dirección de correo electrónico.

Ver precios Obtén una clave gratis

Endpoints

Ruta en mapquest.mygeocode.com	Qué hace	Respaldado por
`/geocoding/v1/address?location=...`	Geocodificación directa	Geocodificación directa
`/elevation/v1/profile?latLngCollection=lat,lng,lat,lng` (también `shapeFormat=cmp`/`cmp6`, `unit=m\|f` y POST con JSON)	Perfil de elevación	Consulta de elevación
`/geocoding/v1/reverse?location=lat,lng`	Geocodificación inversa	Geocodificación inversa
`/geocoding/v1/batch?location=...&location=...`	Geocodificación por lotes	Geocodificación directa

Ejemplo de respuesta

Esto es lo que devuelve la solicitud anterior. Los nombres de campo, el anidamiento y los tipos siguen a MapQuest. Solo los datos que hay detrás son nuestros.

Respuesta 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 }
        }
      ]
    }
  ]
}

Detalles y diferencias

No se necesita clave para las primeras 2.500 solicitudes al día. Para usar una clave de My Geocode, ponla donde iba tu clave de MapQuest: el parámetro de consulta key. La cabecera X-API-Key, Authorization: Bearer y la autenticación HTTP Basic (con la clave como nombre de usuario) también funcionan en todos los hosts, así que las bibliotecas cliente que se autentican a su manera siguen funcionando sin cambios.

Las líneas de copyright, los nombres de licencia y los enlaces a los términos y a la privacidad de la respuesta son nuestros y no del proveedor original. Todo lo demás conserva la estructura original.

El perfil de elevación acepta latLngCollection como pares sin procesar o como ruta comprimida cmp o cmp6, en metros o en pies, por GET o por POST.
La geocodificación por lotes funciona con parámetros location= repetidos o con una lista locations enviada por POST, y responde una entrada por cada dato de entrada.
Un lote acepta hasta 100 ubicaciones y cuenta una solicitud por ubicación, como MapQuest.
Los puntos sin datos indican una altura de -32768, como MapQuest.

Si tu cliente depende de un campo o de un comportamiento que no aparece aquí, dínoslo. Las carencias de compatibilidad se corrigen rápido porque suelen ser pequeñas.

Otros hosts compatibles

Cómo funcionan los hosts compatibles, el resumen y los reemplazos compatibles de bibliotecas JavaScript.