This API will respond with satellite name and dates which are avialale for your farm for a particular date.
Retrieving Satellite Imagery Name & Date for your farm within a particular Date Range.
This API endpoint allows you to retrieve the names and acquisition dates of satellite imagery captured within a specific date range for your farm.
Endpoint: https://api.mapmycrop.com/satellite/dates
Method: GET
Parameters:
| Parameter | Type | Description |
|---|---|---|
| api_key | string ( Required) | Your unique API key provided by Mapmycrop |
| farm_id | string ( Required) | ID of the farm, for which you want to retrieve satellite information. Each farm has a unique ID |
| start_date | date ( Required) | The Start date should be YYYY-MM-DD Format Only. Example 2024-05-01. The Start Date is the from which date you wish to fetch the satellite imagery. |
| end_date | date ( Required) | The End date should be YYYY-MM-DD Format Only. Example 2024-05-10. The End Date is to which date you wish to fetch the satellite imagery. |
| cloud_cover | integer ( Required) | Note - This parameter defines the value of cloud cover and it always has to be between 0 to 100. The default value is 50, which means it will send a response of all satellite imagery dates having less than 50 % cloud cover |
The API returns a JSON array containing objects that represent available satellite imagery for your farm within the specified date range and cloud cover criteria.
Sample Response:
[
{
"satellite": "S1",
"datetime": "2024-05-08T16:32:19Z",
"cloud_cover": 1.87
},
{
"satellite": "S2",
"datetime": "2024-05-08T16:32:19Z",
"cloud_cover": 1.87
},
{
"satellite": "S1",
"datetime": "2024-05-08T16:32:05Z",
"cloud_cover": 1.28
},
{
"satellite": "S2",
"datetime": "2024-05-08T16:32:05Z",
"cloud_cover": 1.28
},
{
"satellite": "S3",
"datetime": "2024-05-07T23:24:26Z",
"cloud_cover": null
},
{
"satellite": "S5",
"datetime": "2024-05-01T16:10:06.332Z",
"cloud_cover": 33.77
}
]
Special Note
The availability of certain satellites and indices may vary based on your farm's subscription plan. For premium farms, you may have access to additional satellites and indices, including the daily satellite (S6). Please consult the Mapmycrop team for more details.