Compatibilité : Google et Nominatim
Changez l’URL de base et gardez votre code client. Cette page liste ce qui est pris en charge, d’après la spécification de l’API (OpenAPI 1.0.0).
Mode Google Geocoding
| Élément | Prise en charge |
|---|---|
| Chemin | /compat/google/maps/api/geocode/json |
| Géocodage direct | `address` (512 caractères au plus) |
| Géocodage inverse | `latlng`, sous la forme `lat,lng` |
| Filtres | `components` : seul `country:XX` est pris en compte ; `language` et `region` acceptés |
| Champs de réponse | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Erreurs | `status` au format Google (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Place IDs | Présents dans la forme ; les valeurs sont des identifiants Addrova |
| Complément Addrova | Tableau `attribution` des sources et licences |
Mode Nominatim
| Élément | Prise en charge |
|---|---|
| Recherche | /compat/nominatim/search avec `q`, `format` (json ou jsonv2, jsonv2 par défaut), `limit` (1 à 40, 10 par défaut), `countrycodes` (codes ISO séparés par des virgules), `addressdetails` (0 ou 1, 0 par défaut) |
| Inverse | /compat/nominatim/reverse avec `lat`, `lon`, `format`, `addressdetails` (1 par défaut) |
| Champs de réponse | place_id, licence, lat, lon, display_name, category (jsonv2) ou class (json), type, importance, address, boundingbox |
| Inverse sans résultat | {"error": "Unable to geocode"} |
| Hors périmètre | Tuiles cartographiques, recherche d’objets OSM |
Authentification sur les routes de compatibilité
| Méthode | Comment |
|---|---|
| Paramètre de requête | `key=CLE_ADDROVA`, accepté uniquement sur les routes /compat, pour rester compatible. Il n’est jamais journalisé. |
| En-tête | `X-API-Key`, ou la clé comme jeton bearer |