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

---

Web Service fournissant les déterminations les plus probables des images

Ce web service fournit la liste des images associées à leur détermination la plus probable, c'est à dire avec le nom associé à la proposition la plus votée dans identiplante, ou bien le nom initialement associé à l'observation si aucune proposition n'a été faite.
Il peut également opérer un classement sur les images les mieux notées suivant un protocole donné

Urls

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

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

- masque.protocole : permet de spécifier un numéro de protocole de vote pour restreindre les résultats renvoyés
- masque.valeur_vote_min : permet de ne renvoyer que les images ayant une moyenne des votes supérieure ou égale à ce qui est spécifié dans le paramètre
(si masque.protocole est spécifié, seul les votes concernant ce protocole seront pris en compte).
- navigation.depart : permet de spécifier le tuple de départ de l'intervalle de résultat à renvoyer
- navigation.limite : permet de spécifier le nombre de résultats à renvoyer

Exemples

- Les 50 premières images notées 4 étoiles ou plus sur le protocole défi photo
http://api.tela-botanica.org/service:del:0.1/determinations/images-determinations-probables?masque.protocole=4&masque.valeur_vote_min=4&navigation.depart=0&navigation.limite=50

Format de retour

Le type de retour est un objet JSON.
Exemple

{
    "entete": {
        "masque": "masque.protocole=4&masque.valeur_vote_min=4",
        "total": 281,
        "depart": "0",
        "limite": "3",
        "href.suivant": "http://api.tela-botanica.org/del/services/0.1/determinations/images-determinations-probables?masque.protocole=4&masque.valeur_vote_min=4&navigation.depart=3&navigation.limite=3"
    },
    "resultats": {
        "50292-385843": {
            "id_image": "50292",
            "id_observation": "385843",
            "auteur.intitule": "Prénom NOM",
            "binaire.href": "http://api.tela-botanica.org/img:000050292S.jpg",
            "determination.famille": "Pinaceae",
            "determination.ns": "Pinus halepensis Mill.",
            "determination.nn": "75290",
            "determination.nt": "30282",
            "date_observation": "2011-10-30 00:00:00",
            "localite": "Marseille (13)",
            "mots_cles_image_cel": " ",
            "mots_cles_image_del": "laureat2012",
            "url_fiche_eflore": "http://www.tela-botanica.org/nn75290"
        }
}

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
- id_observation : identifiant unique de l'observation associée à l'image
- auteur.intitule : Prénom et nom de l'auteur de l'image
- binaire.href : URL vers l'image au format S
- determination.famille : famille botanique du nom le plus probablke
- determination.ns : nom scientifique le plus probable
- determination.nn : numéro nomenclatural associé au nom
- determination.nt : numéro taxonomique associé au nom
- date_observation : date et heure de l'observation
- localite : localité de l'observation associée à l'image
- mots_cles_image_cel : mots clés associés à l'image par sont auteur
- mots_cles_image_del : mots clés associés à l'image par les participants à travers l'interface de l'application détermination en ligne
- url_fiche_eflore : url de la fiche eflore associée au numéro mentionné dans determination.nn

---