
Flux XML de listant villes et code postaux Belges
>
Services XML > API recherche villes Belges
Fonctionnement haut de page
Ce service permet de récupérer une liste de villes / code postaux Belges, en fontion des paramètres recherchés, au format XML.
Arguments requis haut de page
Les paramètres requis sont le login (APP_LOGIN) et la clé (APP_KEY) que vous avez créés pour le site concerné, tel que :
: String (nom que vous avez donné à votre application)
: String (la clé que vous avez reçu lors de la création de votre application)
Arguments optionnels haut de page
Les paramètres suivants sont optionnels et peuvent se cumuler :
: String - minimum de caractères : 1 (premières lettres des villes Belges recherchées, champ insensible à la casse).
//www.citysearch-api.com/be/xml/city?login=APP_LOGIN&apikey=APP_KEY&ville=paris
: Integer - minimum de caractères : 1 - maximum de caractères : 5 (villes Belges correspondant au code postal recherché).
Exemple d'URL avec le paramètre cp :
//www.citysearch-api.com/be/xml/city?login=APP_LOGIN&apikey=APP_KEY&cp=22200
: Integer - minimum de caractères : 1 - maximum de caractères : 2 (villes Belges correspondant au code département recherché).
Liste les départements en fonction du code région recherché.
Exemple d'URL avec le paramètre dp :
//www.citysearch-api.com/be/xml/city?login=APP_LOGIN&apikey=APP_KEY&dp=22
Réponse haut de page
Les informations sont retournées au format JSON.
: String (nom de la ville)
: Integer (code postal de la ville)
Exemple de réponse retournée par ce service :
... Paradou 13520 Paramé 35400 Parassy 18220 Paray-Douaville 78660 ... Paray-le-Frésil 3230
Liste des exempleshaut de page

Exemple d'appel en Javascripthaut de page
Cet exemple présente une méthode pour appeler la liste des villes Belges directement depuis le navigateur client via javascript.
Ce exemple ne prend pas en compte l'utilisation de librairies javascript tel que jQuery, Mootools...
/** * Fonction qui va récupérer la liste des villes Belges * @param string ville recherchée */ function appelAjax(ville) { var method = 'GET'; var api_name = ' /** Votre login CitySearch-API **/ '; var api_key = ' /** Votre clé CitySearch-API **/ '; var url = "//www.citysearch-api.com/be/xml/city?login="+api_name+"&apiKey="+api_key+"&ville=".ville"; var xhr = new XMLHttpRequest(); xhr.onreadystatechange = function() { if (xhr.readyState == 4 && (xhr.status == 200 || xhr.status == 0)) { handleResponse(xhr.responseXML); } }; xhr.open(method, url, true); xhr.send(null); } /** * fonction pour traiter la réponse * @param xml */ function handleResponse(xml){ var xmlDoc = xmlParse(xml); var markers = xmlDoc.documentElement.getElementsByTagName("ville"); for (var i = 0; i < markers.length; i++) { } }
Exemple d'appel du XML en PHPhaut de page
Cet exemple présente une méthode pour appeler la liste des villes Belges à partir du serveur PHP appelant l'API.
Cet exemple est associé à une mise en cache du résultat pendant 60 secondes.
La mise en cache n'est pas obligatoire et n'est présentée qu'à titre de suggestion.
/** * fonction pour transormer le tableau en chaine de caractère * @param array * @return string */ function arrayToText($array) { foreach ($array as $key=>$value) $array[$key] = urlencode($value); return implode('&', $array); } /** * fonction pour récupérer le XML en fonction du paramètre ville fourni * @param string ville * @return xml */ function download_xml($ville){ $path = '//www.citysearch-api.com/be/xml/city'; $api_name = ' /** Votre login CitySearch-API **/ '; $api_key = ' /** Votre clé CitySearch-API **/ '; $postFields = array("login" => $api_name, "apiKey" => $api_key, "ville" => $ville); arrayToText(); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,$path); curl_setopt($ch, CURLOPT_FAILONERROR,1); curl_setopt($ch, CURLOPT_FOLLOWLOCATION,1); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_TIMEOUT, 15); curl_setopt($ch, CURLOPT_POST,TRUE); curl_setopt($ch, CURLOPT_POSTFIELDS,$post); $retValue = curl_exec($ch); curl_close($ch); return $retValue; } $sXML = download_xml('Paris'); $oXML = new SimpleXMLElement($sXML); if(!emmpty($oXML)){ foreach($oXML->ville as $oEntry){ echo $oEntry->name . "\n"; } }else { echo "Aucun résultat trouvé."; }

Afficher les commentaires | Signaler une erreur

URL à appeler :
//www.citysearch-api.com/be/xml/city?login=APP_LOGIN&apikey=APP_KEY