Plant details - flowerchecker/plant-id-examples GitHub Wiki

There is a list of additional information you can get in the response of the /identify or /get_identification_result request. To get specific information, include strings listed bellow in the list of plant_details parameter.

So if you want to get, for example, common names, taxonomy and URL of the suggested plants, this should be in your request: "plant_details": ["common_names", "taxonomy", "url"].

Some details are language-specific, be sure to set the desired language in the plant_language parameter. The value of this parameter is a string with language ISO 639-1 code.

Be aware, that not every plant has all details available!

Plant.id API provide following plant details:

• Common names
• Description from Wikipedia
• Edible/medicinal parts
• GBIF species id
• Propagation methods
• Rank
• Scientific name
• Synonyms
• Taxonomy
• URL
• Watering
• Wikipedia images

Common names

"plant_details": ["common_names"]

The response contains a list of strings with common names of the plant in the language specified in the plant_language parameter.

Output example:

"common_names": ["Common dandelion", "Dandelion"]

Output example for multiple languages (see the parameter plant_languages):

"common_names": {
    "en": ["Common dandelion", "Dandelion"],
    "cs": ["smetánka lékařská"]
}

In English, the 7561 most common plants have at least one common name.

Description from Wikipedia

"plant_details": ["wiki_description"]

The response contains a dictionary with the description of the plant from Wikipedia, source URL, license name and license URL. The description is in the language specified in the plant_language parameter.

You are obliged to state the license info, if you use the description!

Output example:

"wiki_description": {
    "value": "Taraxacum officinale, the common dandelion (often simply called \"dandelion\"), is a flowering herbaceous perennial plant of the family Asteraceae (Compositae).\nIt can be found growing in temperate regions of the world, in lawns, on roadsides, on disturbed banks and shores of water ways, and other areas with moist soils. T. officinale is considered a weed, especially in lawns and along roadsides, but it is sometimes used as a medical herb and in food preparation. Common dandelion is well known for its yellow flower heads that turn into round balls of silver tufted fruits that disperse in the wind.  These balls are called \"blowballs\" or \"clocks\" in both British and American English.",
    "citation": "http://en.wikipedia.org/wiki/Taraxacum_officinale",
    "license_name": "CC BY-SA 3.0",
    "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
}

Output example for multiple languages (see the parameter plant_languages):

"wiki_description": {
    "en": {
        "value": "Taraxacum officinale, the common dandelion (often simply called \"dandelion\"), is a flowering herbaceous perennial plant of the family Asteraceae (Compositae).\nIt can be found growing in temperate regions of the world, in lawns, on roadsides, on disturbed banks and shores of water ways, and other areas with moist soils. T. officinale is considered a weed, especially in lawns and along roadsides, but it is sometimes used as a medical herb and in food preparation. Common dandelion is well known for its yellow flower heads that turn into round balls of silver tufted fruits that disperse in the wind.  These balls are called \"blowballs\" or \"clocks\" in both British and American English.",
        "citation": "http://en.wikipedia.org/wiki/Taraxacum_officinale",
        "license_name": "CC BY-SA 3.0",
        "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
    },
    "cs": {
        "value": "Pampeliška lékařská (Taraxacum officinale auct. non Wigg.), velmi často uváděná pod názvem smetánka lékařská, je běžná rostlina z čeledi hvězdnicovitých. Má nápadné žluté květenství, tzv. úbor, který se posléze mění v plodenství ochmýřených nažek. Pampeliška roste obecně na loukách, u cest a na trávnících, kvete zpravidla od dubna do června a někdy znovu na podzim.",
        "citation": "https://cs.wikipedia.org/wiki/Pampeliška_lékařská",
        "license_name": "CC BY-SA 3.0",
        "license_url": "https://creativecommons.org/licenses/by-sa/3.0/"
    }

In English, the 8413 most common plants have a description.

Edible and medicinal parts

"plant_details": ["edible_parts"]

⚠️ Plant.id does not guarantee the data correctness and is not responsible for any damage or injury caused by the interpretation of the provided information.

The response contains a list of edible/medicinal parts of the plant.

Output example:

"edible_parts": ["fruit", "leaves"]

Possible values: bulb, flowers, frond, fruit, gum, leaves, lichen, mushroom, nectar, nuts, seaweed, seeds, shoots, stems, tubers

GBIF species id

"plant_details": ["gbif_id"]

The response contains the id of the species used at https://www.gbif.org. You can use it to retrieve more information about the plant from GBIF Species API.

Output example:

"gbif_id": "5394163"

Propagation methods

"plant_details": ["propagation_methods"]

The response contains a list of propagation methods.

Output example:

"propagation_methods": ["cuttings", "seeds"]

Possible values:

• cuttings - A piece of the stem or root is cut with clean scissors or a knife and placed in water or a suitable medium (e.g. soil). The cutting later produces new roots or stems and can be placed in soil. Example: Azalea, Ficus, Hibiscus, Tradescantia

• division - The whole plant is divided into two or more parts and potted. This method is typically used in gardening and horticulture. Example: Asters, Chlorophytum, garlic, chives, Nephrolepis exaltata.

• grafting - Parts from different plants are joined together. After the point of joining heals, the plant grows as one plant. Grafting is usually done during winter and early spring. Example: apple, rose, citrus, pear.

• seeds - Most plants can be grown from seeds using various sewing methods. Usually, seeds (purchased or gathered from the plant) are sewn directly into a medium (e.g. soil). (Example: Ficus, chamomile, rose)

• spores - Ferns, Fungi, and Mosses produce spores (unlike flowering plants producing seeds), which can be used for propagation. Spores (gathered or purchased) are sewn into medium (e.g soil or compost). Example: ferns such as Nephrolepis exaltata or Dicksonia antarctica.

• suckers - Some plants produce new shoots or suckers from their roots. These shoots can be removed with roots and potted. Example: blackberries, strawberries, lilac.

Rank

string - taxonomic rank (e.g. species, genus, family, etc.)

Scientific name

"plant_details": ["name_authority"]

The response contains a string with the scientific name of the plant.

Output example:

"name_authority": "Taraxacum officinale F.H.Wigg."

Synonyms

"plant_details": ["synonyms"]

The response contains a list of other names of the plant.

Output example:

"synonyms": [
    "Taraxacum kok-saghyz",
    "Taraxacum vulgare",
    "Taraxacum palustre var. vulgare",
    "Leontodon taraxacum",
    "Leontodon vulgare",
    "Taraxacum almaatense",
    "Taraxacum dens-leonis",
    "Taraxacum vulgare"
]

Taxonomy

"plant_details": ["taxonomy"]

The response contains a dictionary with the plant taxonomy.

Output example:

"taxonomy": {
    "kingdom": "Plantae",
    "phylum": "Tracheophyta",
    "class": "Magnoliopsida",
    "order": "Asterales",
    "family": "Asteraceae",
    "genus": "Taraxacum"
}

URL

"plant_details": ["url"]

The response contains a string with the link to the page with the plant profile (usually Wikipedia or Google).

Output example:

"url": "http://en.wikipedia.org/wiki/Taraxacum_officinale"

Output example for multiple languages (see the parameter plant_languages):

"url": {
    "en": "http://en.wikipedia.org/wiki/Taraxacum_officinale",
    "cs": "https://cs.wikipedia.org/wiki/Pampeliška_lékařská",
    "global": "http://www.plantsoftheworldonline.org/taxon/urn:lsid:ipni.org:names:254151-1"
}

Watering

"plant_details": ["watering"]

The response contains two values - min and max, which represents the range on the following scale of how wet the environment the plant prefers.

• 1 … dry
• 2 … medium
• 3 … wet

This numeric values can be represented with text (e.g. min: 1, max: 2 → dry to medium) or with water symbols (e.g. min: 2, max: 3 → 💧💧–💧💧💧)

If the information for a given species is not available, the value of the watering key is None.

Output example:

"watering": {
        "min": 1,
        "max": 2
    }

Wikipedia images

"plant_details": ["wiki_image"]

The response contains a selected representative image.

"plant_details": ["wiki_images"]

The response contains other images of the plant.

You are obliged to state the license info, if you use images!

Output example:

"wiki_image": {
    "value": "https://storage.googleapis.com/plant_id_knowledge_base/wiki/107/9f466572d46bde1f35e3f55e5763c.jpg", 
    "citation": "Alvesgaspar", 
    "license_name": "CC BY-SA 3.0", 
    "license_url": "https://creativecommons.org/licenses/by-sa/3.0"
},  
"wiki_images": [
    {
        "value": "https://storage.googleapis.com/plant_id_knowledge_base/wiki/78b/7e2998bb60775419ec69423eb6f5c.jpg", 
        "citation": "RogerR00", 
        "license_name": "CC BY-SA 3.0", 
        "license_url": "https://creativecommons.org/licenses/by-sa/3.0"
    }, 
    { ... },
    { ... },
]