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 :
- onSuccess : fonction appelée en cas de succès. Elle a un paramètre contenant la réponse du serveur
- onError : fonction appelée en cas d'erreur. Elle a 3 paramètres : request, status et error
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 |
|