Logo RW
Contact | Portail Wallonie | Accueil
Web Services Cadmap

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 : 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