Dix-sept hôtes compatibles, c'est beaucoup à suivre au fil des annonces ; nous les avons donc tous réunis en un seul endroit : une matrice de compatibilité sur /compatibility/ qui liste côte à côte chaque hôte compatible que nous prenons en charge, avec un lien direct vers la documentation de chacun.
La liste couvre Google Maps Platform, Bing Maps REST Services, HERE Geocoding and Search, Mapbox Geocoding, Geocode.Farm, OpenStreetMap Nominatim, OpenCage, LocationIQ, Geoapify, TomTom Search, MapQuest Geocoding, Geocodio, PositionStack, ip-api.com, ipinfo.io, ipstack et Open-Elevation. Ensemble, ils couvrent le géocodage, la géolocalisation IP et les recherches d'altitude, en reproduisant exactement le format de requête et de réponse de chaque fournisseur d'origine, à l'exception des mentions de copyright, des conditions et des textes de confidentialité, qui sont les nôtres.
Les réunir sur une seule page n'est pas qu'une question d'ordre. Une équipe qui se demande quel fournisseur quitter peut ainsi voir l'ensemble d'un coup d'œil, plutôt que de découvrir les hôtes compatibles un par un au fil d'annonces séparées. Si votre stack utilise plusieurs de ces fournisseurs, par exemple Mapbox pour le géocodage et ipinfo.io pour les recherches d'IP, ou toute autre combinaison, la matrice montre clairement qu'ils peuvent tous être regroupés derrière un seul compte My Geocode et une seule clé.
Ce regroupement est le véritable avantage de l'approche par compatibilité en général. Une seule clé s'authentifie auprès de chaque hôte de la liste, avec celle de nos quatre méthodes standard que votre intégration utilise déjà : un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic ou un paramètre de requête. L'utilisation de tous ces hôtes est décomptée sur le même quota gratuit, le même solde de crédit prépayé ou le même forfait Unlimited, et chaque réponse, quel que soit l'hôte qui l'a produite, comporte les mêmes en-têtes de quota. Un compte, une clé, une facture, quel que soit le nombre de fournisseurs distincts dont votre intégration dépendait.
Pour les équipes qui envisagent une migration plus large que le remplacement d'un seul fournisseur, cette matrice est le point de départ naturel, et des conseils généraux de migration l'accompagnent sur /docs/compatibility/. La page de documentation de chaque hôte détaille les paramètres de requête spécifiques et tout ce qu'il est utile de savoir avant de basculer.
Nous prévoyons de tenir cette page à jour au fil de l'évolution de la compatibilité, afin qu'elle reste la référence unique de ce qui est disponible plutôt qu'un document qui se périme entre deux annonces.