Webservice de recherche de districts Suisses
>
Services JSON > Liste districts Suisses
Fonctionnement haut de page
Ce service permet de récupérer la liste des districts Suisses au format JSON.
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
: Integer (code du canton).
Liste les districts Suisses en fonction du code canton recherché.
Exemple d'URL avec le paramètre canton ( dp ) :
//www.citysearch-api.com/ch/district?login=APP_LOGIN&apikey=APP_KEY&dp=1
: String (district recherché).
Prend les valeurs suivantes :
"all" : liste tous les districts Suisses.
Premières lettres du district : liste tous les districts Suisses commençant par cette valeur
Exemple d'URL avec le paramètre district ( dp ) :
//www.citysearch-api.com/ch/district?login=APP_LOGIN&apikey=APP_KEY&ds=zur
: integer ( inclusion du json dans l'élément "jsonCallback()" ).
Prend les valeurs suivantes :
"1" : inclu le json dans l'élément "jsonCallback()", utile par exemple pour les requêtes via JSONP de jQuery, voir l'exemple.
Exemple d'URL avec le paramètre callback :
//www.citysearch-api.com/ch/region?login=APP_LOGIN&apikey=APP_KEY&callback=1
Réponse haut de page
Les informations sont retournées au format XML.
: String (retourne le nom du district)
: Integer (le numéro du district)
Exemple de réponse retournée par ce service SANS le paramètre "callback" :
{"results":[
{"ds":"Ain","code": "1"},
...
{"ds":"Paris","code":"75"},
{"ds":"Seine maritime","code":"76"},
{"ds":"Seine et marne","code":"77"},
{"ds":"Yvelines","code":78"},
{"ds":"Deux Sèvres","code":"79"},
...
{"ds":"Guyane","code":"973"}
...
]}
Exemple de réponse retournée par ce service AVEC le paramètre "callback" :
jsonCallback({"results":[
{"ds":"Ain","code": "1"},
...
{"ds":"Paris","code":"75"},
{"ds":"Seine maritime","code":"76"},
{"ds":"Seine et marne","code":"77"},
{"ds":"Yvelines","code":78"},
{"ds":"Deux Sèvres","code":"79"},
...
{"ds":"Guyane","code":"973"}
...
]})
Liste des exempleshaut de page
Exemple d'appel en Javascripthaut de page
Cet exemple présente une méthode pour appeler la liste des districts 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 districts Suisses
*/
function appelAjax() {
var method='GET';
...
var api_name= "...";
var api_key = "...";
var url = "//www.citysearch-api.com/ch/district?login="+api_name+"&apiKey="+api_key";
http.open(method, url);
// Déclaration de la fonction à appeler pour traiter le retour Ajax
http.onreadystatechange = handleResponse;
...
http.send(null);
...
}
/**
* Fonction qui traitera la réponse AJAX
*/
function handleResponse() {
// Si l'état = 4 ...
if(http.readyState == 4){
...
// On stocke la réponse Ajax dans la variable "response"
var response = http.responseText;
...
}
}
Exemple d'appel en PHPhaut de page
Cet exemple présente une méthode pour appeler la liste des districts 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.
//-- $dir correspond au dossier dans lequel sera placé le cache
$dir = '/cache';
//-- $match correspond au fichier cache dédié à la région
$match = $dir."/district.json";
$exist = true;
$api_key = "...";
$api_name = "...";
//-- si le fichier n'existe pas on le créé
if(!file_exists($dir."/district.json")) {
$match = fopen($match, "r");
$exist = false;
}
//-- on regarde si le cache a expiré et que le fichier ne vient pas juste d'être créé
if((time()-filemtime($match) < 60) && $exist) {
$raw = file_get_contents($match);
$json = json_decode($raw);
//-- si il a expiré alors on le rappel
}else {
$url = "//www.citysearch-api.com/ch/district?login=".$api_name."&apiKey=".$api_key";
$raw = file_get_contents($url);
file_put_contents($match, $raw);
$json = json_decode($raw);
}
//-- on traite le résultat
if(!empty($json->results)){
foreach($json->results as $result) {
echo "" . $result->dp ." : ". $result->code;
echo "
";
}
}else {
echo "Aucun résultat trouvé.";
}
Afficher les commentaires | Signaler une erreur
URL à appelée :
//www.citysearch-api.com/ch/district?login=APP_LOGIN&apikey=APP_KEY