Skip to content

Latest commit

 

History

History
95 lines (54 loc) · 7.03 KB

readme.md

File metadata and controls

95 lines (54 loc) · 7.03 KB

Road2

Présentation générale

Road2 est un serveur de calcul d'itinéraires et d'isochrones écrit en Javascript et conçu pour fonctionner avec NodeJS. Ce serveur propose le calcul d'itinéraires et d'isochrones via des moteurs existants comme OSRM ou PGRouting. Road2 est donc une interface pour moteurs de calculs. Ces derniers ne sont pas fait dans le code de Road2 mais via des appels à ses moteurs. Cela peut se traduire par l'appel à une librairie, ou à une base de données, ou encore à un autre service web.

Road2 a été conçu dans l'idée de pouvoir facilement ajouter des nouveaux moteurs et de nouvelles APIs, et cela, de manière totalement transparente les uns pour autres. Autrement dit, ajouter un moteur n'a pas d'impact sur les APIs déjà existantes. L'objectif est de faciliter l'ajout de nouvelles fonctionnalités tout en pérennisant l'accès au service. Pour une plus longue discussion sur les concepts logiciels introduits dans Road2, on pourra se référer à la documentation suivante.

Actuellement, Road2 propose trois moteurs, OSRM, PGRouting et Valhalla, via une unique API REST.

Fonctionnalités disponibles

Road2 propose plusieurs grandes familles de fonctionnalités :

  • Calculer des itinéraires
  • Calculer des isochrones et des isodistances
  • Administrer le service
  • etc...

Ces familles regroupent l'ensemble des fonctionnalités et sont détaillées ici.

Licence

Road2 est diffusé sous la licence GPL v3.

Découverte du service

Démonstrateur

L'IGN propose un démonstrateur pour l'itinéraire et l'isochrone. Ces démonstrateurs permettent de construire des requêtes via une carte et de visualiser les résultats.

Autrement, pour une première prise en main du service en local, il est possible d'utiliser l'image alpine de Road2. Cela permettra d'avoir localement une instance du service et une page web permettant de le tester. Les instructions de mise en place sont données ici.

Découvrir et tester les APIs du service

L'IGN propose une visualisation de l'API utilisateur pour l'itinéraire et l'isochrone.

L'IGN propose également des pages pour tester une instance du service sur l'ensemble de la France, avec une visualisation cartographique. Il y a une page pour l'itinéraire et une page pour l'isochrone.

Autrement, l'ensemble des APIs disponibles sont documentées dans ce dossier. Pour le moment, il y a une seule API utilisateur qui est documentée via un fichier JSON utilisant openapi 3.0.0, et une API d'administration documentée via un autre fichier JSON suivant le même formalisme.

Il est possible de visualiser ces documentations d'API localement en suivant les instructions qui sont ici.

Installation et utilisation de Road2

Pré-requis

Pour utiliser ce projet, il est nécessaire d'avoir installé NodeJS sur la machine utilisée. La version de NodeJS utilisée pendant les développements est 12.14.0.

Installation des modules

L'installation des modules est effectuée via NPM. En se plaçant dans la racine du projet:

npm install

NB : Il y a des dépendances optionnelles pour gérer celles de chaque moteur. Pour plus d'informations, voir ce document.

Génération de données

Qu'importe la source des données, il est nécessaire de les fournir dans l'un des formats utilisables par Road2. Étant donné que ce dernier peut utiliser plusieurs moteurs les calculs, il accepte plusieurs formats de données:

  • OSRM 5.26.0 rend possible l'utilisation de données OSRM générées avec cette version.
  • PGRouting 3.1.3 rend possible l'utilisation d'une base de données utilisant cette version. Il sera nécessaire d'y ajouter les procédures du projet pgrouting-procedures afin que Road2 puisse communiquer avec la base.

Ces données peuvent donc être générées à partir d'une base de données quelconque, ou de fichiers OSM. Le projet route-graph-generator propose des outils pour générer les graphes à partir de n'importe quelle base de données ou fichier osm. Si la base de données ne correspondant pas au format de la base attendue par route-graph-generator, il suffira de la dériver.

Pour une discussion détaillée sur les données attendues, on pourra se référer à cette documentation.

Configuration

Afin que le serveur fonctionne, il est nécessaire de le configurer. Il s'agit de créer une arborescence de quelques fichiers JSON permettant l'instanciation du serveur avec des ressources.

Lancement

Une fois configuré, il est possible de lancer une instance de Road2 avec la commande:

node ${road2}/src/js/road2.js --ROAD2_CONF_FILE=${configuration}/administration.json

Pour plus de détails

On trouvera dans le dossier docker/distrubutions différents Dockerfiles qui permettent de voir l'installation et de tester le service sur différentes plateformes. Pour le moment, Debian 10 est disponible.

Participer aux développements

Les participations à ce projet sont encouragées (votre notre charte à ce sujet). Nous avons mis en place un guide des contributions pour vous accompagner dans cette démarche.

On trouvera une documentation dédiée aux développeurs ici. Elle indique les concepts utiles pour effectuer des développements sur Road2.

Pour en savoir plus sur notre roadmap, vous pouvez regarder le projet IGNF/Road2 Roadmap.

Enfin, il est possible d'utiliser ce docker-compose pour avoir un environnement de développement incluant la construction des binaires, des modules et la génération des données.

Utilisation en production

Afin d'utiliser Road2 en production, plusieurs informations sont données dans ce document. Il s'agit principalement des besoins déjà observés pour une mise en production du service couvrant l'ensemble du territoire français.