Changez d'hôte, gardez la chaîne de requête.
Des trois migrations, celle-ci est la plus proche par construction : les noms de champs et l'imbrication des réponses suivent les formats documentés de HERE, si bien que la plupart des intégrations migrent sans toucher au code qui lit la réponse.
- Mêmes noms de champs et même imbrication pour le géocodage, le routage, la matrice, les isochrones, le trafic et les lieux
- Flexible polyline par défaut, comme chez HERE
- Quotas gratuits identiques : le palier gratuit ne rétrécit pas au passage
- Chaque tarif exactement la moitié du tarif public que vous payez aujourd'hui
Le changement
L'hôte et l'en-tête d'autorisation. Tout ce qui suit est la table de correspondance.
- https://geocode.search.hereapi.com?apiKey=YOUR_KEY
+ https://api.apinavi.com
+ Authorization: Bearer $APINAVI_KEYTable de correspondance
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= | — |
Là où ce n'est pas un remplacement direct
Types de résultats administratifs
HERE renvoie trois niveaux administratifs ; nous les regroupons en locality et district. Si vous branchez sur resultType, il faut y retirer un cas.
Noms de couches dans les tuiles vectorielles
Nos couches MVT suivent la convention OpenMapTiles plutôt que la nomenclature de HERE. Un style doit renommer ses références de couches : mécanique, mais pas gratuit.
Intérieurs et données HD
Nous ne servons ni cartes d'intérieur ni contenu HD à la voie. Si vous utilisez l'un ou l'autre, cette migration n'est pas pour vous.
Granularité du scoring
queryScore reprend la sémantique 0–1 de HERE, mais fieldScore couvre moins de composantes. Les seuils se transposent en général ; les filtres par composante peuvent demander un réglage.
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