wiki:Geonol/API_REST/poi.json

poi.json

Cette URL est un service web renvoyant un flux d'organismes géolocalisés.

La requête est faite par l'URL : http://annuaire.comarquage.fr/rest/poi.json?query_string, où query_string est remplacé par les paramètres documentés ci-dessous.

La réponse est au format JSON.

Paramètres de la requête

Ce sont les mêmes que pour l'appel Geonol/API_REST/poi.kml

Réponse

Les clés suivantes définissent la réponse JSON :

  • date : date et heure à laquelle le document a été généré, au format ISO 8601, YYYY-MM-DDTHH:MM:SS.mmmmmm ou YYYY-MM-DDTHH:MM:SS si microsecondes=0
  • start : même valeur que celle fournie dans la requête
  • count : nombre d'organismes total trouvés par la recherche, sans tenir compte de la pagination
  • placemarks : liste d'organismes

Les clés suivantes définissent un organisme (placemark) :

  • id : est l'identifiant unique de l'organisme
  • accuracy : précision du géocodage de l'adresse, selon http://code.google.com/intl/fr-FR/apis/maps/documentation/javascript/v2/reference.html#GGeoAddressAccuracy
  • name : nom de l'organisme
  • coordinates : coordonnées géographiques de l'organisme (ordre: longitude,latitude)
  • address (optionnel) : adresse de l'organisme, est un objet comportant les clés (commune-name, postal-code et street-address)
  • tel : liste des numéros de téléphone de l'organisme
  • fax : liste des numéros de fax de l'organisme
  • emails : liste des adresses email de l'organisme
  • web : liste des sites web de l'organisme
  • opening-hours (optionnel) : horaires d'ouverture de l'organisme
  • is-competent (optionnel) : compétence de l'organisme pour la commune recherchée. Cette donnée apparaît uniquement si le paramètre de recherche « where » a été utilisé. Si le paramètre de recherche « where » a été utilisé, et que la donnée is-competent n'est pas renvoyée, cela signifie que la compétence de l'organisme est inconnue pour cette commune.
  • source-url (optionnel) : URL d'où proviennent les informations sur l'organisme

Il existe un organisme spécial qui représente la commune recherchée. Son id="commune-coordinates". Il apparaît uniquement si le paramètre de recherche « where » a été utilisé.

Exemples de requêtes

Exemple de réponse JSON

cf Geonol/API_REST/PoiJSONResponseExample

Last modified 7 years ago Last modified on Nov 10, 2010, 11:38:24 AM