Web Service fournissant la liste et les coordonnées des stations publiques
Ce web service permet de récupérer un ensemble de points représentant les stations où des observations ont été saisies, au format JSON.
Les données sont affectées à leur emplacement précis si elles possèdent des coordonnées GPS (et ne sont pas signalées comme sensibles). Les données n'ayant pas de coordonnées GPS sont rassemblées au centroïde de la commune (si elle est renseignée), tout comme les espèces signalées comme sensibles.
De par la grand quantité de points retournés, ceux-ci sont agrégés en cluster si le nombre de point dépasse un seuil fixé (200).
URLs
Url dans la base de production : https://www.tela-botanica.org/service:cel:CelWidgetMapPoint
Url dans la base de test https://www.tela-botanica.org/test-service:cel:CelWidgetMapPoint
Paramètres
Opérations supportées : GETLe web service renvoie 3 types de résultats :
- Taxons associés à une zone géographique : https://www.tela-botanica.org/service:cel:CelWidgetMapPoint/taxons
- Observations associées à un point donné : https://www.tela-botanica.org/service:cel:CelWidgetMapPoint/observations
- Points associés à une zone géographique données : https://www.tela-botanica.org/service:cel:CelWidgetMapPoint/tout
Le web service attend un requête de type GET avec éventuellement des filtres indiqués dans la chaîne de requête.
Les paramètres suivants sont obligatoires pour les format "taxons" et "tout":
- zoom : entier représentant le niveau de zoom (de 1 à 14, un étant le plus éloigné et 14 le plus proche)
- ne : coordonnées Nord-Est de la bouding box, au format lat|long (exemple 71.298679965593|178.75)
- sw : coordonnées Sud-Ouest de la bounding box au format lat|lng (exemple : -20.638951670713386|-158.75)
Le paramètre suivant est obligatoire pour le format observations :
- station : indique les coordonnées de la station contenant les points, doit être au format suivant :
- STATION:lat|lng ou COMMUNE:lat|lng (exemple station=STATION%3A45.99696|-7.00928)
Format de retour du format "tout"
L'objet "stats" contient le nombre de stations, communes et observations comprises dans la bounding box.Le sous-objet "coordmax" contient la plus petite bounding box contenant tous les points.
L'objet "points" peut contenir trois type de données :
- les objets ayant des id de type GROUPE:lat|lng sont des clusters agrégeant des points (dont le nombre indiqué dans "nbreMarqueur")
- les objets ayant des id de type STATION:lat|lng sont des points précis
- les objets ayant des id de type COMMUNE:lat|lng sont des centroïdes de commune
{
"stats": {
"stations": 6880,
"communes": 190,
"observations": 5809,
"coordmax": {
"latMin": 43,
"lngMin": 3,
"latMax": 43.72546,
"lngMax": 4.07001
}
},
"points": [
{
"lat": 43.631267105263,
"lng": 3.8935117763158,
"id": "GROUPE:43,631267105263;3,8935117763158",
"nbreMarqueur": 152
},
{
"id": "STATION:43.62368|4.07001",
"type_emplacement": "stations",
"nom": "Station",
"lat": 43.62368,
"lng": 4.07001
},
{
"id": "COMMUNE:43.67|4.07445",
"type_emplacement": "stations",
"nom": "Candillargues (34)",
"lat": 43.62368,
"lng": 4.07001
}
]
}Paramètres principaux
- referentiel : référentiel taxonomique. Sont supportés : bdtfx, bdtxa (vaut par défaut bdtfx)
- num_taxon : numéro taxonomique selon le référentiel précisé
- taxon : nom scientifique ou partie du nom
- utilisateur : courriel d'un utilisateur
- projet : projet ou mot-clé associé à l'observation (exemple "sauvages", "defiPhoto")
- tag : tag associé aux image de l'observation (exemple : "fleur", "fruits")
- date : date de l'observation au format jj/mm/aaaa (pour afficher un jour précis)
- dept : numéro de département sur 2 ou 5 chiffres
- commune : partie de nom ou nom de commune
- commentaire : filtre selon le commentaire associé à l'observation
- photos : permet de ne renvoyer que les points possédant des photos
- nbjours : permet d'afficher les observations effectuées depuis le nombre de jours indiqués
Les paramètres suivants sont spécifiques au format "observation" :
- start : définit le tuple de départ des observations
- limit : définit le nombre d'éléments renvoyés
Exemples
- Points des observations de Montpellier et de ses proches alentours :
- Espèces observées à Montpellier et ses alentours :
- Observations sur la commune d'Avignon (sans coordonnées GPS ou bien sensibles) :