Logo RW
Contact | Portail Wallonie | Accueil
Web Services de Routing

Web Services de Routing

Mise en place et utilisation

Inclure la librairie javascript SpwRoutingApi.js :
<script type='text/javascript' src='REPLACE'></script>
Une fois la librairie chargée, la variable globale spwRouting est créée.
Cet objet dispose de méthodes appelant le web service de Routing.
Chacune de ces méthodes lance un appel Ajax au web service de routing.
Ces appels Ajax étant asychrones, les méthodes ne renvoient jamais de valeur, c'est pourquoi elles possèdent toutes les deux mêmes derniers paramètres : Exemple :
spwRouting.computeRoute('SHORTEST', 'FRENCH', '[{"idTroncon":774409514,"fraction":0.5,"cote":"D"},{"idTroncon":53818796,"fraction":0.5,"cote":"D"}]', computeRouteSuccessHandler, computeRouteErrorHandler);

function computeRouteSuccessHandler(data) {
alert('Distance totale : ' + data.distance + ' Km');
}

function computeRouteErrorHandler(request, status, error) {
alert('Une erreur est survenue lors du calcul de l'itinéraire : ' + error);
}


Proxy

L'utilisation d'un proxy permet de contourner le problème de "Cross-Domain" en javascript.
Ce proxy consiste en du code qui s'exécute sur votre serveur Web.
Le navigateur envoie la requête à votre proxy et le proxy à son tour, transmet la requête au serveur voulu.

L'initialisation de l'URL vers page proxy est nécessaire avant tout appel à une des méthodes de l'API de géolocalisation.
Exemples :
spwRouting.setProxyPage("proxy.jsp?");
ou
spwRouting.setProxyPage("/cgi-bin/proxy.cgi?url=");

Il est également possible de spécifier si l'url que envoyée au proxy doit être 'Url encodée'.
Par défaut, l'url n'est pas encodée.
Exemple :
spwRouting.setEncodeUrl(true);

Pour les applications J2EE, la page proxy.jsp est disponible ici.


Liste des méthodes



computeRoute

Description computeRoute
Paramètres
  • routePreference : Préférence de route : 'FASTEST' ou 'SHORTEST'
  • langue : Langue : 'FRENCH', 'GERMAN' ou 'ENGLISH'
  • etapes : Liste des étapes au format JSON
  • onSuccess : Fonction appelée en cas de réponse
  • onError : Fonction appelée en cas d'erreur

stringify

Description Converti un objet JSON en String
Paramètres
  • obj : Objet JSON