La même spécification de tuiles, une autre facture.
Les tuiles vectorielles suivent la même spécification MVT et le document de style le même schéma : la partie rendu migre avec un renommage. Les réponses de recherche et de directions diffèrent davantage que les tuiles.
- Compatible MVT et spécification de style : votre moteur de rendu reste
- Isochrone se transpose directement sur les isochrones, y compris les plages de consommation
- Profils poids lourds inclus plutôt que dans un palier de produit séparé
- Des tarifs publiés plutôt que des forfaits de chargements de carte par palier
Le changement
L'hôte et l'en-tête d'autorisation. Tout ce qui suit est la table de correspondance.
- https://api.mapbox.com?access_token=YOUR_TOKEN
+ https://api.apinavi.com
+ Authorization: Bearer $APINAVI_KEYTable de correspondance
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 | — |
Là où ce n'est pas un remplacement direct
Ordre des axes
Mapbox renvoie center sous la forme [lng, lat]. Notre position est un objet avec les clés lat et lng, ce qui lève l'ambiguïté mais demande un petit adaptateur.
Identifiants de couches de style
Les deux suivent la spécification de style, mais les identifiants de couches diffèrent. Un fork d'un style Mapbox doit remapper ses identifiants ; les équivalences sont dans la documentation.
Identifiants d'objets
Les identifiants d'objets Mapbox ne sont pas stables d'une mise à jour à l'autre et ne sont pas interchangeables avec les nôtres. Résolvez à nouveau les références enregistrées.
SDK de navigation côté client
Nous livrons des API de routage, pas un SDK de navigation pas à pas avec guidage vocal. Cette couche reste chez vous ou chez eux.
Comment les équipes s'y prennent
- 01
Ombre
Pendant une semaine, envoyez une copie du trafic de production aux deux. Rien ne change pour l'utilisateur.
- 02
Comparaison
Comparez champ par champ sur les points d'entrée que vous utilisez vraiment. La plupart des équipes trouvent deux ou trois écarts réels, pas vingt.
- 03
Répartition
Basculez 5 %, puis 50 %, en surveillant le taux d'erreur et la latence par région.
- 04
Bascule
Basculez le reste, gardez l'ancienne clé active une quinzaine de jours, puis renouvelez-la.
Mode double exécution
Envoyez un pourcentage du trafic aux deux fournisseurs et comparez les réponses. La console montre le taux de divergence champ par champ et point d'entrée par point d'entrée : la bascule se décide sur des données, pas sur un sondage.
Repartir plus tard
Les mêmes tables se lisent à l'envers, et un point d'entrée d'export renvoie vos zones, vos styles et vos résultats de lots dans des formats ouverts. Un guide de migration qui ne regarde que vers l'intérieur est un signal d'alerte, pas une fonctionnalité.
Liste de contrôle de bascule
- Limites de débit relevées sur la nouvelle clé avant la répartition, pas après
- Plafond de dépense fixé pour le premier mois complet
- Identifiants de lieux enregistrés résolus à nouveau, si vous en stockez
- Décodeur de polyligne vérifié sur un itinéraire connu
- Couverture vérifiée pour les pays de la longue traîne de votre trafic
- Ancienne clé renouvelée et retirée des secrets