La misma especificación de teselas, otra factura.
Las teselas vectoriales siguen la misma especificación MVT y el documento de estilo el mismo esquema, así que la parte de renderizado se muda con un renombrado. Las respuestas de búsqueda y direcciones difieren más que las teselas.
- Compatible con MVT y con la especificación de estilo: tu renderizador se queda
- Isochrone se corresponde directamente con las isócronas, incluidos los rangos por consumo
- Perfiles de camión incluidos en lugar de en un nivel de producto aparte
- Tarifas publicadas en lugar de paquetes de cargas de mapa por nivel
El cambio
Host y cabecera de autorización. Todo lo de abajo es el mapa de parámetros.
- https://api.mapbox.com?access_token=YOUR_TOKEN
+ https://api.apinavi.com
+ Authorization: Bearer $APINAVI_KEYMapa de parámetros
Search & navigation
| Mapbox | ApiNavi | Note |
|---|---|---|
| GET /geocoding/v5/mapbox.places/{q}.json | GET /v1/geocode?q= | — |
| GET /search/geocode/v6/reverse | GET /v1/revgeocode?at= | — |
| features[].place_name | items[].address.label | — |
| features[].center [lng,lat] | items[].position {lat,lng} | Axis order differs: GeoJSON positions are lng-first, our object is keyed. |
| GET /directions/v5/mapbox/driving | GET /v1/routes?transportMode=car | — |
| GET /directions-matrix/v1 | POST /v1/matrix | — |
| GET /isochrone/v1 | GET /v1/isolines | — |
Tiles & styles
| Mapbox | ApiNavi | Note |
|---|---|---|
| GET /v4/{tileset}/{z}/{x}/{y}.mvt | GET /v1/tiles/vector/{z}/{x}/{y}.mvt | — |
| GET /styles/v1/{user}/{style} | GET /v1/styles/{style} | Style JSON follows the same spec; layer ids differ. |
| GET /styles/v1/.../static/ | GET /v1/static | — |
Dónde no es un cambio directo
Orden de ejes
Mapbox devuelve center como [lng, lat]. Nuestra position es un objeto con claves lat y lng, lo que elimina la ambigüedad pero requiere un pequeño adaptador.
Identificadores de capa de estilo
Ambos siguen la especificación de estilo, pero los identificadores de capa difieren. Una bifurcación de un estilo de Mapbox necesita reasignar identificadores; las equivalencias están en la documentación.
Identificadores de elemento
Los identificadores de Mapbox no son estables entre actualizaciones de datos ni intercambiables con los nuestros. Vuelve a resolver las referencias guardadas.
SDK de navegación en cliente
Entregamos APIs de rutas, no un SDK de navegación paso a paso con voz. Esa capa se queda contigo o con ellos.
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