Skip to main content

Field imagery

The Field Imagery API enables you to visualize your area of interest, offering options such as natural color or various vegetation indices for enhanced analysis.

parameterdescriptionis required
view_ida view_id parameter for "search scene" steprequired
indexany indices for supported bands, check out the Reference informationrequired
formatchoose an image format that you need. supported formats: .tiff, .jpeg, .png, default: .tiffrequired
callback_urlcallback URL for the endpoint responseoptional

Download field image for vegetation indices​

Index images can be downloaded using the API, for this a view id and a field id are needed.

Step 1:​
curl --location --request POST 'https://api-connect.eos.com/field-imagery/indicies/9793351' \
--data '{
"params": {
"view_id": "S2/13/R/EL/2023/5/20/0",
"index": "NDVI",
"format": "png"
},
"callback_url": "https://test.local"
}'

For this end point it is needed to specify the view id, index type and image format in the body of the request as well as the field id in the last part of the end point.

Response:

{
"status": "created",
"request_id": "1fdc2c26-c9dc-4483-aa12-a4f28d0b7678"
}
Step 2:​

Use the request_id returned in the answer of the previous end point and replace it by the end of this endpoint to get the results of the search

curl --location --request GET 'https://api-connect.eos.com/field-imagery/9793351/1fdc2c26-c9dc-4483-aa12-a4f28d0b7678' \
--header 'x-api-key: <your_api_key>'

Response:

Field NDVI image example