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 :

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.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.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.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.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.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.

Signification de tous les libellés
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.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.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 :