Couverture géographique et fraîcheur des données

Couverture

geocodeme.net est construit sur les données OpenStreetMap, servies par nos propres moteurs de géocodage et de routage.

Le jeu de données de production couvre l'Europe et les cinq DROM : Guadeloupe, Martinique, Guyane, Mayotte et La Réunion.

L'Europe est servie par une seule instance continentale, construite à partir de l'extrait officiel Geofabrik europe. Les cinq DROM ne font pas partie de cet extrait (le découpage Geofabrik est géographique) : chacun conserve donc son instance dédiée. Un registre de régions route chaque requête vers le bon moteur ; vous n'avez jamais à en choisir un.

Cela vaut pour tous les endpoints :

Endpoint	Couverture
/v1/geocode	Adresses et lieux dans toutes les régions couvertes
/v1/reverse	Coordonnées dans toutes les régions couvertes, DROM inclus
/v1/autocomplete	Recherche à la frappe dans toutes les régions couvertes
/v1/route	Graphe routier couvrant l'Europe et les cinq DROM
/v1/isochrone	Même graphe routier que /v1/route
/v1/matrix	Même graphe routier que /v1/route
/v1/elevation	Altitude du terrain pour toutes les régions couvertes
/v1/match	Réseau routier dans toutes les régions couvertes
/v1/nearest	Réseau routier dans toutes les régions couvertes
/v1/batch/geocode	Même jeu de données que /v1/geocode
Tuiles de carte (raster et vectorielles)	Rendues à partir de l'extrait européen ; voir Tuiles de carte

Le routage repose sur le moteur Valhalla avec les profils car, bike, foot, truck et moto. Un seul graphe couvre l'Europe et les cinq DROM : un itinéraire à Lisbonne et un itinéraire à Cayenne passent par le même endpoint.

Les requêtes portant sur des adresses hors de la zone couverte retournent un résultat vide (results: [] ou result: null), pas une erreur.

Filtrer par pays

/v1/geocode accepte dans countrycodes une liste de codes pays ISO 3166-1 alpha-2 séparés par des virgules. Les codes des pays européens couverts (de, es, it, pt, pl…) sont honorés nativement par l'instance continentale ; les codes hors zone couverte ne renvoient tout simplement aucun résultat. Un code pays peut être combiné à un alias de région pour restreindre davantage tout en interrogeant moins d'instances ; voir Alias de région et filtres pays.

Filtrer par territoire d'outre-mer

Dans OpenStreetMap, les DROM portent le code pays fr, comme la métropole. Sur /v1/geocode, fr désigne donc toute la donnée française : la métropole et les cinq DROM. Par commodité, /v1/geocode et /v1/autocomplete acceptent aussi des alias de région dans countrycodes : gp (Guadeloupe), mq (Martinique), gf (Guyane), yt (Mayotte) et re (La Réunion) restreignent la recherche à une seule île, et eu la restreint au seul index continental. Les alias sont résolus côté serveur ; les résultats continuent d'indiquer fr comme code pays pour les DROM.

Sur /v1/autocomplete, le paramètre fonctionne différemment : le moteur de suggestions n'a pas de filtre pays transmissible, countrycodes y choisit seulement quelles instances régionales sont interrogées. Les cinq alias d'outre-mer restreignent la recherche à une seule île. fr sélectionne toutes les régions (toute la zone couverte, Europe continentale comprise), exactement comme si le paramètre était absent : il ne restreint donc pas les résultats à la donnée française. Tout autre code (de, es…) ne correspond à aucune instance et ne renvoie aucune suggestion ; filtrez plutôt côté client sur address.country_code. Quelle région passe en tête de la liste fusionnée est décidé par les règles décrites dans Ordre des résultats ; envoyez un biais lat/lon et la région la plus proche mène.

Couverture dégradée

Chaque région tournant sur sa propre instance, une panne dans une région ne met jamais l'API hors service. Si une région est temporairement indisponible, l'API continue de répondre avec les résultats des régions saines et ajoute le header de réponse X-Coverage-Degraded: <régions> listant les régions qui ont réellement échoué : une réponse honnête, partielle, plutôt qu'une erreur 5xx globale.

Ce header ne signale que des pannes. Une région qui n'a pas été interrogée, ou qui a été écartée parce que le budget de temps de la requête a expiré, n'y figure pas : rien n'y est cassé. Voir Couverture dégradée pour savoir quoi en faire dans un champ de recherche.

Besoin d'une région que nous ne couvrons pas encore ?

L'Europe et les DROM constituent le jeu de données de lancement. Les autres continents suivent la même recette (un extrait, une instance, une entrée dans le registre de régions) et sont déployés région par région. Contactez-nous et dites-nous quelles régions il vous faut : la demande détermine directement l'ordre de déploiement.

Toutes les données sont traitées et servies depuis une infrastructure hébergée en France.

Fraîcheur des données

• Le jeu de données de géocodage est importé depuis les extraits officiels Geofabrik (l'extrait européen plus un par DROM) et maintenu à jour via le flux de réplication Geofabrik, en continu et région par région ; les contributions de la communauté à OpenStreetMap arrivent sur geocodeme.net au fil de l'application des mises à jour, généralement en quelques jours plutôt qu'en quelques mois.
• Le graphe routier et les tuiles de carte sont reconstruits périodiquement (au rythme mensuel) à partir des mêmes extraits.
• Les réponses de géocodage sont de plus mises en cache dans Redis pour accélérer les recherches répétées ; voir le champ meta.cache_hit dans les réponses.

Si vous constatez des données manquantes ou obsolètes, la meilleure correction profite à tous : contribuez la correction à OpenStreetMap, elle sera prise en compte au prochain rafraîchissement.

Voir aussi

• Licence et attribution : vos obligations lors de l'affichage de résultats dérivés d'OSM
• FAQ : questions courantes sur les quotas, le SLA et les données