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

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.

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