Zoo coder

Présentation

Le Web service suivant vous permettra de récupérer la liste des villes autour d’un lieu géographique donné. Il ne concerne pour le moment que la France.

La zone de recherche est un carré de côté égale au « rayon x 2 » (radius x 2), avec pour centre le lieu géographique passé en paramètre (location), comme le montre l’image ci-dessous.

Description de l’API

Le Webservice est composé d’une URL de la forme : [domain]/[environnement]/werservices/rest/cities/around?location=[location]&radius=[rayon de recherche]&format=[json/html/php]

1. serveur : Le nom du domain (exemple : www.zoocoder.com)
2. environnement : L’environnement (exemple: prod)
3. Le Web service : werservices/rest/cities/around?
4. Les paramètres :
   1. location : Peut être un nom de ville ou un code postal.
   2. radius : Le rayon de recherche (en kilomètre)
   3. format : Le format du résultat est optionnel. json (par défaut), html ou php

L’utilisation se fera donc de la sorte :

[…]/werservices/rest/cities/around?location=toulouse&radius=10&format=json

Exemple

Imaginons que nous souhaitons connaître toutes les villes qui se situent dans un rayon de 3 Km de la ville de Bobigny, nous appellerions alors le Web service comme cela :

http://mandien.hd.free.fr/prod/webservices/rest/cities/around?location=bobigny&radius=3&format=json

« Location » doit impérativement être un nom de ville ou un code postal valide.

Le résultat obtenu serait alors :

[{"ville_nom_reel":"Bobigny","ville_departement":"93","ville_code_postal":"93000","ville_latitude_deg":"48.9","ville_longitude_deg":"2.45"},{"ville_nom_reel":"Bondy","ville_departement":"93","ville_code_postal":"93140","ville_latitude_deg":"48.9","ville_longitude_deg":"2.46667"},{"ville_nom_reel":"Drancy","ville_departement":"93","ville_code_postal":"93700","ville_latitude_deg":"48.9333","ville_longitude_deg":"2.45"},{"ville_nom_reel":"Le Blanc-Mesnil","ville_departement":"93","ville_code_postal":"93150","ville_latitude_deg":"48.9333","ville_longitude_deg":"2.45"},{"ville_nom_reel":"Le Bourget","ville_departement":"93","ville_code_postal":"93350","ville_latitude_deg":"48.9333","ville_longitude_deg":"2.41667"},{"ville_nom_reel":"Lilas","ville_departement":"93","ville_code_postal":"93260","ville_latitude_deg":"48.8833","ville_longitude_deg":"2.43333"},{"ville_nom_reel":"Noisy-le-Sec","ville_departement":"93","ville_code_postal":"93130","ville_latitude_deg":"48.8833","ville_longitude_deg":"2.46667"},{"ville_nom_reel":"Romainville","ville_departement":"93","ville_code_postal":"93230","ville_latitude_deg":"48.8833","ville_longitude_deg":"2.43333"}]

Pour récupérer ces mêmes résultat dans un format HTML :

http://mandien.hd.free.fr/prod/webservices/rest/cities/around?location=bobigny&radius=3&format=html

Le résultat obtenu sera alors :

Remarques : L’utilisation de ce Web service est gratuit et n’est pas destiné à un usage commercial, il est fourni sans aucune garantie d’aucune sorte.