Depuis 3.5, une API GeoJson permet d’accéder aux données des observations liées à un taxon donné. Cette API se base sur le CD_REF de la classification TAXREF.
Description
On y accède via l’URL suivante : spip.php?page=cdref_json&cd_ref=nnnnn où nnnnn représente le CD_REF du taxon considéré.
Le résultat obtenu est un objet FeatureCollection, dont chaque Feature est un Point aux coordonnées de l’observation. Les propriétés (properties) suivantes sont associées à chaque Feature :
| Propriété | Description |
|---|---|
| type | ’observation’ (valeur fixe) |
| id | Le numéro de l’observation dans la base |
| uid | Un identifiant unique [1] |
| sujet | Identifiant du sujet dans la base, si l’observation est liée à un sujet. 0 sinon. |
| confidentiel | Indicateur de la confidentialité de l’observation |
| titre | Le titre de l’observation fourni par l’observateur |
| url | l’URL de la page HTML de l’observation sur le site |
| auteur | Nom du ou des auteurs de l’observation |
| date | Date de l’observation |
| type_obs | ’espece’ pour une observation d’espèce, ’autre’ sinon. |
| espece | Identification fournie par l’observateur [2] |
| identification | Espèce confirmée par les administrateurs du site (nom latin) |
| cd_ref | Identifiant de l’espèce dans TAXREF |
| adresse | Adresse de l’observation |
| commune | Commune de l’observation |
| insee | Code INSEE de la commune d’observation |
| quantite | Nombre de spécimens de l’observation |
| denombrement | ’Co’=comptage, ’Es’=estimation, ’Ca’=calcul, ’NSP’=ne sait pas |
| popupContent | Un fragment HTML destiné à être affiché sur une carte au survol de l’observation |
Limitations
Afin de respecter la confidentialité des observations, la richesse des données fournies dépend du profil de l’utilisateur. Seuls les administrateurs ont accès aux données de localisation des observations confidentielles. Pour les autres utilisateurs, les observations confidentielles seront complètement absentes des données retournées.
La requête s’effectuant sur la base de l’identifiant de l’espèce, il est nécessaire que celle-ci ait été confirmée pour que l’observation figure dans le résultat. Autrement dit, les conditions suivantes doivent être remplies :
- l’observation doit être attachée à une fiche espèce
- la fiche espèce doit avoir été indexée par rapport à TAXREF
Usage
Cette API, présente sur les différents sites Biodiv, permet entre autres de produire une cartographie des observations d’une espèce donnée qui couvre l’ensemble des sites Biodiv. C’est ce que l’on obtient via le lien Répartition Biodiv d’une fiche espèce.
Remarques:
- Pour plus de détails sur TAXREF consultez Gérer les références à une classification externe.
- GeoJson est un format de représentation de données géographiques basé sur JSON (JavaScript Object Notation). Voir Wikipedia.
Notes:
[1] Cet identifiant n’est pas stocké en base, mais généré dynamiquement à partir d’un code lié à la base de données d’une part, et à l’observation d’autre part. Il est utilisé comme identifiant unique lors de la communication de l’observation à des organismes extérieurs.
[2] Cette information n’est pas forcément confirmée, et ne doit pas être utilisée
