Retour : page principale > sommaire eFlore v5 > eFlore API v0.1

eFlore Api v0.1 : Observations


Ce service fournit des informations sur les observations botaniques.
Le but de cette ressource est de fournir des informations sur le : quoi, quand, où, par qui et comment d'une observation.
Il est possible ainsi de fournir des informations issues :
  • d'observations de terrain,
  • de bibliographie,
  • de collections.
  • de relevé phytosociologique
  • de données chorologiques

Descriptions des paramètres de requête du service
Ces paramètres sont optionnels et sont passés après le signe "?" dans l'URL.
  • masque : filtre la liste en fonction d'un masque de recherche portant sur l'ensemble des champs textes.
    • masque.type : filtre sur le type d'observation.
    • masque.date_observation : filtre sur la date d'observation.
    • masque.station : filtre sur l'intitulé de la station.
    • masque.determination : filtre sur l'intitulé de la détermination principale.
    • masque.observateur : filtre sur l'observateur.
Il devrait être possible de réaliser une recherche sur n'importe quel champ en préfixant celui-ci par "masque." à partir du moment où il existe dans le projet.

Nom de champs à utiliser quelque soit les projets
En gras, les champs obligatoires :
  • id : identifiant numérique de l'observation.
  • type : type d'observation (terrain, bibliographie, collection, phytosociologie, chorologie).
    • type.code :
    • type.href :
  • date_observation : date de l'observation au format ISO 8601.
  • date_creation : date de la création de l'observation dans le système de stockage au format ISO 8601.
  • date_modification : date de la dernière modification de l'observation dans le système de stockage au format ISO 8601.
  • date_publication : date à laquelle l'observation a été rendu publique au format ISO 8601.
  • station : intitulé de la station représenté par une concaténation des différentes informations permettant de localiser la station.
    • station.origine : intitulé de la station tel que fournie par l'observateur.
    • station.continent : nom du continent.
      • station.continent.code : code du continent.
      • station.continent.href : lien vers le projet détaillant les informations sur le continent.
    • station.pays :
      • station.pays.code :
      • station.pays.href :
    • station.region :
      • station.region.code :
      • station.region.href :
    • station.departement :
      • station.departement.code :
      • station.departement.href :
    • station.commune :
      • station.commune.code :
      • station.commune.href :
    • station.toponyme :
      • station.toponyme.code :
      • station.toponyme.href :
    • station.milieu : intitulé du milieu fourni par l'utilisateur ou correspondant au référentiel.
      • station.milieu.code : si le milieu est issu d'un référentiel (CORINE BIOTOPE), le code peut être indiqué.
      • station.milieu.href : si le milieu est issu d'un référentiel, le lien vers l'ontologie ou les informations détaillées.
      • station.milieu.naturel : indique si "oui" ou "non" le milieu de l'observation était naturel. Les observation de plante effectuées dans un jardin botanique devrait avoir cette valeur à "non".
    • station.coordonnees : texte formaté représentant les coordonées.
      • station.coordonnees.origine : coordonnées géographique d'origine tel que mentionnées par l'observateur (utile pour les observations issues de la biliographie et de collections).
      • station.coordonnees.latitude : latitude décimale.
      • station.coordonnees.longitude : longitude décimale.
      • station.coordonnees.datum : intitulé du référentiel géodésique utilisé.
        • station.coordonnees.datum.code : code du référentiel géodésique utilisé.
        • station.coordonnees.datum.href : lien vers le détail (ontologie) du réfentiel géodésique utilisé.
      • station.coordonnees.incertitude : limite supérieure de la distance (en mètres) entre la latitude et longitude indiquées et un cercle dans lequel l'ensemble de la localité peut être inclu. Laissez la valeur vide si l'incertitude est inconnue, ne peut être estimée, ou n'est pas applicable (parce qu'il n'y a pas de coordonnées). La valeur doit être supérieure à zéro. (voir aussi Biogeomancer, Guide to Best Practices in Georeferencing).
  • determination : intitulé de la détermination principale. Correspond au nom scientifique seul ou concaténé avec le nom du déterminateur (entre crochet précédé du préfixe "Dét.") s'il est différent de l'observateur.
    • determination.origine : intitulé de la détermination tel qu'il a été noté dans le document d'origine (utile pour les collections et la biblio).
    • determination.nom_sci : le nom scientifique du taxon observé.
      • determination.nom_sci.origine : le nom scientifique du taxon observé tel qu'il a été noté dans le document d'origine (utile pour les collections et la biblio).
      • determination.nom_sci.code : le code du nom scientifique du taxon observé.
      • determination.nom_sci.href : le lien vers le nom scientifique du taxon observé.
    • determination.determinateur : intitulé du déterminateur du nom du taxon s'il est différent de celui de l'observateur. Peut contenir des informations provenant des ressources : Personnes ou Structures.
      • determination.determinateur.origine : intitulé du déterminateur du nom du taxon s'il est différent de celui de l'observateur tel qu'il a été noté dans le document d'origine (utile pour les collections et la biblio). Peut contenir des informations provenant des ressources : Personnes ou Structures.
        • determination.determinateur.code : le code de la personne ayant réalisé la détermination, si elle est différente de l'observateur.
        • determination.determinateur.href : le lien vers la fiche de la personne ayant réalisé la détermination, si elle est différente de l'observateur.
    • determination.confiance : un indice de confiance dans la détermination allant de 0 (douteux) à 1 (confiance totale).
    • determination.methode : la méthode utilisé pour trouver le nom de la plante (ex. : détermination, reconnaissance).
      • determination.methode.code :
      • determination.methode.href :
    • determination.source : information sur le(s) document(s) utilisé(s) pour trouver le nom de la plante.
      • determination.source.code :
      • determination.source.href :
      • determination.source.autres :
    • determination.autres : tableau contenant d'autres déterminations (pour le cas des collections où plusieurs déterminations peuvent apparaître sur une planche d'herbier).
  • observateur : intitulé de l'observateur de l'observation. Peut contenir des informations provenant des ressources : Personnes ou Structures. prénom et nom de la personne ayant effectué l'observation ou collecté le taxon.
    • observateur.code :
    • observateur.href :
    • observateur.autres :
  • contributeur : intitulé du contributeur ayant saisi cette observation si différent de l'observateur. Peut contenir des informations provenant des ressources : Personnes ou Structures.
    • contributeur.code :
    • contributeur.href :
    • contributeur.autres : dans le cas où plusieurs personnes peuvent avoir contribuées à la saisie de l'observation.
  • source : intitulé de la source de l'observation. Peut contenir des informations provenant des ressources : Images, Textes, Publications, Collections ou Parts. Par exemple, une référence bibliographique de la publication à l'origine de l'observation pour les données bibliographiques.
    • source.precision : en fonction de la source peut indiquer une page, un groupe de page, un numéro de part...
    • source.code :
    • source.href :
    • source.autres : dans le cas où plusieurs documents sont à l'origine de cette observation.
  • valeur : peut contenir la valeur d'abondance/dominance pour les données phytosociologiques ou l'information concernant la présence du taxon sous forme de texte pour les données chorologiques.
    • valeur.code :
    • valeur.href :
    • valeur.autres : dans le cas ou le projet contient plusieurs notions différentes affectées à chaque occurence de taxon.
  • notes : notes sur l'observation.

/observations
Retourne une liste d'observations et leur identifiant dans le projet. Par défaut, retourne seulement les 100 premières observations.
Défaut (=defaut) : JSON.
{
 }



/observations/#id
Retourne toutes les informations sur l'observation recherchée
Défaut (=defaut) : JSON.
Pour l'url http://tela-botanica.org/service:eflore:0.1/cel/2.0/observations/#id
{
  • "id" : "7312",
  • "date_observation" : "2008-05-22 00:00:00",
  • "station" : "France > Pyrénées-orientales > Amélie-les-Bains > 42.476111 N, 2.6725 E [WGS84]",
  • "station.pays" : "France",
  • "station.pays.code" : "ISO-3166-1.FR",
  • "station.pays.href" : "...",
  • "station.departement" : "Pyrénées-orientales",
  • "station.departement.code" : "ISO-3166-2.FR-66",
  • "station.departement.href" : "...",
  • "station.toponyme" : "Amélie-les-Bains",
  • "station.coordonnees" : "42.476111 N, 2.6725 E [WGS84]",
  • "station.coordonnees.latitude" : "42.476111",
  • "station.coordonnees.longitude" : "2.6725",
  • "station.coordonnees.datum" : "WGS84",
  • "station.coordonnees.datum.code" : "WGS84",
  • "station.coordonnees.datum.href" : "...",
  • "determination" : "Abies pinsapo Boiss.",
  • "observateur" : "p.nom@email.fr",...
}

/observations/#id/#champ+#champ
Retourne l'information présent dans le champ indiqué pour l'observation recherchée
Défaut (=defaut) : JSON.
Pour l'url http://tela-botanica.org/service:eflore:0.1/#projet/#version/observations/1/determination+date_observation+station.pays.code nous aurons :
{
  • "id" : "1",
  • "determination" : "Abies pinsapo Boiss.",
  • "date_observation" : "2011-01-01 00:00:00",
  • "station.pays.code" : "ISO-3166-1.FR"
}