Migrer depuis l’API Google Geocoding en une ligne
Addrova propose un point d’accès compatible Google. Dans la plupart des cas, vous changez l’URL de base et la clé, et gardez le reste de votre code.
Avant et après
L’URL de production https://api.addrova.eu n’est pas encore en ligne ; le chemin ci-dessous vient de la spécification de l’API.
https://maps.googleapis.com/maps/api/geocode/json
?address=10+rue+de+Rivoli+Paris
&key=CLE_GOOGLEhttps://api.addrova.eu/compat/google/maps/api/geocode/json
?address=10+rue+de+Rivoli+Paris
&key=CLE_ADDROVASeul le format des requêtes et des réponses est émulé. Aucune donnée Google n’est utilisée.
Ce qui est pris en charge
| Élément | Prise en charge |
|---|---|
| address | Géocodage direct |
| latlng | Géocodage inverse (`lat,lng`) |
| components | Seul `country:XX` est pris en compte |
| language, region | Acceptés |
| Réponse | status, results avec formatted_address, place_id, types, partial_match, address_components et geometry (location, location_type, viewport) |
| Erreurs | Au format Google : un champ `status` avec HTTP 200, pour que les clients existants continuent de fonctionner |
| Complément Addrova | Un tableau `attribution`, ignoré par les clients existants ; affichez-le à côté des résultats |
La valeur de place_id est un identifiant Addrova, pas un place ID Google : ne mélangez pas les deux.
Liste de contrôle de migration
- Remplacer l’URL de base, le préfixe de chemin et la clé d’API.
- Passer un échantillon de vos propres adresses dans les deux services et comparer les résultats.
- Afficher l’attribution à côté des résultats, comme l’exigent les licences des données.
- Une fois validé, stocker les coordonnées dans votre base. Aucune expiration ne s’applique.
Pourquoi le stockage compte
Les conditions de Google limitent la durée de mise en cache de la latitude et de la longitude, et seuls les identifiants de lieu peuvent être conservés sans limite (voir les conditions de Google Maps Platform et les politiques de l’API Geocoding). Si vous devez conserver des coordonnées, vérifiez les conditions en vigueur pour votre cas. Addrova autorise le stockage permanent.