Reemplazos compatibles (drop-in) para otras API de geocodificación

Cambiar de proveedor de geocodificación suele significar reescribir el código que analiza las respuestas. Preferimos que no tengas que hacerlo. Cada host de abajo acepta las rutas y los parámetros de la API de un proveedor y responde en el formato JSON de ese proveedor, con nuestros datos detrás. Cambia el nombre de host, pon tu clave de My Geocode donde iba la anterior y publica. Una clave gratuita solo pide tu nombre, una dirección de correo electrónico y un minuto.

  1. Encuentra tu proveedor a continuación

    Cada página indica el host original, el host de reemplazo y todas las rutas compatibles.

  2. Cambia el host en tu configuración

    Por ejemplo, maps.googleapis.com pasa a ser gapi.mygeocode.com. Las rutas y los parámetros siguen siendo los mismos.

  3. Cambia la clave

    Pon tu clave de My Geocode en el mismo parámetro que usaba la clave anterior. Una clave gratuita tiene 2.500 solicitudes al día.

Hosts REST

Google Maps Platform

maps.googleapis.com → gapi.mygeocode.com

Los servicios web Geocoding, Places Autocomplete, Time Zone y Elevation responden todos en las mismas rutas en gapi.mygeocode.com, con la misma estructura JSON que devuelve Google.

Endpoints y formato de respuesta

Bing Maps REST Services

dev.virtualearth.net → bing.mygeocode.com

Microsoft va a retirar Bing Maps for Enterprise.

Endpoints y formato de respuesta

HERE Geocoding and Search

geocode.search.hereapi.com, revgeocode.search.hereapi.com, autosuggest.search.hereapi.com, autocomplete.search.hereapi.com → here.mygeocode.com

HERE reparte su API de búsqueda entre varios hosts.

Endpoints y formato de respuesta

Mapbox Geocoding

api.mapbox.com → mapbox.mygeocode.com

Tanto la antigua Geocoding API v5 como los endpoints v6 actuales responden en mapbox.mygeocode.com.

Endpoints y formato de respuesta

Geocode.Farm

api.geocode.farm, www.geocode.farm → farm.mygeocode.com

Los endpoints directos e inversos de Geocode.Farm, con los estilos de URL v3 y v4, responden en farm.mygeocode.com.

Endpoints y formato de respuesta

OpenStreetMap Nominatim

nominatim.openstreetmap.org → osm.mygeocode.com

La instancia pública de Nominatim pide como máximo una solicitud por segundo y nada de uso intensivo.

Endpoints y formato de respuesta

OpenCage

api.opencagedata.com → opencage.mygeocode.com

OpenCage usa un solo endpoint para la geocodificación directa e inversa y devuelve un bloque de anotaciones muy completo.

Endpoints y formato de respuesta

LocationIQ

us1.locationiq.com, eu1.locationiq.com → locationiq.mygeocode.com

Los endpoints de búsqueda, inversa, autocompletado y zona horaria de LocationIQ responden en locationiq.mygeocode.com.

Endpoints y formato de respuesta

Geoapify

api.geoapify.com → geoapify.mygeocode.com

Los endpoints de geocodificación de Geoapify devuelven FeatureCollections GeoJSON con un objeto properties plano.

Endpoints y formato de respuesta

TomTom Search

api.tomtom.com → tomtom.mygeocode.com

Los endpoints Geocode, Reverse Geocode y Fuzzy Search de TomTom responden en tomtom.mygeocode.com con la misma estructura de summary y results, incluido el campo freeformAddress que muestran la mayoría de las integraciones.

Endpoints y formato de respuesta

MapQuest Geocoding

www.mapquestapi.com, open.mapquestapi.com → mapquest.mygeocode.com

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.

Endpoints y formato de respuesta

Geocodio

api.geocod.io → geocodio.mygeocode.com

Geocodio se centra en Estados Unidos y Canadá.

Endpoints y formato de respuesta

PositionStack

api.positionstack.com → positionstack.mygeocode.com

Los endpoints directos e inversos de PositionStack responden en positionstack.mygeocode.com con el mismo array data y los mismos nombres de campo planos.

Endpoints y formato de respuesta

ip-api.com

ip-api.com, pro.ip-api.com → ipapi.mygeocode.com

El endpoint JSON de ip-api es uno de los formatos de consulta de IP más copiados.

Endpoints y formato de respuesta

ipinfo.io

ipinfo.io → ipinfo.mygeocode.com

El JSON compacto de ipinfo, con una cadena loc y una cadena org precedida por el número de AS, se reproduce en ipinfo.mygeocode.com.

Endpoints y formato de respuesta

ipstack

api.ipstack.com → ipstack.mygeocode.com

Los endpoints standard lookup y check de ipstack responden en ipstack.mygeocode.com con los mismos campos de nivel superior y el mismo objeto location, por HTTPS en todos los planes.

Endpoints y formato de respuesta

Open-Elevation

api.open-elevation.com → openelevation.mygeocode.com

El servidor público de Open-Elevation es un proyecto voluntario sin garantía de disponibilidad.

Endpoints y formato de respuesta

Bibliotecas de JavaScript

El mismo enfoque funciona con las bibliotecas de mapas y de geocodificación. Carga la Google Maps JavaScript API desde gapi.mygeocode.com y google.maps.Map, Geocoder y places.Autocomplete siguen funcionando con nuestros mapas base y datos, sin coste por carga de mapa. Hay cargadores para el control Bing Maps V8, HERE Maps for JavaScript y MapQuest.js, y configuración para MapLibre y Mapbox GL con mapbox-gl-geocoder, y para los plugins de geocodificación de Leaflet.

Reemplazos compatibles de JavaScript Referencia completa y lista de comprobación de migración

Qué es igual y qué no

Igual

  • Las rutas, los parámetros de consulta y los métodos HTTP documentados por el proveedor.
  • La estructura de la respuesta: nombres de campo, anidamiento, arrays, tipos y orden de las coordenadas.
  • Los vocabularios de estado, por ejemplo OK y ZERO_RESULTS de Google o statusCode de Bing.
  • La forma de los errores, para que tu gestión de errores actual siga funcionando.
  • Los precios. Una solicitud a un host compatible cuesta lo mismo que una solicitud a nuestro propio endpoint y consume la misma cuota de la clave.

Diferente

  • Los datos. Las coordenadas, las direcciones formateadas y los valores de confianza son nuestros, así que no coincidirán dígito por dígito con los del proveedor original.
  • Los identificadores. Los ID de lugar son nuestros y son estables, pero no se pueden pasar al proveedor original.
  • Las funciones ajenas a la geocodificación, la IP, la zona horaria y la elevación, como el cálculo de rutas, los detalles de lugares y las fotos, no están incluidas. Cada página indica lo que falta.
  • Las claves. Una clave de pago por uso funciona desde dos direcciones IP en un periodo móvil de 24 horas y una clave Unlimited desde tres, igual que en nuestros propios endpoints. Usa más claves o paquetes para flotas más grandes.

¿Tu proveedor no aparece?

Añadir un host compatible lleva unos pocos días de trabajo cuando el formato del proveedor está documentado. Si usas un servicio que no aparece aquí, dinos cuál y cuántas solicitudes al día envías, más o menos.