Web Services Cadmap
Mise en place et utilisation
Inclure la librairie javascript
SpwCadmapApi.js :
<script type='text/javascript' src='REPLACE'></script>
Une fois la librairie chargée, la variable globale
spwCadmap
est créée.
Cet objet dispose de méthodes appelant le web service Cadmap.
Chacune de ces méthodes lance un appel Ajax au web service Cadmap.
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 :
spwCadmap.getListeDivisions(92094, getListeDivisionsSuccessHandler, getListeDivisionsErrorHandler);
function getListeDivisionsSuccessHandler(data) {
alert(data.length);
}
function getListeDivisionsErrorHandler(request, status, error) {
alert("Une erreur est survenue lors du chargement des divisions : " + 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 :
spwCadmap.setProxyPage("proxy.jsp?");
ou
spwCadmap.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 :
spwCadmap.setEncodeUrl(true);
Pour les applications J2EE, la page proxy.jsp est disponible ici.
Liste des méthodes
getListeCommunes
Description |
Renvoie la liste des communes wallonnes |
Paramètres |
|