CitySearch-API : webservice et son API géographique Rss du webservice CitySearch-API

Webservices JSON | Webservices XML | communes proches |

Identification | Contact

API du webservice géographique français

Flux XML de listant communes et code postaux Suisse

home > Services XML > API recherche communes Suisses

Fonctionnement haut de page

Ce service permet de récupérer une liste de communes / code postaux Suisse, 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)

URL à appeler :

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

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 communes Suisses recherchées, champ insensible à la casse).

http://www.citysearch-api.com/ch/xml/city?login=APP_LOGIN&apikey=APP_KEY&ville=paris

: Integer - minimum de caractères : 1 - maximum de caractères : 5 (communes Suisses correspondant au code postal recherché).

Exemple d'URL avec le paramètre cp :

http://www.citysearch-api.com/ch/xml/city?login=APP_LOGIN&apikey=APP_KEY&cp=22200

: Integer - minimum de caractères : 1 - maximum de caractères : 2 (communes Suisses 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 :

http://www.citysearch-api.com/ch/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 commune)

: Integer (code postal de la commune)

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


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

Liste des exempleshaut de page

Recherche sur des champs select

Exemple d'appel en Javascripthaut de page

Cet exemple présente une méthode pour appeler la liste des communes Suisses 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 communes Suisses
	* @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			=	"http://www.citysearch-api.com/ch/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 communes Suisses à 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 commune fourni
	* @param string ville
    * @return xml
	*/
	function download_xml($ville){
		$path		=	'http://www.citysearch-api.com/ch/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é.";
    }
	
	

Télécharger l'exemple


Afficher les commentaires | Signaler une erreur


Webservices JSON | Webservices XML | communes proches |

Identification | Contact

API du webservice géographique français

Menu

Recherche sur des champs select