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
- http://annuaire.comarquage.fr/rest/poi.json
- http://annuaire.comarquage.fr/rest/poi.json?limit=50
- http://annuaire.comarquage.fr/rest/poi.json?center=0.96679718754413%2C46.179832551001
- http://annuaire.comarquage.fr/rest/poi.json?center=0.96679718754413%2C46.179832551001&start=5
- http://annuaire.comarquage.fr/rest/poi.json?q=jean%20moulin
- http://annuaire.comarquage.fr/rest/poi.json?center=0.96679718754413%2C46.179832551001&q=jean%20moulin
- http://annuaire.comarquage.fr/rest/poi.json?category=mairie
- http://annuaire.comarquage.fr/rest/poi.json?category_tag=justice
- http://annuaire.comarquage.fr/rest/poi.json?where=33000%20Bordeaux
- http://annuaire.comarquage.fr/rest/poi.json?category=tribunal-de-grande-instance-tgi&where=bordeaux
- http://annuaire.comarquage.fr/rest/poi.json?format=mobidroits
Exemple de réponse JSON
Last modified 10 years ago
Last modified on Nov 10, 2010, 11:38:24 AM