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_cel" à l'aide de la requête SQL suivante:

CREATE ALGORITHM=UNDEFINED DEFINER=`root`@`localhost` SQL SECURITY DEFINER VIEW `del_plantnet` AS
SELECT `o`.`id` AS `id_observation`,
`o`.`plantnet_id` AS `plantnet_id`,
`o`.`user_id` AS `ce_utilisateur`,
`o`.`user_email` AS `courriel_utilisateur`,
`o`.`user_sci_name` AS `nom_sel`,
`o`.`user_sci_name_id` AS `nom_sel_nn`,

• `o`.`accepted_sci_name` AS `nom_ret`,
• `o`.`accepted_sci_name_id` AS `nom_ret_nn`,

`o`.`family` AS `famille`,
`o`.`taxo_repo` AS `nom_referentiel`,

• `o`.`geometry` AS `zone_geo`,

`o`.`elevation` AS `altitude`,
`o`.`date_observed` AS `date_observation`,
`o`.`date_created` AS `date_created`,
`o`.`date_updated` AS `date_updated`,
`o`.`date_published` AS `date_published`,
`o`.`is_wild` AS `is_wild`,
`o`.`identiplante_score` AS `identiplante_score`,
`o`.`is_identiplante_validated` AS `is_identiplante_validated`,
`cel_photo_tag`.`name` AS `cel_photo_tag`,
`ph`.`id` AS `id_image`,

• `ph`.`user_id` AS `i_ce_utilisateur`,
• `ph`.`original_name` AS `original_name`,

`ph`.`date_shot` AS `i_date_shot`,

• `ph`.`date_updated` AS `i_date_updated` FROM
• (`tb_new_cel`.`occurrence` `o`
• join `tb_new_cel`.`photo` `ph` on(`o`.`id` = `ph`.`occurrence_id`)
• join `tb_new_cel`.`photo_tag_photo` `ptp` on(`ph`.`id` = `ptp`.`photo_id`)
• join `tb_new_cel`.`photo_tag` `cel_photo_tag` on(`cel_photo_tag`.`id` = `ptp`.`photo_tag_id`)

) WHERE `o`.`is_public` = '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 par défaut),
navigation.depart
ordre (DESC 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": "3606891",
            "plantnet_id": null,
            "auteur_courriel": "delphine@tela-botanica.org",
            "mots_cles_obs_cel": "messicoles",
            "date_observation": "2021-04-06 00:00:00",
            "date_creation": "2021-04-06 16:40:44",
            "date_changement": "2023-11-16 13:42:39",
            "date_publication": "2021-04-06 16:40:44",
            "is_wild": "1",
            "identiplante_score": "0",
            "is_identiplante_validated": "0",
            "nom_sel": "Delphinium consolida L. [1753]",
            "nom_sel_nn": "21796",
            "nom_referentiel": "bdtfx",
            "nom_ret": "Delphinium consolida L. [1753]",
            "nom_ret_nn": "21796",
            "famille": "Ranunculaceae",
            "zone_geo": "{\"type\":\"Point\",\"coordinates\":[3.184884,50.6998]}",
            "altitude": "31",
            "images": [
                {
                    "id_image": "2318461",
                    "nom_image": "logopharmacopeemarocaine.jpg",
                    "image_updated": "2021-04-06 16:40:49",
                    "url": "https://api-test2.tela-botanica.org/img:002318461O.jpg",
                    "votes": [
                        0
                    ],
                    "tags": [
                        "fleur"
                    ]
                },
                {
                    "id_image": "2318462",
                    "nom_image": "logohommesetplantes113.jpg",
                    "image_updated": "2021-04-06 16:40:49",
                    "url": "https://api-test2.tela-botanica.org/img:002318462O.jpg",
                    "votes": [
                        0
                    ],
                    "tags": [ ]



}
]
}


}</pre>""