Reemplazo compatible de OpenCage

OpenCage usa un solo endpoint para la geocodificación directa e inversa y devuelve un bloque de anotaciones muy completo. opencage.mygeocode.com hace lo mismo, incluidas las anotaciones de zona horaria, moneda, prefijo telefónico y al estilo what3words que leen los usuarios de OpenCage.

Cambia un nombre de host

Host original	`api.opencagedata.com`
Usa en su lugar	`opencage.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://api.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"

Después

curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"

Por qué se cambia la gente

La misma solicitud, la misma estructura de respuesta y 2.500 solicitudes gratuitas al día por clave, sin obligación de atribución ni cláusula de uso no comercial.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a opencage.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 opencage.mygeocode.com	Qué hace	Respaldado por
`/geocode/v1/json?q=...`	Geocodificación directa	Geocodificación directa
`/geocode/v1/json?q=lat,lng`	Geocodificación inversa	Geocodificación inversa
`/geocode/v1/geojson?q=...`	Salida en GeoJSON	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 OpenCage. Solo los datos que hay detrás son nuestros.

Respuesta de opencage.mygeocode.com

{
  "documentation": "https://www.mygeocode.com/compatibility/opencage/",
  "licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
  "rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
  "results": [
    {
      "annotations": {
        "DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
        "callingcode": 39,
        "currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
        "flag": "🇮🇹",
        "timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
      },
      "bounds": {
        "northeast": { "lat": 41.8905, "lng": 12.4932 },
        "southwest": { "lat": 41.8897, "lng": 12.4914 }
      },
      "components": {
        "ISO_3166-1_alpha-2": "IT",
        "ISO_3166-1_alpha-3": "ITA",
        "_category": "travel/tourism",
        "_type": "attraction",
        "attraction": "Colosseo",
        "city": "Roma",
        "continent": "Europe",
        "country": "Italia",
        "country_code": "it",
        "postcode": "00184",
        "road": "Piazza del Colosseo",
        "state": "Lazio"
      },
      "confidence": 9,
      "formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
      "geometry": { "lat": 41.8902, "lng": 12.4922 }
    }
  ],
  "status": { "code": 200, "message": "OK" },
  "total_results": 1
}

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 OpenCage: 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 bloque rate indica tu cuota gratuita real, lo que queda de ella y cuándo se restablece.
Se sirven tanto el endpoint json como el geojson.
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.