Plantnet


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

Web Service exportant nos obs pour la synchro avec Pl@ntNet


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

Urls


prod :
http://api.tela-botanica.org/service:del:0.1/plantnet

test:
http://api-test.tela-botanica.org/service:del:0.1/plantnet

Création vues en bdd (Pour dev interne à Tela)

Pour fonctionner le webService à besoin de la vue del_plantnet.

Elle doit être créee dans la bdd "tb_del" à l'aide de la requête SQL suivante:
CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `del_plantnet`  AS 
SELECT `o`.`id_observation` AS `id_observation`, 
`o`.`id_plantnet` AS `id_plantnet`, 
`o`.`ce_utilisateur` AS `ce_utilisateur`, 
`o`.`courriel_utilisateur` AS `courriel_utilisateur`, 
`o`.`nom_sel` AS `nom_sel`, 
`o`.`nom_sel_nn` AS `nom_sel_nn`,
 `o`.`nom_ret` AS `nom_ret`, 
 `o`.`nom_ret_nn` AS `nom_ret_nn`, 
`o`.`famille` AS `famille`, 
`o`.`nom_referentiel` AS `nom_referentiel`,
 `o`.`geometry` AS `zone_geo`,
`o`.`latitude` AS `latitude`,
`o`.`longitude` AS `longitude`,
`o`.`date_observation` AS `date_observation`, 
`o`.`date_creation` AS `date_created`, 
`o`.`date_modification` AS `date_updated`, 
`o`.`date_transmission` AS `date_published`, 
`o`.`type_donnees` AS `type_donnees`, 
`o`.`score_identiplante` AS `identiplante_score`, 
`o`.`validation_identiplante` AS `is_identiplante_validated`, 
`o`.`mots_cles_texte` AS `mots_cles_cel_obs`, 
`o`.`programme` AS `programme`, 
`i`.`id_image` AS `id_image`,
`i`.`mots_cles_texte` AS `mots_cles_cel_image`,
 `i`.`nom_original` AS `original_name`, 
`i`.`date_prise_de_vue` AS `i_date_shot`,
`i`.`date_creation` AS `i_date_creation`,
 `i`.`date_modification` AS `i_date_updated` 
FROM
 (`tb_new_cel`.`cel_export_total` `o`
 join `tb_new_cel`.`cel_images_export` `i` on(`o`.`id_observation` = `i`.`ce_observation`)
) WHERE `o`.`transmission` = '1'  ;

On doit également créer la vue del_plantnet_images:
CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `del_plantnet_images`  AS 
SELECT 
`o`.`id_observation` AS `id_observation`, 
`o`.`id_plantnet` AS `id_plantnet`, 
`o`.`ce_utilisateur` AS `ce_utilisateur`, 
`i`.`id_image` AS `id_image`,
`i`.`mots_cles_texte` AS `mots_cles_cel_image`,
 `i`.`nom_original` AS `original_name`, 
`i`.`date_prise_de_vue` AS `i_date_shot`,
`i`.`date_creation` AS `i_date_creation`,
 `i`.`date_modification` AS `i_date_updated` 
FROM
 (`tb_new_cel`.`cel_export_total` `o`
 join `tb_new_cel`.`cel_images_export` `i` on(`o`.`id_observation` = `i`.`ce_observation`)
) WHERE `o`.`transmission` = '1'  ;

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.

Fonctionne avec une clé API à rajouter dans le fichier config.ini sous la forme:
[api]
key = maSuperClé

Cette clé doit être intégré dans le header $_SERVER['HTTP_API_KEY'] lors de l'appel au webService

Paramètres principaux

date.debut (unixtime en secondes, par exemple: http://api.tela-botanica.org/service:del:0.1/plantnet?date.debut=1700482694)
date.fin (unixtime en secondes, par exemple: http://api.tela-botanica.org/service:del:0.1/plantnet?date.fin=1700664300),
navigation.limite (10 images par défaut),
navigation.depart
ordre (par date_changement, asc par défaut)

Exemples

Observations du 28/04/2023 au 28/11/2023
http://api.tela-botanica.org/service:del:0.1/plantnet?navigation.depart=10&date.debut=1682675091&date.fin=1701168291

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/plantnet?date.debut=1682675091&date.fin=1701168291&navigation.depart=10&navigation.limite=10"
    },
    "resultats":  {
            "id_observation": "3634932",
            "id_plantnet": null,
            "auteur_courriel": "julien@tela-botanica.org",
            "mots_cles_cel_obs": "port, feuille, Projets coopératifs, ",
            "programme": null,
            "date_observation": "2023-05-16 12:00:00",
            "date_creation": "2023-05-17 09:48:08",
            "date_changement": "2023-11-23 13:32:41",
            "date_publication": "2023-11-17 11:13:26",
            "type_donnees": "observation de terrain",
            "identiplante_score": "6",
            "is_identiplante_validated": "0",
            "nom_sel": "Mentha L. [1753]",
            "nom_sel_nn": "86784",
            "nom_referentiel": "bdtfx",
            "nom_ret": "Mentha L. [1753, Sp. Pl., 2 : 576]",
            "nom_ret_nn": "86784",
            "famille": "Lamiaceae",
            "zone_geo": null,
            "latitude": "45.67611",
            "longitude": "4.82167",
            "images": [
                {
                    "id_image": "2321013",
                    "nom_image": "000_010_453_O.jpg",
                    "image_updated": "2023-09-07 14:35:17",
                    "date_shot": "2023-09-07 14:35:15",
                    "mots_cles_cel_image": "bota10km, messicoles",
                    "url": "https://api-test2.tela-botanica.org/img:002321013O.jpg",
                    "votes": {
                        "moyenne_votes": "2",
                        "nb_votes": "1",
                        "nb_points_votes": "10"
                    },
                    "del_tags": [
                        "ecorce",
                        "feuille",
                        "flou",
                        "planche",
                        "port",
                        "pousse",
                        "rameau"
                    ]
                }
            ],
            "determinations": {
                "9916": {
                    "nom_sel": "Mentha L. [1753]",
                    "nom_ret": "Mentha L. [1753, Sp. Pl., 2 : 576]",
                    "score": 3,
                    "nn": "86784"
                }
            }
        }
}