Skip to main content

Canopy cover percentages

The AgroAPI can give you the percentage of the cropzone area that is directly covered with tree crowns.
Subscribers to this feature are able to calculate the canopy cover percentages of their fields over time.

An AgroAPI token is required. If you don't have a token yet please contact support@listenfield.com.

Getting the canopy cover percentages of already registered fields​

The percentages are computed automatically whenever a new NDVI is downloaded.
So the only thing you need is using the AgroAPI to fetch your cropzones.

import axios from "axios";

axios.get(
  "https://agro.api.listenfield.com/organizations/e5a757a2-191a-4005-8be7-54ee6854c9df/cropzones.json?page=1",
  {
    headers: {
      Authorization: `Bearer {YOUR_API_TOKEN}`,
    },
  }
);
API Response
[
    {
        "type": "Feature",
        "properties": {
            "id": "930e30d3-2e79-4ad1-95d8-d3b36c882e37",
            "name": "Field 62",
            "area": 664510,
            "note": null,
            "location": {
                "centroid": {
                    "type": "Point",
                    "coordinates": [
                        -75.4554374799892,
                        33.51734822355701,
                        0
                    ]
                }
            },
            "start_date": "2021-03-17T00:00:00Z",
            "end_date": null,
            "crop": {
                "id": "5f0b6cc9-2a76-4f44-9c53-a79d48feae0b",
                "name": "potato",
                "canonical_name": "potato",
                "variety": "generic"
            },
            "field_id": "fdc31ce8-5554-4f78-8ec4-bf4bc7186e6e",
            "field": {
                "id": "fdc31ce8-5554-4f78-8ec4-bf4bc7186e6e",
                "name": "Field 62"
            },
            "activities_count": 1,
            "predicted": {
                "maturity_date": null,
                "harvest": "",
                "yield": ""
            },
            "next_cropzone": null,
            "prev_cropzone": null,
            "archived_at": null,
            "created_at": "2021-12-02T06:32:29Z",
            "updated_at": "2022-06-02T03:29:04Z",
            "canopy_cover_percentages": {
                "5": 3.591718766794501,
                "10": 4.775858471791574,
                "15": 6.23969299991171,
                "20": 8.071594545519604,
                "25": 11.304551967040888,
                "30": 19.408519126056103,
                "35": 36.955204437540154,
                "40": 61.636445020533046,
                "45": 82.71438871727787
            }
        }
    }
]

The API supports pagination. You'll get 50 fields for every page. You can provide the page with the ?page= parameter.
As you can see there is a canopy_cover_percentages key in the geojson returned. This is a json object with Days After Plantation (DAP) as keys, and for each DAP the value is provided (in %).

You can call this endpoint regularly to get the new canopy cover percentages as they are updated.

What if the field is not yet in FarmAI?​

If the field is not yet in farmAI, you have to insert it. See the Full Journey tutorial. You need to create fields and cropzones. The canopy cover percentage is only available on the cropzone (in most cases you may have only one cropzone per field, that's expected).