Retour : Page Principale > sommaire applications botaniques > Détermination en Ligne > web services DEL

Web Service fournissant les images


Ce web service fournit les images associées à leurs observations.

Urls


Url de base :
http://api.tela-botanica.org/service:del:0.1/images

Paramètres

Opération supportées : GET
Le web service attend un requête de type GET avec éventuellement des filtres indiqués dans la chaîne de requête.

Paramètres principaux



Exemples



Format de retour

Le type de retour est un objet JSON.
Exemple

{
    "entete": {
        "masque": " ",
        "total": 130765,
        "depart": 0,
        "limite": 10,
        "href.suivant": "http://api.tela-botanica.org/service:del:0.1/images?navigation.depart=10&navigation.limite=10"
    },
    "resultats": {
        "189568-1051663": {
            "id_image": "189568",
            "binaire.href": "http://api.tela-botanica.org/img:000189568XL.jpg",
            "protocoles_votes": [ ],
            "mots_cles_texte": "plante entière,plante herbacee",
            "observation": {
                "id_observation": "1051663",
                "date_observation": "2013-08-20 00:00:00",
                "date_transmission": "2013-10-03 01:51:21",
                "determination.famille": "Caprifoliaceae",
                "determination.ns": "Knautia maxima (Opiz) J.Ortmann",
                "determination.nn": "36988",
                "determination.referentiel": "bdtfx",
                "determination.nt": "2592",
                "id_zone_geo": "INSEE-C:09055",
                "zone_geo": "Bethmale",
                "lieudit": "Port de la Core",
                "station": "GR10 Col d Auèdole",
                "milieu": "megaphorbiaie",
                "auteur.id": "15382",
                "auteur.nom": "BIGOU",
                "auteur.prenom": "Alain",
                "mots_cles_texte": "Flore des Pyrénées",
                "commentaire": "altitude 1620 m - GR10, en bordure du sentier du Col d Auèdole"
            }
        }
    }
}


entete
L'index "entete" contient les informations relatives à la requête et à sont résultat
  • masque : récapitule les filtres de la requete en cours
  • total : nombre total de résultat pour ce filtre (nombre de résultats renvoyés si les paramètres de navigation ne sont pas présents)
  • depart : valeur du paramètre navigation.depart
  • limite : valeur du paramètre navigation.limite
  • href.suivant : dans le cas ou les paramètres depart et limite sont présents, et que nous ne nous trouvons pas sur la dernière page de résultats, permet d'accéder au set de résultats suivants
  • href.precedent : dans le cas ou les paramètres depart et limite sont présents, et que nous ne nous trouvons pas sur la première page de résultats, permet d'accéder au set de résultats précédents

resultats
L'index résultat contient un tableau de résultats contenant les informations sur leurs images et leur détermination la plus probable.
La clé de chaque enregistrement est la concaténation de l'id de l'image suivie d'un "-" (tiret) et l'id de l'observation associée.
- id_image : identifiant unique de l'image
- binaire.href : URL vers l'image au format S
- protocoles_votes : [ ],
- mots_cles_texte : "plante entière,plante herbacee",
- observation : {
-- id_observation : identifiant unique de l'observation associée à l'image
-- date_observation : date et heure de l'observation
-- date_transmission : "2013-10-03 01:51:21",
-- determination.famille : famille botanique
-- determination.ns : nom scientifique
-- determination.nn : numéro nomenclatural associé au nom
-- determination.referentiel : "bdtfx",
-- determination.nt : numéro taxonomique associé au nom
-- id_zone_geo : "INSEE-C:09055",
-- zone_geo : "Bethmale",
-- lieudit : "Port de la Core",
-- station : "GR10 Col d Auèdole",
-- milieu : "megaphorbiaie",
-- auteur.id : "15382",
-- auteur.nom : Nom de l'auteur de l'image
-- auteur.prenom : Préom de l'auteur de l'image
-- mots_cles_texte : "Flore des Pyrénées",
-- commentaire : "altitude 1620 m - GR10, en bordure du sentier du Col d Auèdole"