Hydro‑Quebec’s tree and shrub directory

## Description Ensemble de données d’Hydro‑Québec sur plus de 1 700 espèces et variétés de plantes du Québec. Il permet de rechercher un arbre ou un arbuste selon des caractéristiques précises, comme l’exposition à la lumière, la zone de rusticité, la hauteur à maturité, etc. De plus, à chaque espèce et variété de plante est associée la distance de plantation sécuritaire à respecter en présence de fils moyenne tension. Ces données peuvent être utiles pour : * les résidents qui ont à choisir des arbres et arbustes ainsi qu’à déterminer leur emplacement par rapport aux lignes de distribution électriques ; * les professionnels comme les pépiniéristes, les horticulteurs et les aménagistes paysagers ; * les responsables de la planification de programmes de remplacement d’arbres ; * les personnes chargées de la planification et de la réalisation de travaux à proximité d’arbres existants. [Voir l’outil pour choisir le bon arbre ou arbuste d’Hydro-Québec, d’où provient l’ensemble de données. ] ## Conditions particulières pour cet ensemble de données L’utilisateur doit obligatoirement : * afficher la distance de plantation sécuritaire pour chaque essence d’arbre et d’arbuste (paramètre «plantationDistanceMinimum») ; * créer un hyperlien vers la page [Comment mesurer la distance de plantation sécuritaire indiquée dans l’outil Choisir le bon arbre ou arbuste]. ## Fichiers ou services L’accès aux données ouvertes s’effectue au moyen d’hyperliens paramétrés sur une interface API (pour application programming interface). Pour en savoir plus sur le sujet, consulter le site de [Données Québec]. ## 1. Afficher des fiches ### Ensemble des fiches d’arbres et d’arbustes Pour obtenir les données de toutes les fiches triées selon le nom latin (en ordre croissant), aucun paramètre n’est requis : https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/tous Méthode : GET Exemple de données d’une fiche : [ { "numeroFiche": "5438", "nomLatin": "Abelia x grandiflora", "nomFrancais": "Abélia grandiflora", "nomAnglais": "Glossy Abelia", "plantationDistanceMinimum": "0,0 m", "type": "Feuillu", "zoneRusticite": "5b", "remarquesFicheDeBase": "peu adapté au climat ; peu rustique ; endroits chauds et abrités des vents ; peu disponible", "hauteur": 0.8, "largeur": 1.2, "croissance": null, "famille": null, "aspect": null, "usages": null, "solType": null, "feuillesDescription": null, "fleursDescription": null, "fruitsDescription": null, "solCompactage": null, "selDeglacage": null, "taille": null, "enracinement": null, "maladies": null, "insectes": null, "remarquesFicheComplete": "peu adapté au climat ; peu rustique ; endroits chauds et abrités des vents ; peu disponible", "ecorceDescription": null, "varietesHorticoles": null, "formes": [ "Petit arbuste", "Arbuste" ], "expositionsLumiere": [], "solHumidites": [], "solTextures": [], "solPhs": [], "urlPhotoArbre": null, "urlPhotoPoteau": null, "urlPhotoFeuille": null, "urlPhotoFleur": null, "urlPhotoFruit": null, "urlPhotoEcorce": null } ] ### Nombre restreint de fiches parmi un ensemble Ajouter les paramètres {indexDeDépart} et {nombreElementsARcuperer} pour obtenir les données d’un certain nombre de fiches triées selon le nom latin (en ordre croissant) à partir d’un index de départ. https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/partiel/{indexDeDépart}/{nombreElementsARcuperer} Méthode: GET À noter que ces deux paramètres doivent être utilisés en combinaison : si « indexDeDépart » est ajouté à l’URL, il faut également préciser « nombreElementsARcuperer », et vice-versa. Sinon, l’interface API signalera une erreur. Exemple d’URL pour obtenir les données de 15 fiches à partir de la deuxième de la liste : https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/partiel/2/15 Extrait des données obtenues : [ { "numeroFiche": "4582", "nomLatin": "Abies balsamea", "nomFrancais": "Sapin baumier", "nomAnglais": "Balsam Fir Balm of Gilead", "plantationDistanceMinimum": "5,0 m", "type": "Conifère", "zoneRusticite": "1a", "remarquesFicheDeBase": null, "hauteur": 20, "largeur": 7, "croissance": "lente", "famille": "Pinacées", "aspect": null, "usages": "isolé, massif et naturalisation ; utilisé comme arbre de Noël", "solType": "isolé, massif et naturalisation ; utilisé comme arbre de Noël", "feuillesDescription": "aiguilles aplaties et aromatiques ; 1,5 à 2,5 cm de longueur\n\nÉté ; vert foncé avec deux petites lignes blanches en dessous\n\nAutomne ; vertes", "fleursDescription": "Couleur : mâles : rouge jaunâtre avec des reflets pourpres ; femelles : jaunâtres dans la cime de l’arbre ; les deux sans intérêt ornemental", "fruitsDescription": "cônes érigés et résineux ; 5 à 7 cm de longueur ; développement complet en une année ; axe central persistant après maturation\n\nCouleur ; bruns\n\nSaison ; automne", "solCompactage": "Grande", "selDeglacage": "Faible", "taille": null, "enracinement": "superficiel ; plantation facile des jeunes plants, planter en motte les plus âgés", "maladies": "peu de problèmes pathologiques", "insectes": "sensibilité moyenne à élevée ; puceron lanigère, tordeuse des bourgeons de l’épinette", "remarquesFicheComplete": null, "ecorceDescription": null, "varietesHorticoles": "Abies balsamea ‘Piccolo’ - Sapin baumier Piccolo : feuillage dense vert bleuté ; croissance très lente ; 0,2 m x 0,4 m ; espacement requis : sans restriction", "formes": [ "Grand arbre" ], "expositionsLumiere": [ "Soleil", "Mi-ombre" ], "solHumidites": [ "Moyenne", "Faible" ], "solTextures": [ "Loameuse", "Sablonneuse" ], "solPhs": [ "Très acide", "Acide", "Légèrement acide" ], "urlPhotoArbre": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/8759", "urlPhotoPoteau": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/10014", "urlPhotoFeuille": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/10550", "urlPhotoFleur": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/11098", "urlPhotoFruit": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/11657", "urlPhotoEcorce": "arbres.hydroquebec.com/public/api/v1.0.0/arbres/rechercher/image/12025" }, { "numeroFiche": "4584", "nomLatin": "Abies balsamea ‘Nana’", "nomFrancais": "Sapin baumier nain", "nomAnglais": "Dwarf Balsam Fir", "plantationDistanceMinimum": "0,0 m", "type": "Conifère", "zoneRusticite": "4a", "remarquesFicheDeBase": null, "hauteur": 0.6, "largeur": 1, "croissance": "lente", "famille": "Pinacées", ... } ] ### Fiche particulière Pour obtenir les données d’une fiche, ajouter le numéro correspondant à la fin de l’URL. URL :https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/arbre/{id} Méthode: GET Affiche les informations de la fiche dont le numéro est donné en paramètre. Exemple : https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/arbre/4542 ## 2. Effectuer des recherches selon des critères ### Signification de tous les libellés Le tableau ci-dessous montre les valeurs permises pour chaque critère de recherche. À noter que tout champ de paramètre peut rester vide. ─────────────────────────────┬───────────────────┬──────────────────────────────────────────────────────────────────────── Critère │Valeur │Description ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── rechercheParNom │[champ texte libre]│ ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── type │c │Conifère ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── type │f │Feuillu ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── type │cf │Conifère ou feuillu ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── distancePlantationSecuritaire│[x],[x] │Mesure en mètre, de 0 à 14,5 mètres par incréments de 0,5. │ │exemple : 1,5 ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │0b │0b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │1a │1a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │1b │1b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │2a │2a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │2b │2b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │3a │3a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │3b │3b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │4a │4a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │4b │4b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │5a │5a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │5b │5b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │6a │6a ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── zoneRusticite │6b │6b ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │grimpant │Grimpant ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │arbuste-rampant │Arbuste rampant ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │petit-arbuste │Petit arbuste ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │arbuste │Arbuste ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │arbrisseau │Arbrisseau ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │petit-arbre │Petit arbre ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │moyen-arbre │Arbre moyen ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── forme │grand-arbre │Grand arbre ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── expositionLumiere │soleil │Soleil ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── expositionLumiere │mi-ombre │Mi-ombre ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── expositionLumiere │ombre │Ombre ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │-1 │moins de 1 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │1a1,9 │de 1 m à 1,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │2a2,9 │de 2 m à 2,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │3a4,9 │de 3 m à 4,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │5a6,9 │de 5 m à 6,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │7a9,9 │de 7 m à 9,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │10a14,9 │de 10 m à 14,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── hauteur │+15 │15 m et plus ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │-1 │moins de 1 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │1a1,9 │de 1 m à 1,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │2a2,9 │de 2 m à 2,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │3a4,9 │de 3 m à 4,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │5a6,9 │de 5 m à 6,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │7a9,9 │de 7 m à 9,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │10a13,9 │de 10 m à 13,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── largeur │+14 │de 10 m à 13,9 m ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── humiditeSol │elevee │Élevée ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── humiditeSol │moyenne │Moyenne ─────────────────────────────┼───────────────────┼──────────────────────────────────────────────────────────────────────── humiditeSol │faible │Faible ─────────────────────────────┴───────────────────┴──────────────────────────────────────────────────────────────────────── Il est aussi possible d’obtenir la liste de toutes les valeurs possibles par critère de recherche. URL : https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/formulaire/parametres Méthode : GET ### Recherche selon les onze critères possibles À l’aide des valeurs définies dans le tableau précédent, il est possible d’effectuer des recherches selon les critères suivants : * rechercheParNom * type * distancePlantationSecuritaire * zoneRusticite * forme * expositionLumiere * hauteur * largeur * humiditeSol URL : https://arbres.solutions.hydroquebec.com/public/api/v1.0.0/arbres/fr/rechercher/par-criteres Méthode : POST Exemple 1 : rechercheParNom=sapin type=c Cette recherche permet d’accéder à toutes les fiches triées selon le nom latin qui comportent le mot « sapin » dans le nom français, anglais ou latin, de type conifère. Exemple 2 : humiditeSol=moyenne zoneRusticite=4a expositionLumiere=mi-ombre distancePlantationSecuritaire=5 forme=arbuste Cette recherche permet d’obtenir toutes les fiches triées selon le nom latin qui ont une humidité du sol « moyenne », une zone de rusticité « 4A », une exposition à la lumière de type « mi-ombre », une distance de plantation sécuritaire de 5 m et une forme « arbuste ». Exemple 3 : hauteur=2a2,9 Cette recherche permet d’accéder à toutes les fiches d’arbres et d’arbustes ayant de 2 à 2,9 m de haut. ### Nombre de fiches trouvées selon les neuf critères possibles Pour obtenir le nombre de fiches par critère, ajouter le critère correspondant comme paramètre. URL : http://arbres.hydroquebec.com/public/api/v1.0.0/arbres/fr/compter/par-criteres Méthode : POST Critères de recherche * rechercheParNom * type * distancePlantationSecuritaire * zoneRusticite * forme * expositionLumiere * hauteur * largeur * humiditeSol ## Renseignements additionnels * Éditeur/Auteur : Hydro‑Québec * Fréquence de mise à jour : aucune prévue à court terme * Langues : français * Couverture géographique : province de Québec * Dernière modification : 2017-12-18 * Diffusion initiale : 2017-12-18 * Licence : [Creative Commons CC-BY 4.0] * Notices et conditions d’utilisation : * L’utilisateur doit obligatoirement afficher la distance de plantation sécuritaire pour chaque essence d’arbre et d’arbuste (paramètre «plantationDistanceMinimum») * L’utilisateur doit créer un hyperlien vers cette page : [Information pour mesurer la distance de plantation sécuritaire par rapport à une ligne de distribution]. ### Communiquez avec nous Vous pouvez communiquez avec l'équipe des Données ouvertes en complétant le [formulaire de contact].