Logo RW
Contact | Portail Wallonie | Accueil
Web Services Segmentation

Web Services Segmentation

Mise en place et utilisation

Inclure la librairie javascript SpwSegmentationApi.js :
<script type='text/javascript' src='REPLACE'></script>
Une fois la librairie chargée, la variable globale spwSegmentation est créée.
Cet objet dispose de méthodes appelant le web service Segmentation.
Chacune de ces méthodes lance un appel Ajax au web service Segmentation.
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 :
spwSegmentation.getPointOnSegment("A003001",100,1, getPointOnSegmentSuccessHandler, getPointOnSegmentErrorHandler);

function getPointOnSegmentSuccessHandler(data) {
alert(data.length);
}

function getPointOnSegmentErrorHandler(request, status, error) {
alert("Une erreur est survenue lors de l'appel au web service : " + 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 :
spwSegmentation.setProxyPage("proxy.jsp?");
ou
spwSegmentation.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 :
spwSegmentation.setEncodeUrl(true);

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


Liste des méthodes



getPointOnSegment

Description Renvoie le point situe sur le reseau choisi a la cumulee specifiee
Paramètres
  • code : Code d'identification
  • cumulee : Cumulee
  • system_type : Type de systeme interroge (1 = reseau routier et 2 = reseau fluvial)
  • onSuccess : Fonction appelée en cas de réponse
  • onError : Fonction appelée en cas d'erreur

getSegment

Description Renvoie la geometrie du reseau choisi entre deux cumulees
Paramètres
  • code : Code d'identification
  • cumulee_start : Cumulee de debut
  • cumulee_end : Cumulee de fin
  • system_type : Type de systeme interroge (1 = reseau routier et 2 = reseau fluvial)
  • onSuccess : Fonction appelée en cas de réponse
  • onError : Fonction appelée en cas d'erreur

getListeSegments

Description Renvoie la liste des segments (sans géométrie)
Paramètres
  • system_type : Type de systeme interroge (1 = reseau routier et 2 = reseau fluvial)
  • onSuccess : Fonction appelée en cas de réponse
  • onError : Fonction appelée en cas d'erreur

getNearestSegment

Description Renvoie le segment le plus proche des coordonnees lambert passees en parametre (le shape contient le point projeté sur le segment), la distance et la mesure
Paramètres
  • x : Coordonnee X
  • y : Coordonnee Y
  • system_type : Type de systeme interroge (1 = reseau routier et 2 = reseau fluvial)
  • onSuccess : Fonction appelée en cas de réponse
  • onError : Fonction appelée en cas d'erreur

getNearestOnSegment

Description Renvoie le segment le plus proche des coordonnees lambert passees en parametre sur le segment dont le code est passé en paramètre (le shape contient le point projeté sur le segment), la distance et la mesure
Paramètres
  • x : Coordonnee X
  • y : Coordonnee Y
  • code : Code d'identification
  • system_type : Type de systeme interroge (1 = reseau routier et 2 = reseau fluvial)
  • 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