Web services : lister les villes autour d’une position géographique

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 :

City name Département CP Country code Latitude Longitude
Bobigny 93 93000 FR 48.9 2.45
Bondy 93 93140 FR 48.9 2.46667
Lilas 93 93260 FR 48.8833 2.43333
Noisy-le-Sec 93 93130 FR 48.8833 2.46667
Romainville 93 93230 FR 48.8833 2.43333


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.

Poster un Commentaire

Soyez le premier à commenter !

Me notifier des
avatar
wpDiscuz