Reemplazo compatible de Mapbox Geocoding

Tanto la antigua Geocoding API v5 como los endpoints v6 actuales responden en mapbox.mygeocode.com. Los resultados son FeatureCollections GeoJSON con los mismos arrays context, los mismos valores de place_type y el mismo orden de coordenadas en los que confían los clientes de Mapbox.

Cambia un nombre de host

Host original	`api.mapbox.com`
Usa en su lugar	`mapbox.mygeocode.com`
Parámetro de la clave	`access_token` (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://api.mapbox.com/geocoding/v5/mapbox.places/1%20Market%20St%20San%20Francisco.json?access_token=YOUR_MAPBOX_TOKEN"

Después

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

Por qué se cambia la gente

Mapbox factura de forma distinta la geocodificación temporal y la permanente, y vincula el uso a una cuenta con una tarjeta registrada. Aquí, los resultados son tuyos y las primeras 2.500 solicitudes al día de cada clave son gratuitas.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a mapbox.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 mapbox.mygeocode.com	Qué hace	Respaldado por
`/geocoding/v5/mapbox.places/{query}.json`	Geocodificación directa, v5	Geocodificación directa
`/geocoding/v5/mapbox.places/{lon},{lat}.json`	Geocodificación inversa, v5	Geocodificación inversa
`/search/geocode/v6/forward?q=...`	Geocodificación directa, v6	Geocodificación directa
`/search/geocode/v6/reverse?longitude=...&latitude=...`	Geocodificación inversa, v6	Geocodificación inversa
`/search/searchbox/v1/suggest?q=...`	Sugerencias de Search Box	Autocompletado de direcciones

Ejemplo de respuesta

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

Respuesta 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/"
}

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 Mapbox: el parámetro de consulta access_token. 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.

Se enrutan tanto los endpoints v5 Places como los endpoints de búsqueda v6, junto con el endpoint suggest de Search Box.
POST /search/geocode/v6/batch con un array JSON de hasta 1.000 objetos de consulta (directa con q o inversa con longitude/latitude) responde {"batch": [...]} con una FeatureCollection por consulta, como Mapbox; cada consulta cuenta como una solicitud, igual que las cuenta Mapbox.

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.