Reemplazo compatible de LocationIQ

Los endpoints de búsqueda, inversa, autocompletado y zona horaria de LocationIQ responden en locationiq.mygeocode.com. El array JSON al estilo de Nominatim con display_name, address y boundingbox se devuelve con la misma estructura.

Cambia un nombre de host

Host original	`us1.locationiq.com` `eu1.locationiq.com`
Usa en su lugar	`locationiq.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://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"

Después

curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"

Por qué se cambia la gente

La misma interfaz, 2.500 solicitudes gratuitas al día por clave y una clave Unlimited de tarifa fija para aplicaciones con mucho tráfico.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a locationiq.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 locationiq.mygeocode.com	Qué hace	Respaldado por
`/v1/search?q=...&format=json`	Geocodificación directa	Geocodificación directa
`/v1/reverse?lat=...&lon=...&format=json`	Geocodificación inversa	Geocodificación inversa
`/v1/autocomplete?q=...`	Autocompletado	Autocompletado de direcciones
`/v1/timezone?lat=...&lon=...`	Zona horaria	Consulta de zona horaria

Ejemplo de respuesta

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

Respuesta de locationiq.mygeocode.com

[
  {
    "place_id": "mg.au.poi.3b7e91c0",
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 4245932,
    "boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
    "lat": "-33.8567844",
    "lon": "151.2152967",
    "display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
    "class": "tourism",
    "type": "attraction",
    "importance": 0.8543,
    "icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
    "address": {
      "name": "Sydney Opera House",
      "road": "Bennelong Point",
      "suburb": "Sydney",
      "city": "Sydney",
      "state": "New South Wales",
      "postcode": "2000",
      "country": "Australia",
      "country_code": "au"
    }
  }
]

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 LocationIQ: 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.

El endpoint de zona horaria está activo y devuelve el nombre, el desfase, el indicador de horario de verano y ambos nombres.
No hay endpoint por lotes, porque el original no lo tiene. Para trabajos masivos, usa POST /v1/forward o /v1/reverse en api.mygeocode.com (hasta 100 por llamada, una solicitud cada una).

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.