Cambia el host, conserva la cadena de consulta.
De las tres migraciones esta es, por diseño, la más cercana: los nombres de campo y el anidamiento de las respuestas siguen los formatos documentados de HERE, así que la mayoría de integraciones se mudan sin tocar el código que lee la respuesta.
- Mismos nombres de campo y anidamiento en geocodificación, rutas, matriz, isócronas, tráfico y lugares
- Flexible polyline por defecto, como en HERE
- Límites gratuitos idénticos: el nivel gratuito no encoge al mudarse
- Cada tarifa exactamente la mitad del precio de lista que pagas hoy
El cambio
Host y cabecera de autorización. Todo lo de abajo es el mapa de parámetros.
- https://geocode.search.hereapi.com?apiKey=YOUR_KEY
+ https://api.apinavi.com
+ Authorization: Bearer $APINAVI_KEYMapa de parámetros
Geocoding & search
| HERE | ApiNavi | Note |
|---|---|---|
| GET /v1/geocode?q= | GET /v1/geocode?q= | Identical. Response fields keep their names. |
| GET /v1/revgeocode?at= | GET /v1/revgeocode?at= | — |
| GET /v1/autosuggest?q=&at= | GET /v1/autosuggest?q=&at= | — |
| in=countryCode:DEU | in=countryCode:DEU | — |
| items[].scoring.queryScore | items[].scoring.queryScore | Same 0–1 range; our field scores cover fewer components. |
| items[].resultType=administrativeArea | items[].resultType=locality | We collapse three administrative levels into locality and district. |
Routing
| HERE | ApiNavi | Note |
|---|---|---|
| GET /v8/routes?transportMode= | GET /v1/routes?transportMode= | Version segment differs; parameters do not. |
| return=polyline,summary | return=polyline,summary | — |
| vehicle[grossWeight] | vehicle[grossWeight] | — |
| POST /v8/matrix | POST /v1/matrix | Synchronous up to 500×500; larger jobs return a job id. |
| GET /v8/isolines | GET /v1/isolines | — |
| spans=speedLimit,truckRestriction | spans=speedLimit,truckRestriction | — |
Maps & traffic
| HERE | ApiNavi | Note |
|---|---|---|
| maps.hereapi.com/v3/base/mc/{z}/{x}/{y}/png8 | /v1/tiles/raster/{z}/{x}/{y}.png | — |
| vector/mc/{z}/{x}/{y}/omv | /v1/tiles/vector/{z}/{x}/{y}.mvt | Layer names follow the OpenMapTiles convention rather than HERE's. |
| GET /v7/flow?in=bbox: | GET /v1/traffic/flow?in=bbox: | — |
| GET /v7/incidents?in= | GET /v1/traffic/incidents?in= | — |
Dónde no es un cambio directo
Tipos de resultado administrativos
HERE devuelve tres niveles administrativos; nosotros los agrupamos en locality y district. Si ramificas por resultType, hay que quitar un caso.
Nombres de capa en teselas vectoriales
Nuestras capas MVT siguen la convención de OpenMapTiles y no la nomenclatura de HERE. Un estilo necesita renombrar sus referencias de capa: mecánico, pero no gratis.
Interiores y datos HD
No servimos mapas de interiores ni contenido HD a nivel de carril. Si usas alguno de los dos, esta migración no te conviene.
Granularidad del scoring
queryScore mantiene la semántica 0–1 de HERE, pero fieldScore cubre menos componentes. Los umbrales suelen transferirse; los filtros por componente pueden necesitar reajuste.
Cómo suelen hacerlo los equipos
- 01
Sombra
Envía una copia del tráfico de producción a ambos durante una semana. Nada cambia para el usuario.
- 02
Comparación
Compara campo a campo en los endpoints que usas de verdad. La mayoría encuentra dos o tres diferencias reales, no veinte.
- 03
Reparto
Mueve un 5 %, luego un 50 %, vigilando la tasa de error y la latencia por región.
- 04
Corte
Mueve el resto, deja la clave antigua viva dos semanas y después rótala.
Modo de doble ejecución
Apunta un porcentaje del tráfico a los dos proveedores y compara las respuestas. La consola muestra la tasa de discrepancia por campo y endpoint, de modo que el cambio se decide con datos y no con una comprobación puntual.
Marcharse más adelante
Las mismas tablas se leen al revés, y un endpoint de exportación devuelve tus geocercas, estilos y resultados de lotes en formatos abiertos. Una guía de migración que solo apunta hacia dentro es una señal de alarma, no una función.
Lista de comprobación del cambio
- Límites de tasa subidos en la clave nueva antes del reparto, no después
- Tope de gasto fijado para el primer mes completo
- Identificadores de lugar guardados vueltos a resolver, si los almacenas
- Decodificador de polilínea comprobado con una ruta conocida
- Cobertura revisada para los países de la cola larga de tu tráfico
- Clave antigua rotada y eliminada de los secretos