wiki:Geonol/API_REST/autocomplete_territory.json

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?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

Last modified 7 years ago Last modified on Dec 17, 2010, 3:43:56 PM