Skip to main content

Imagery API

Download API provides functionality to obtain visualizations of a specified area of interest, supporting options like natural color or various indices. Explore all potential band combinations, formulas, and supported bands for different datasets in our documentation here.

Example: Download image of the NDVI from Sentinel2 from the AOI

curl --location --request GET 'https://api-connect.eos.com/api/gdw/api/5144aaff-f442-4b18-b20f-7c239ac15a3f' \
--header 'x-api-key: <your_api_key>'
Example banner
Custom colormap

You can create custom colormap with Colormap endpoint


Download API workflow contains of two steps:

info

Both endpoints in the Download API (Task creation and Task status checking) have the "rate limit", currently it is 10 requests per minute for each endpoint in the context of your api_key.*** Please check this example to find a possible way of implementing access to this API respecting mentioned limits.

Task creation

To create a new task, send a POST request to the service. Supported task types:

Task status

After the successful task creation with POST request you will receive unique task_id in the responce. Save it and use to check the task status (and get the results) by sending a GET request to the service with this task_id.

curl --location --request GET 'https://api-connect.eos.com/api/gdw/api/<task_id>?api_key=<your_api_key>'

Possible task statuses:

  • Created
  • Started
  • Finished

After the task is finished, you will receive the response with an image