FAQ for Plant.id API
Most frequent questions and answers
Effective use of API
- How to increase identification accuracy?
- How to increase identification speed?
- I can’t see any similar_images in the get_identification_result response
API response content
- What kind of plants can you identify?
- What does the “similar images” feature do?
- What is the difference between the plant_name and the plant_details.scientific_name?
- What is the license of the content you provide?
- What is the content coverage in language-independent plant details?
- What is the content coverage in my language?
Effective use of API
How to increase identification accuracy?
- Include multiple photos of a single plant in the plant identification request.
- Include GPS coordinates.
- There is a list of parameters (see
modifiersin /identify or /enqueue_identification endpoints), which enable you to trade off the accuracy for identification speed. However, it is not allowed by default; contact us if you need help.
- The default model is very general. However, we can create a specific model explicitly focused on your use case – for example, Mediterranean crops, Canadian weeds, or European trees. We can even use your own datasets to improve the model, for example, with satellite images. We can also train a customized new model, focused, for example, on estimation of the plant’s health.
How to increase identification speed?
In the administration, you can see an identification time (guaranteed by the SLA) per each request. This time value, however, does not account for image preprocessing (downscaling the resolution). That is the reason why the measured response time is higher than the identification time.
You can mitigate this delay by resizing the image on your side. To get the fastest response, set the photos’ size so that the longer side has 800 px. You can also use an /identify endpoint to get the identification directly into the response to your request to gain a second or two.
In special cases, it might be worth asking us on firstname.lastname@example.org for a dedicated ML model (we might be able to go under 1 second).
API response content
What kind of plants can you identify?
Our machine learning model is mainly based on photos we have gathered running FlowerChecker in the past six years. The data contain photos of wild-growing, garden, and indoor plants.
We can currently identify more than 12 000 plant species of various life forms, including trees, shrubs, and succulents. Besides, our database consists of the most common mushrooms, lichens, and mosses.
The map above highlights the countries from which we have the most images in our training data set. You will get best identification results for the common plants in the dark blue countries.
What does the “similar images” feature do?
This is actually our most innovative feature!
You see – name of the plant is not the only piece of information you will get from the API. We also provide representative images of a suggested taxon (species or genus).
The representative images are not static; they are selected based on the similarity with photos uploaded by your customer to achieve user satisfaction. Let us illustrate:
There are three different identifications of three different photos of a dandelion. The first one shows a puffy ball with seeds, the second one a leaf rosette, and the third one a plant in full bloom. As you can see, the Plant.id provides representative images of a dandelion based on the user’s picture. You are welcome to use our images in your app. What a great tool to improve user’s satisfaction with your service!
What is the difference between different plant names?
Plant.id API results give you four types of records related to plant names for a single taxon suggestion (taxon is the basic unit in the taxonomy hierarchy)
- plant_name is a string that conclusively indicates the result of the identification. It is basically an ID which we are striving to keep unchanged across all Plant.id versions. Therefore, you can use it as a key for linking other in-app content.
Example: “Taraxacum officinale”
- plant_details.scientific_name stands for a scientific name (in Latin). It is the taxon name currently accepted by botanists.
Example: “Taraxacum campylodes G. E. Haglund”
- plant_details.synonyms lists other scientific names for the same species, if there are any. They are also considered correct but usually outdated because of nomenclature changes. See the explanation on Wikipedia.
Example: [“Taraxacum vulgare var. vulgare”, ”Taraxacum vulgare (Lam.) Schrank”, …].
If you want to attach your own content to the suggested plant name, we recommend using not only plant_details.scientific_name but also all plant_details.synonyms to find as many matches in your database as possible.
TLDR botanical authorities change scientific names sometimes. The plant_details.scientific_name reflects the present taxonomy consensus. The class name plant_name is not to be changed that often to keep the API as stable as possible.
What is the license of the content you provide?
Generally, we provide mostly public domain content to our clients. The only exceptions are similar images. In ~ 30% of the cases there are images under the CC-BY license, which requires to mention the author name and license name together with the image. Sometimes the license also doesn’t allow any kind of remixing (indicated by SA element).
We made sure that all of the content is allowed to be used for commercial purposes. The details about the license can be found in our Terms and Conditions.
We are currently working with no more than these licenses:
- CC BY 2.0, CC BY 2.5, CC BY 3.0, CC BY 4.0
- CC BY-SA 2.0, CC BY-SA 2.5, CC BY-SA 3.0, CC BY-SA 4.0
What is the content coverage in language-independent plant details?
The following table shows the content coverage for plants in our database.
|taxonomy – class||100.00%|
|taxonomy – family||99.98%|
|taxonomy – genus||100.00%|
|taxonomy – kingdom||100.00%|
|taxonomy – order||100.00%|
|taxonomy – phylum||100.00%|
What is the content coverage in my language?
Some information (description, common name) is language-dependent. You can set the preferred language in your request (English is the default). See the coverage (for how many plants from our database we provide this information) in the top 20 languages. We support other languages too. If you are interested in coverage in your language, ask us at email@example.com.
What is the pricing?
The base pricing is €0.05 per identification. There are discounts for bulk orders. The final price also depends on the identification speed and accuracy. Please contact us at firstname.lastname@example.org to discuss these issues.