Reemplazo compatible (drop-in) de HERE Geocoding and Search

HERE reparte su API de búsqueda entre varios hosts. Todos ellos se reducen a here.mygeocode.com, que responde con el mismo array items, el mismo objeto address y el mismo objeto position que leen los clientes de HERE.

Cambia un nombre de host

Host original	`geocode.search.hereapi.com` `revgeocode.search.hereapi.com` `autosuggest.search.hereapi.com` `autocomplete.search.hereapi.com`
Usa en su lugar	`here.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://geocode.search.hereapi.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_HERE_KEY"

Después

curl "https://here.mygeocode.com/v1/geocode?q=Invalidenstra%C3%9Fe+116+Berlin&apiKey=YOUR_MYGEOCODE_KEY"

Por qué se cambia la gente

HERE cobra por transacción con compromisos mensuales. Un solo cambio de nombre de host te lleva a 2.500 llamadas gratuitas al día por dirección, con o sin clave, y a precios fijos o por solicitud a partir de ahí.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a here.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 here.mygeocode.com	Qué hace	Respaldado por
`/v1/geocode?q=...`	Geocode	Geocodificación directa
`/v1/geocode?qq=street=...;city=...`	Geocode con consulta cualificada	Geocodificación directa
`/v1/revgeocode?at=lat,lng`	Geocodificación inversa	Geocodificación inversa
`/v1/autosuggest?q=...&at=lat,lng`	Autosuggest	Autocompletado de direcciones
`/v1/autocomplete?q=...`	Autocompletado	Autocompletado de direcciones

Ejemplo de respuesta

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

Respuesta de here.mygeocode.com

{
  "items": [
    {
      "title": "Invalidenstraße 116, 10115 Berlin, Deutschland",
      "id": "mg.de.addr.9a3f1c77",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Invalidenstraße 116, 10115 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Mitte",
        "street": "Invalidenstraße",
        "postalCode": "10115",
        "houseNumber": "116"
      },
      "position": { "lat": 52.53041, "lng": 13.38527 },
      "access": [ { "lat": 52.53039, "lng": 13.38533 } ],
      "mapView": { "west": 13.38393, "south": 52.52951, "east": 13.38661, "north": 52.53131 },
      "scoring": {
        "queryScore": 1.0,
        "fieldScore": { "city": 1.0, "streets": [1.0], "houseNumber": 1.0, "postalCode": 1.0 }
      }
    }
  ]
}

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 HERE: el parámetro de consulta apiKey (también se acepta apikey) o un token Bearer. 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.

Los errores usan los campos title, status, code, cause y action de HERE, con un id de correlación.
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.