autocomplete_territory.json
Cette URL est un service web qui renvoie une liste de communes françaises ou d'arrondissements.
L'API de cet autocompleter est compatible avec celle de l'autocompleter de jquery-ui (http://jqueryui.com/demos/autocomplete).
La requête est faite par l'URL : http://annuaire.comarquage.fr/rest/autocomplete_territory.json, avec la possibilité de fournir des paramètres en query string.
La réponse est au format JSON.
Paramètres de la requête
- jsonp (str) : nom de la fonction javascript retournée pour l'utilisation en AJAX depuis un autre domaine. (http://en.wikipedia.org/wiki/JSONP)
- limit (int, default=10, min=1, max=100) : nombre maximum d'éléments renvoyés
- start (int, défaut=0) : numéro d'ordre du premier résultat retourné. Si start=0, aucun décalage n'est effectué.
- term (str) : la recherche de communes est effectuée sur ce paramètre. Si ce paramètre est vide ou absent, les villes les plus importantes sont renvoyées.
Tous les paramètres sont optionnels et peuvent être combinés.
Les paramètres doivent être des chaînes de caractères « url-encodées ».
Réponse
Une liste de chaînes de caractères en majuscules, encodée en UTF-8, correspondant à des noms de communes françaises est retournée au format JSON.
Si le paramètre jsonp est fourni dans la requête, cette liste est encapsulée dans un appel de fonction dont le nom est la valeur du paramètre jsonp.
Exemples
- http://annuaire.comarquage.fr/rest/autocomplete_territory.json
["69000 LYON", "31300 TOULOUSE", "06200 NICE", "44100 NANTES", "67000 STRASBOURG", "34070 MONTPELLIER", "75015 PARIS 15E ARRONDISSEMENT", "33000 BORDEAUX", "59777 EURALILLE", "35700 RENNES"]
- http://annuaire.comarquage.fr/rest/autocomplete_territory.json?term=dign
["04000 DIGNE-LES-BAINS", "16410 DIGNAC", "33590 JAU-DIGNAC-ET-LOIRAC", "28250 DIGNY", "11300 LA DIGNE-D'AVAL", "39190 DIGNA", "11300 LA DIGNE-D'AMONT", "88000 DIGNONVILLE"]
- http://annuaire.comarquage.fr/rest/autocomplete_territory.json?term=dign&jsonp=foo
foo(["04000 DIGNE-LES-BAINS", "16410 DIGNAC", "33590 JAU-DIGNAC-ET-LOIRAC", "28250 DIGNY", "11300 LA DIGNE-D'AVAL", "39190 DIGNA", "11300 LA DIGNE-D'AMONT", "88000 DIGNONVILLE"])
- http://annuaire.comarquage.fr/rest/autocomplete_territory.json?term=92&limit=100
["92100 BOULOGNE-BILLANCOURT", "92000 NANTERRE", "92400 COURBEVOIE", "92600 ASNIÈRES-SUR-SEINE", "92700 COLOMBES", "92500 RUEIL-MALMAISON", "92300 LEVALLOIS-PERRET", "92130 ISSY-LES-MOULINEAUX", "92200 NEUILLY-SUR-SEINE", "92160 ANTONY", "92110 CLICHY", "92140 CLAMART", "92120 MONTROUGE", "92190 MEUDON", "92150 SURESNES", "92230 GENNEVILLIERS", "92800 PUTEAUX", "92220 BAGNEUX", "92320 CHÂTILLON", "92290 CHATENAY-MALABRY", "92240 MALAKOFF", "92210 SAINT-CLOUD", "92250 LA GARENNE-COLOMBES", "92270 BOIS-COLOMBES", "92170 VANVES", "92390 VILLENEUVE-LA-GARENNE", "92260 FONTENAY-AUX-ROSES", "92310 SÈVRES", "92350 LE PLESSIS-ROBINSON", "92340 BOURG-LA-REINE", "92330 SCEAUX", "92370 CHAVILLE", "92380 GARCHES", "92410 VILLE-D'AVRAY", "92420 VAUCRESSON", "92430 MARNES-LA-COQUETTE"]
Implémentation
Cet autocompleter utilise le logiciel libre Podis : http://gitorious.org/infos-pratiques/podis