Reemplazo compatible (drop-in) de Geoapify

Los endpoints de geocodificación de Geoapify devuelven FeatureCollections GeoJSON con un objeto properties plano. geoapify.mygeocode.com devuelve lo mismo, incluidos los bloques rank y datasource, además de su endpoint de información de IP.

Cambia un nombre de host

Host original	`api.geoapify.com`
Usa en su lugar	`geoapify.mygeocode.com`
Parámetro de la clave	`apiKey` (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.geoapify.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_GEOAPIFY_KEY"

Después

curl "https://geoapify.mygeocode.com/v1/geocode/search?text=Dam+1+Amsterdam&apiKey=YOUR_MYGEOCODE_KEY"

Por qué se cambia la gente

El plan gratuito de Geoapify es de 3.000 créditos al día y exige atribución. Aquí son 2.500 solicitudes al día por clave sin obligación de atribución, y el uso de pago no tiene un nivel mensual que se te quede pequeño.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a geoapify.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 geoapify.mygeocode.com	Qué hace	Respaldado por
`/v1/geocode/search?text=...`	Geocodificación directa	Geocodificación directa
`/v1/geocode/reverse?lat=...&lon=...`	Geocodificación inversa	Geocodificación inversa
`/v1/geocode/autocomplete?text=...`	Autocompletado	Autocompletado de direcciones
`/v1/ipinfo?ip=...`	Geolocalización de IP	Consulta de IPv4

Ejemplo de respuesta

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

Respuesta de geoapify.mygeocode.com

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "datasource": { "sourcename": "mygeocode", "attribution": "My Geocode", "license": "https://www.mygeocode.com/terms/" },
        "country": "Netherlands",
        "country_code": "nl",
        "state": "North Holland",
        "city": "Amsterdam",
        "postcode": "1012 JS",
        "street": "Dam",
        "housenumber": "1",
        "lon": 4.893604,
        "lat": 52.373119,
        "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
        "address_line1": "Dam 1",
        "address_line2": "1012 JS Amsterdam, Netherlands",
        "result_type": "building",
        "rank": { "importance": 0.41, "confidence": 1, "confidence_city_level": 1, "confidence_street_level": 1, "match_type": "full_match" },
        "place_id": "mg.nl.addr.c21d40e8"
      },
      "geometry": { "type": "Point", "coordinates": [4.893604, 52.373119] },
      "bbox": [4.893004, 52.372719, 4.894204, 52.373519]
    }
  ],
  "query": {
    "text": "Dam 1 Amsterdam",
    "parsed": { "housenumber": "1", "street": "dam", "city": "amsterdam", "expected_type": "building" }
  }
}

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 Geoapify: el parámetro de consulta apiKey. 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 respuestas llevan los campos que devuelve Geoapify y nada más, así que una respuesta se puede usar directamente en código que ya analiza Geoapify. Nuestros datos adicionales (elevación del terreno, amenazas y detalles de la red) están disponibles si los pides: añade mg_extras=1 a la consulta o envía X-MG-Extras: 1.

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 endpoint de IP devuelve la misma estructura de objeto que Geoapify.
La geocodificación por lotes funciona como en Geoapify: POST /v1/batch/geocode/search o /reverse con un array JSON de hasta 1.000 elementos responde 202 con un id y una url de trabajo, y un GET a esa url devuelve una fila por elemento con su query. Cada dirección cuenta como una solicitud; la consulta del resultado no cuenta nada.

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.