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

eFlore Api v0.1 : Images


Ce service fournit des informations sur les images.

Descriptions des paramètres de requête du service
Paramètres obligatoires :
  • "referentiel" (=bdtfx, bdtxa, isfan) : code du référentiels des noms scientifiques à utiliser.
  • "masque.nn" : filtre sur l'identifiant du nom scientifique (Champ : determination.nom_sci.code). Possibilité d'en indiquer plusieurs séparés par des virgules. Ex. : 7128,7547. ATTENTION : l'obligation d'utiliser ce paramètre est un bug du web service pour le projet cel.

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 le nom latin de l'espèce observée. Ex. : "Abies%"
    • "masque.ns" : filtre sur le nom scientifique de la détermination (Champ : determination). Ex. : "Abies%"
    • "masque.nn" : filtre sur l'identifiant du nom scientifique (Champ : determination.nom_sci.code). Possibilité d'en indiquer plusieurs séparés par des virgules. Ex. : 7128,7547
    • "masque.auteur" : filtre sur le nom ou l'identifiant du photographe.
    • "masque.date" : filtre sur la date d'observation.
    • "masque.station" : filtre la liste en fonction d'un masque de recherche portant sur un code de zone géographique. Ce code est composé du code du projet de référentiel géographique (INSEE-C, ISO-3166-1...) et de l'identifiant de la zone géographique. Ex. : "INSEE-D.30".
  • "recherche" (=stricte|floue): type de recherche à lancer (pour l'instant, uniquement sur le masque par défaut portant sur le nom latin complet) :
    • stricte : si le masque vaut "Ace mons", la recherche sera lancée sur "Ace%mons%". C'est à dire, ajout du signe % à la place des espaces et en fin de masque.
    • floue : recherche tolérante vis-à-vis d'approximations ou d'erreurs (fautes d'orthographe par exemple). Ex. : je tape "Acre", le service retournera "Acer" ou si je tape "Acer monspesulanum" le service retournera "Acer monspessulanum".
  • "retour" (=application/json|image/jpeg) un type mime dans le cas où l'on ne renvoie pas de json mais un objet binaire comme une image (optionnel la plupart du temps)

Nom de champs à utiliser quelque soit les projets
En gras, les champs obligatoires :
  • id : identifiant numérique de l'image.
  • mime : type mime de l'image (image/jpeg par exemple).
  • date : date de prise de vue.
  • binaire.href : lien vers l'image (le binaire).
  • observation.id : identifiant de l'observation.
  • station : intitulé de la station représenté par une concaténation des différentes informations permettant de localiser la station. (voir le détail dans la ressource Observations)
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'auteur de l'image.
    • determination.nom_sci : le nom scientifique du taxon observé.
      • determination.nom_sci.code : le code du nom scientifique du taxon observé.
  • auteur : intitulé de l'auteur de l'image 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.

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



/images/#id
Retourne toutes les informations sur l'image recherchée.
Défaut (=defaut) : JSON.
Pour l'url http://tela-botanica.org/service:eflore:0.1/cel/images/#id
{
  • "id" : "6711",
  • "date" : "2011-10-28",
  • "mime" : "image/jpeg",
  • "binaire.href : "http://www.tela-botanica.org/appli:cel-img:000012001L",
  • "observation.id : "48300",
  • "determination" : "Abies alba Mill.",
  • "determination.nom_sci" : "Abies alba Mill.",
  • "determination.nom_sci.code" : "BDTFX.74929",
  • "station" : "Montpellier (34)",
  • "auteur" : "Prénom NOM"
}

/images/masque.nn=#nn&retour.format=jpeg
Retourne une image au hasard provenant du cel illustrant le numéro nomenclatural donné, uniquement disponible pour le projet cel
  • Type de requête : GET
  • URI : http://localhost/service:eflore:0.1/cel/images?masque.nn=#nn&retour=#type_retour&retour.format=jpeg
  • Paramètres du chemin :
    • "#nn" : le numéro numenclatural demandé (obligatoire, peut être de la forme ref_tax1:nn1,nn2;ref_tax2:nn3,nn4 où ref_taxN est un code de référentiel taxonomique) si un seul numéro est précisé, ref tax vaut bdtfx par défaut
    • "#type_retour" : le type mime de retour (seul image/jpeg est implémenté pour le moment) optionnel, vaut par defaut image/jpeg
    • "#format_image" : le format (taille) de l'image renvoyée (voir la liste disponible ici) optionnel, vaut par défaut M
  • Format retour :
Défaut (=jpeg) : Une image binaire précédée d'un content-type (directement utilisable dans une balise html image).