Webservices JSON | Webservices XML | Villes proches |

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 :

apikey: String (la clé que vous avez reçu lors de la création de votre application)

URL à appeler :

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

Arguments optionnels haut de page

Les paramètres suivants sont optionnels et peuvent se cumuler :

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

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

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

ville: String (nom de la ville)

cp: Integer (code postal de la ville)

Exemple de réponse retournée par ce service :


		
			...
			Paradou13520
			Paramé35400
			Parassy18220
			Paray-Douaville78660
			Paray-le-Frésil3230
			...

Liste des exempleshaut de page

Exemple d'appel en Javascript Exemple d'appel en PHP

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++) {
		
		}
	}

Télécharger l'exemple

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.

A noter : 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é.";
    }