Documentation des Web Services de Geoconcept Web  -  SmartRouting Server

Lors des calculs, les points de départs, les étapes et les arrivées sont reliés au réseau constitué par le graphe, même si les objets sont distants de celui-ci (points situés à une certaine distance du réseau) : c’est l’accrochage au graphe. Cette opération vise à rechercher autour de ces points les tronçons les plus proches. Ensuite, ces tronçons sont utilisés pour déterminer les débuts de solution possibles.

L’itinéraire calculé intègre alors une distance parcourue entre ces points et le graphe, appelée distance d’accrochage au graphe. Pour optimiser les performances, il existe une option permettant de fixer une distance maximale d’accrochage au graphe, exprimée en mètres (max graph snap distance). Cela évite de parcourir tout le réseau pour trouver les tronçons les plus proches.

En outre, la vitesse d’accrochage au graphe, vitesse de parcours de la distance séparant les départs, étapes ou arrivées du graphe peuvent également être personnalisées (graph snap speed).

Un métagraphe consiste dans la possibilité d’intégrer à la création du graphe un graphe simplifié ou allégé d’une partie de son contenu. L’utilisation du métagraphe vise essentiellement à accélérer le parcours du graphe, lors de calculs d’itinéraires s’effectuant sur de longues distances.

Le métagraphe est un fichier accompagnant le graphe SITI. Il est constitué de l’association d’un fichier au format MG et d’un fichier MGLIST. Le fichier MG est chargé en mémoire.

Il s’agit du niveau logique sur lequel le calcul d’itinéraires va se faire principalement. Deux cas sont possibles :

Il est possible de spécifier les coordonnées en entrée et en sortie de SmartRouting Server.

Intégration JEE

SmartRouting JEE est un composant d’intégration à la plate-forme JEE, il offre un service de calcul d’itinéraires aux modules JEE déployés sur un serveur d’applications (au sens large, moteur de servlet type Tomcat compris).

Le module consommateur peut être de n’importe quel type (webapp, ejb, etc). De même à l’intérieur du module JEE, le consommateur peut être de n’importe quel type (servlet, jsp, pojo, etc).

Mode d’accès

L’application utilisant le calcul d’itinéraires référence le fournisseur via un nom logique de l’annuaire JNDI (Java Naming and Directory Interface) du serveur d’applications. La manière de monter le fournisseur sera décrite plus loin.

Traditionellement, le nom logique utilisé est « geoconcept/smartrouting/default » du contexte « java:comp/env » mais il est possible d’utiliser un autre nom, un autre contexte ou de monter plusieurs fournisseurs de types différents.

Par soucis de simplicité, le cas d’utilisation le plus courant (un seul fournisseur primaire local avec nommage par défaut) sera décrit dans un premier temps.

Organisation du composant : Adaptation de ressource JEE et éléments externes

smartrouting-jee se compose de plusieurs parties. Pour des questions de performances et de réutilisation, le moteur (aussi appelé noyau) est écrit en C++ et est donc diffusé sous forme de librairies natives. La partie intégration (adaptateur de ressource) réalise le lien avec le moteur en gérant sa mise en oeuvre par chargement de ses librairies natives. En terme de déploiement de fichiers cela concerne donc deux arborescences distinctes :

En terme d’exécution, les librairies natives seront chargées en mémoire dans le processus de l’instance du serveur d’application (ou sa partition éventuelle selon les modèles) au démarrage. La partie adaptateur de ressource expose une interface java et gère le moteur instancié en mémoire directement via JNI.

Aucun module additionnel n’est indispensable au bon fonctionnement de l’adaptateur de ressource et leur déploiement est optionnel.

smartrouting-admin

smartrouting-admin est une webapp permettant la vérification de la bonne installation du produit, sa configuration et le test de bon fonctionnement.

Configuration de mise en oeuvre

Un graphe (fichier .siti) publié constitue une source de données (datasource).

Le fichier service.xml situé dans %smartrouting%/conf définit la configuration générale du fournisseur de service de calcul d’itinéraires. Celui ci contient notamment une configuration par défaut pour les sources de données (default‑datasource). Il est possible de définir une configuration spécifique à une source de données. Pour connaître les paramètres, vous pouvez consulter le chapitre sur les options.

Si aucune configuration spécifique n’a été définie alors la configuration par défaut (default-datasource) s’applique à la mise en oeuvre de cette source de données.

Par ailleurs il est possible de définir certains paramètres lors de l’appel (via CalculateRouteOptions). Ainsi la valeur concrète que prend un paramètre peut provenir (dans l’ordre) :

Configuration détaillée d’une source de données

Il est possible de définir la configuration de mise en oeuvre d’un graphe de manière très détaillée.

Cette définition peut répondre à des besoins particuliers, elle n’est pas indispensable car la configuration par défaut convient pour la grande majorité des cas.

Certains paramètres sont définissables au moment de l’appel, d’autres sont fixés à la création de l’instance de source de données et non modifiables par la suite.

Les paramètres que l’on peut définir aussi au moment de l’appel seront décrits dans la section CalculateRouteOptions.

Datasource identification

Cette partie permet l’identification d’une source de données dans l’administration.

File : graphe,

Name : alias de nom de la source de données (optionnel).

Les options disponibles sont celles décrites dans le guide de référence de SmartRouting.

Elles sont accessibles visuellement à travers l’application de test smartrouting-admin.war, qui présente chacune une entrée pour voir son comportement dans le résultat.

Coordonnées en entrée et en sortie

Si les coordonnées en entrée ne sont pas dans le même système de coordonnées que le graphe, il est nécessaire de les spécifier via le paramètre input coordinate system (sous la forme epsg:4326 par exemple).

Les coordonnées en sortie seront dans le même système que le système de coordonnées du graphe, sauf si le paramètre output coordinate system est renseigné du code EPSG (sous la forme epsg:27572 par exemple).

Les résultats en sortie

Il est possible, outre les segments composants l’itinéraire calculé, de recevoir comme résultat des attributs des-dits segments, grâce aux champs fields et language.

Calculate locations

Cette option permet de trouver un point sur l’itinéraire calculé à partir du point de départ. La valeur Calculate locations en secondes permet de trouver ce point à partir du début de l’itinéraire.

Consolidate segments

Cette option permet de regrouper, dans le résultat du calcul d’itinéraires, les segments qui portent le même nom et qui sont proches en un seul segment (utile pour la navigation).

Options avancées

Le fichier %smartrouting%/smartrouting/conf/service.xml permet de spécifier la configuration pour tous les graphes.

Vous pourrez trouver la configuration des graphes que vous possédez dans la page Datasources configuration, en cliquant sur le lien info. L’utilisation ou non d’un métagraphe dans le graphe est affichée en bas de la page.

Les itinéraires à calculer sont présents dans un fichier en entrée (txt) :

Les résultats des calculs d’itinéraire sont écrits dans un fichier résultat :

SRCmdLine est un outil qui se lance en ligne de commande depuis command line.

Exemple d’appel au programme :

<?xml version="1.0" encoding="utf-8"?>
<smartrouting-configuration>
  <!-- Smart Routing configuration -->
  <smartrouting>
    <!-- Graph file path-->
    <!-- <graph-path>E:\SmartRouting-cmdline\SRCmdLine\navteq_maps_for_geoconcept_Q311_france_v2.siti</graph-path> -->
        <graph-path>E:\SmartRouting-cmdline\graphe.siti</graph-path>
    <!-- Mode of routing. 1:Distance, 2:Time -->
    <iti-mode>1</iti-mode>
    <!-- Set connection distance -->
    <connection-distance>150.</connection-distance>
        <full-load-graph>1</full-load-graph>
        <reference-level>3</reference-level>
  </smartrouting>
  <!-- Input configuration (text file format) -->
  <smartrouting-input>
    <!-- Path of the input file. -->
    <path>E:\SmartRouting-cmdline\SRCmdLine\input.csv</path>
  </smartrouting-input>
  <!-- Ouput configuration (text file format) -->
  <smartrouting-output>
    <!-- Path of the output file.  -->
    <path>E:\SmartRouting-cmdline\SRCmdLine\output.csv</path>
  </smartrouting-output>
</smartrouting-configuration>