Présentation #

L’API de calcul d’itinéraire de la Géoplateforme permet d’obtenir un itinéraire entre deux points selon un profil de parcours particulier.

Son usage est limité à 5 requêtes par seconde depuis une même adresse IP.

Le calcul peut être paramétré, en fonction du besoin, selon plusieurs options détaillées :

• la méthode de calcul : chemin le plus court ou le plus rapide
• le type de véhicule : piéton ou voiture
• l’expression de contraintes d’exclusion à prendre en compte pour le calcul de l’itinéraire
• l’ajout d’étapes intermédiaires.

Les données de référence utilisées au sein du service de calcul d’itinéraire proviennent du réseau routier et des tables de non communications de la base de données BD TOPO® de l’IGN.

L’API est interrogeable en méthodes GET et POST.

Son swagger est accessible ici : swagger du calcul d’itinéraire.

Capacités de l’API (getCapabilities) #

La requête getCapabilities permet de découvrir les capacités de l’API : les opérations possibles, les ressources disponibles et les options proposées.

Elle est accessible via l’URL suivante :

https://data.geopf.fr/navigation/getCapabilities

Cette requête ne requiert aucun paramètre.

Calculer un itinéraire #

Le calcul d’itinéraire est accessible via l’URL suivante :

https://data.geopf.fr/navigation/itineraire

Les paramètres également précisés dans le swagger du calcul d’itinéraire sont les suivants :

Calculer un itinéraire via la méthode GET #

• Paramètres obligatoires :
  • resource
    • bdtopo-osrm : les calculs sont effectués avec le moteur « OSRM », il permet des performances de calcul élevées mais présente un choix limité dans le paramétrage des requêtes notamment pour l’expression des contraintes.
    • bdtopo-valhalla : les calculs sont effectués avec le moteur « Valhalla », il présente les mêmes avantages et inconvénients qu’OSRM, mais avec des performances un peu moindres. Nous vous conseillons de plutôt utiliser les ressources OSRM.
    • bdtopo-pgr : les calculs sont effectués avec le moteur « pgRouting », il permet un plus grand choix dans le paramétrage des requêtes notamment pour l’expression des contraintes et pour la récupération d’attributs issus de la BD TOPO®. Cependant, les performances de calcul de ce moteur sont très inférieures à celles d’OSRM et Valhalla, nous vous conseillons donc de choisir de manière préférentielle OSRM, et de n’opter pour pgRouting que si vous avez des besoins précis concernant les contraintes de calcul et/ou les attributs récupérés.
  • start
    • Point de départ exprimé dans le CRS, par défaut, de la ressource (EPSG:4326) (exemple : 2.337306,48.849319).
  • end
    • Point d’arrivée exprimé dans le CRS, par défaut, de la ressource (EPSG:4326) (exemple : 2.367776,48.852891).
• Paramètres facultatifs :
  • intermediates
    • Points intermédiaires sur votre itinéraire.
  • profile
    • Moyen de déplacement utilisé pour le calcul.
    • Valeurs possibles : celles listées dans le getCapabilities (car, pedestrian...)
  • optimization
    • Mode de calcul utilisé pour déterminer l’itinéraire.
    • Valeurs possibles : celles listées dans le getCapabilities (fastest, shortest)
  • geometryFormat
    • Format des géométries dans la réponse.
    • Valeurs possibles :celles listées dans le getCapabilities (geojson, polyline)
  • constraints
    • Contraintes utilisées pour le calcul.
    • Valeurs possibles : celles listées dans le getCapabilities (exemple : "banned", "key":"wayType","operator":"=","value":"tunnel")
  • getSteps
    • Présence des étapes dans la réponse.
    • Valeurs possibles : true, false
  • getBbox
    • Présence de l’emprise de l’itinéraire dans la réponse.
    • Valeurs possibles : true, false
  • distanceUnit
    • Unité de distance renvoyée.
    • Valeurs possibles : celles listées dans le getCapabilities (kilometer, meter)
  • timeUnit
    • Unité du temps renvoyé.
    • Valeurs possibles : celles listées dans le getCapabilities (hour, minute, second...)
  • crs
    • Projection des géométries.
    • Valeurs possibles : celles listées dans le getCapabilities (EPSG:4326...)
  • waysAttributes
    • Attributs des tronçons à afficher dans la réponse.
    • Valeurs possibles : celles listées dans le getCapabilities (name...)

Exemple de requête :

https://data.geopf.fr/navigation/itineraire?resource=bdtopo-osrm&start=2.337306,48.849319&end=2.367776,48.852891&profile=car&optimization=fastest&constraints=%7B%22constraintType%22:%22banned%22,%22key%22:%22wayType%22,%22operator%22:%22=%22,%22value%22:%22autoroute%22%7D&getSteps=true&getBbox=true&distanceUnit=kilometer&timeUnit=hour&crs=EPSG:4326

Calculer un itinéraire via la méthode POST #

En utilisant la méthode POST, il est nécessaire de fournir en entrée un "body" sous la forme d’un objet JSON.

Exemple d’appel :

curl -X 'POST' \
  'https://data.geopf.fr/navigation/itineraire' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "start": "2.337306,48.849319",
  "end": "2.367776,48.852891",
  "resource": "bdtopo-osrm",
  "profile": "car"
}'

Caractéristiques des règles de calcul pour les itinéraires #

Les données de navigation sont issues de la BD TOPO® (réseau routier et table de non communications).

Le graphe est dérivé de la BD TOPO®, apparié sur la BD CARTO® pour certains éléments. Il est disponible sur la France entière, Départements et Régions d’Outre-Mer inclus. Il est régulièrement mis à jour, sa date d’actualité est renseignée par le champ « resourceVersion » dans la réponse du service.

Vitesse voiture #

Le nouveau mode de calcul des vitesses (septembre 2023) s’inspire très largement de l’algorithme élaboré par le SDIS44. Il est décomposé en deux étapes :

le calcul de vitesses brutes en fonction des attributs propres à l’objet Tronçon de route (nature, importance, urbain…), ensuite, pour une partie d’entre eux, des pénalités liées au réseau ou à l’environnement (bâti, sinuosité…) sont appliquées.

*les vitesses brutes sont ensuite diminuées par une pénalité liée à la longueur et à la sinuosité du tronçon, à la densité du bâti environnant, ainsi qu’à la proximité d’écoles.

Calcul des pénalités #

Préalable : calcul des zones de densité de bâtiments

Une carte de chaleur est calculée à partir de la classe Bâtiment. Les objets sélectionnés sont :

• ‘Construction légère’ = faux ou null,
• ‘Etat de l’objet’ = « En service »,
• Surface comprise entre 35 et 2000 m².

Le centroïde de chaque objet est ensuite pondéré par la hauteur du bâti (en cas de hauteur nulle, la valeur de 6 m est prise). À partir de cette carte, 3 intervalles de valeurs sont surfacifiés : « zone habitée », « centre dense » et « hyper-centre ». Cette donnée de contexte est mise à jour annuellement.

La vitesse brute est diminuée de cette pénalité : vitesse moyenne = vitesse brute * (1 - pénalité).

La valeur est enfin arrondie à 5 km/h supérieur pour les objets d’importance 1 à 4, et à 5 km/h inférieur pour les objets d’importance 5.

Calcul des pénalités cumulées

Les pénalités sont ensuite additionnées, avec toutefois un plafond de 80%.

La vitesse brute est diminuée de cette somme des pénalités (vitesse moyenne = vitesse brute * (1 - somme des pénalités)).

La valeur est enfin arrondie à 5 km/h supérieur pour les objets d’importance 1 à 4 et à 5 km/h inférieur pour les objets d’importance 5 ou 6.

Contrainte sur l’attribut : Valeur obligatoire (calculée).

Vitesse piéton #

Pour les piétons, les calculs sont basés sur les critères suivants :

• NATURE = ‘Autoroute’ & IMPORTANCE = ‘1’ 0 km/h
• NATURE = ‘Autoroute’ & IMPORTANCE = ‘2’ 0 km/h
• NATURE = ‘Autoroute’ & IMPORTANCE = ‘3’ 0 km/h
• Autres axes 4 km/h