Overview

About

Using Leaf's Satellite service you will be able to easily implement a satellite imagery application and compare the field health evolution over time. Leaf's service uses Sentinel-2 data which has the highest resolution publicly available and revisits each field every 3 to 5 days.

You can get historical images with Leaf.

By default, Leaf retrieves images from 30 days prior to the creation of your field. But you can increase that to as far back in time as you want. Here's how

Field example

This API accepts field boundary polygons and returns processed, cropped, and color-corrected RGB and NDVI images every time there is a new image available. We also provide information like percent cloud coverage of the field, the data coverage percentage, and the Sentinel tile source for each image as well.

We generate a total of 19 images for each intersected field: A GeoTiff for each band from Sentinel and processed RGB and NDVI images.

The following table shows all the images with its resolutions and types: (TIFs are EPSG:4326, PNGs are EPSG:3857).

NameResolutionTypeProjection
NDVI.pngNULLpng ndviEPSG:3857
RGB.pngNULLpng RGBEPSG:3857
NDVI.tif10tif raw ndvi valuesEPSG:4326
NDVI_color.tif10tif colored ndviEPSG:4326
RGB.tif10tif RGBEPSG:4326
B01.tif60 meterssingle bandEPSG:4326
B02.tif10single bandEPSG:4326
B03.tif10single bandEPSG:4326
B04.tif10single bandEPSG:4326
B05.tif20single bandEPSG:4326
B06.tif20single bandEPSG:4326
B07.tif20single bandEPSG:4326
B08.tif10single bandEPSG:4326
B8A.tif20single bandEPSG:4326
B09.tif60single bandEPSG:4326
B11.tif20single bandEPSG:4326
B12.tif20single bandEPSG:4326
NDVI_relative.pngNULLpng relative ndviEPSG:3857
NDVI_absolute.pngNULLpng absolute ndviEPSG:3857

PNG files do not have resolution because they are scaled up by 800%.

We generate a colorized NDVI_color.tif using a custom-built color ramp. See the image below. If you prefer to use your own ramp, we recommend using NDVI.tif, which is a pre calculated NDVI file. You can import it into any GIS software, like QGis, and use it as you please.

In addition, you will get the NDVI (i.e., we call them at Leaf as NDVI_relative.png, NDVI_absolute.png and NDVI.png) cut for your area of interest. The NDVI relative uses the minimum and maximum of the image of that date and, therefore, you would have a color scale to better visualize the differences of your harvest for that specific moment, whereas, the NDVI absolute and NDVI, whose range goes from -1 to 1, you can make comparisons on different dates, the difference between these files are the color ramp applied (i.e., in the NDVI all the values below 0 are bright red while in the NDVI absolute the color ramp begins at -1 as the bright red and the value 1 as the bright green inteporlated in between).

NDVI example: Left - NDVI relative, Center - NDVI absolute, Right - NDVI

Left - NDVI relative. Center - NDVI absolute. Right - NDVI.
We recommend using the Right one (just ndvi.png)

Currently, our Satellite service runs without a relationship between our Field Services, and the User Management Services. However, we are working to integrate it into the leafUser hierarchy, and the Fields Service.

See the Satellite API Reference for more information.