Migration

Quitter les cartes statiques et les tuiles Mapbox pour un usage limité au géocodage

Mapbox est souvent adopté comme un ensemble : géocodage, images de carte statiques, tuiles vectorielles et bibliothèque de rendu Mapbox GL, le tout sous un seul jeton d'accès et un seul compte. Ce regroupement a du sens quand un projet a besoin d'une pile cartographique complète, mais il complique une migration plus ciblée, car une équipe qui veut seulement changer de fournisseur de géocodage peut constater que l'appel de géocodage et le code de rendu de carte partagent la configuration, les jetons, voire la même fonction d'encapsulation des requêtes.

La première vraie étape de ce type de migration n'est pas technique, c'est la définition du périmètre. Décider explicitement que les tuiles de carte et les images de carte statiques restent chez Mapbox tandis que seul l'appel de géocodage part ailleurs évite un écueil courant : commencer une migration avec une frontière floue et finir par modifier à moitié du code qui touche aux deux aspects à la fois.

My Geocode est une API de géocodage, d'IP, de fuseau horaire, d'altitude et de recherche de code postal. Elle ne génère ni tuiles de carte ni images de carte statiques : elle ne remplace donc pas cette partie d'une intégration Mapbox, seulement la partie recherche d'adresses. Son hôte de compatibilité Mapbox reproduit la structure GeoJSON FeatureCollection renvoyée par Mapbox Geocoding, y compris les champs center, place_name et context, les textes de copyright, de conditions et de confidentialité étant la seule différence. Les détails de référence se trouvent sur /compatibility/mapbox/.

Étapes pratiques de séparation :

  • Repérez chaque endroit du code où un jeton d'accès Mapbox est lu, et déterminez si ce point d'appel précis effectue du géocodage, du rendu de tuiles ou les deux, car certaines fonctions d'encapsulation combinent historiquement la recherche d'adresse et un aperçu de carte en un seul appel
  • Faites passer les appels propres au géocodage sur une clé distincte et un hôte distinct, tout en laissant les appels de tuiles et de cartes statiques pointer vers Mapbox avec leur jeton existant inchangé
  • Vérifiez que le composant de carte front-end ne suppose pas que le résultat de géocodage et les tuiles de carte proviennent du même système de référence de coordonnées ou de la même convention de projection ; c'est rarement un problème, mais cela mérite une vérification rapide

L'authentification sur l'hôte de compatibilité de géocodage fonctionne avec une clé via X-API-Key, Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête. Il y a 2 500 requêtes gratuites par jour sans clé, 2 500 autres gratuites par clé et par jour, comptées par réseau, puis du crédit prépayé à 0,0001 € par requête ou une clé Unlimited à 50 € par mois, le même tarif s'appliquant à tous les endpoints, y compris celui-ci.

Faire tourner deux fournisseurs côte à côte, l'un pour le rendu cartographique et l'autre pour la recherche d'adresses, est une configuration stable à long terme et non un état temporaire à éliminer. De nombreuses applications en production répartissent délibérément la cartographie et le géocodage entre différents fournisseurs, car ces deux capacités ont des facteurs de coût et des exigences techniques différents, et rien n'oblige à les regrouper sous un seul compte simplement parce qu'elles ont commencé ainsi.