Répertoire d’arbres et d’arbustes d’Hydro‑Québec

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
    }
]

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",
        ...
      }
]

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

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

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

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