Reemplazo compatible (drop-in) de Geocodio

Geocodio se centra en Estados Unidos y Canadá. geocodio.mygeocode.com responde a sus endpoints geocode y reverse con la misma estructura, y acepta direcciones de cualquier parte del mundo.

Cambia un nombre de host

Host original	`api.geocod.io`
Usa en su lugar	`geocodio.mygeocode.com`
Parámetro de la clave	`api_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.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"

Después

curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"

Por qué se cambia la gente

La misma interfaz, cobertura mundial y ningún nivel de precios por consulta que vigilar.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a geocodio.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 geocodio.mygeocode.com	Qué hace	Respaldado por
`/v1.7/geocode?q=...`	Geocodificación directa	Geocodificación directa
`/v1.7/reverse?q=lat,lng`	Geocodificación inversa	Geocodificación inversa
`/v1.7/geocode (POST, JSON array)`	Geocodificación directa 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 Geocodio. Solo los datos que hay detrás son nuestros.

Respuesta de geocodio.mygeocode.com

{
  "input": {
    "address_components": {
      "number": "1109",
      "predirectional": "N",
      "street": "Highland",
      "suffix": "St",
      "formatted_street": "N Highland St",
      "city": "Arlington",
      "state": "VA",
      "country": "US"
    },
    "formatted_address": "1109 N Highland St, Arlington, VA"
  },
  "results": [
    {
      "address_components": {
        "number": "1109",
        "predirectional": "N",
        "street": "Highland",
        "suffix": "St",
        "formatted_street": "N Highland St",
        "city": "Arlington",
        "county": "Arlington County",
        "state": "VA",
        "zip": "22201",
        "country": "US"
      },
      "formatted_address": "1109 N Highland St, Arlington, VA 22201",
      "location": { "lat": 38.886665, "lng": -77.094733 },
      "accuracy": 1,
      "accuracy_type": "rooftop",
      "source": "My Geocode"
    }
  ]
}

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 Geocodio: el parámetro de consulta api_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 solicitudes por lotes funcionan: envía por POST una lista JSON o un objeto. La respuesta es results con una entrada por cada dato de entrada, cada una con la query de la que procede (la clave del objeto cuando enviaste un objeto) y su propia response.
Los lotes inversos tienen la misma estructura, con cadenas lat,lon como entrada.
Un lote acepta hasta 10.000 entradas, como Geocodio, y cada entrada cuenta como una consulta, igual que las cuenta Geocodio. Un lote mayor que lo que queda de la cuota del día se rechaza entero con el error de Geocodio en lugar de procesarse en parte.

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.