Check task feasibility
Use the Feasibility endpoint to validate whether proposed tasking requests can be scheduled by the ICEYE constellation before creating tasks. When a pricing model is included in your contract, it also checks whether the requests fit within your budget.
The request takes a list of tasks as input with the same input fields as createTask.
Required parameters
The required parameters of the tasking checkFeasibility operation are specified in the request body of a POST operation. Each task request in the array must include the following required fields:
Point of interest
The center-point over which the image will be acquired.
The point of interest should be specified as a valid set of earth-centered coordinates, pointOfInterest[lat] and pointOfInterest[lon] (latitude and longitude), in WGS 84 coordinates.
"pointOfInterest": {
"lat": -23.700552,
"lon": 133.882675
},Acquisition window
A time window with a start and end during which ICEYE’s constellation can acquire the SAR Data.
-
starttime cannot be immediate and must be set to a minimum number of hours after the time of the tasking request. For details, see the Min time before collection to choose target table column in section 3.4 Tasking Priority Options of the Data Product Specification document. -
endcannot be more than 14 days from the time of the tasking request. -
The acquisition window must be at least 24h wide,
end - start >= 24h.
"acquisitionWindow": {
"start": "2023-12-29T23:20:11.315Z",
"end": "2023-12-30T01:20:11.315Z"
},The timestamp format follows RFC 3339. To specify the same UTC time in a +3 hour timezone, users can use:
"acquisitionWindow": {
"start": "2023-12-30T02:20:11.315+03:00",
"end": "2023-12-30T04:20:11.315+03:00"
},Imaging mode
Imaging mode defines how a satellite collects the imaging data, which affects the azimuthal length, swath width, ground resolution, and image quality of the final image.
The imaging modes described in the ICEYE Product Specification are mapped to the string value of the imagingMode parameter as follows:
| Product guide image mode | API imagingMode |
|---|---|
Strip |
|
Scan |
|
Scan Wide |
|
Spot |
|
Spot Extended Area |
|
Spot Fine |
|
Dwell |
|
Dwell Fine |
|
Dwell Precise |
|
The allowed imaging modes vary by contractID.
|
For example, to specify the imaging mode as a parameter in a request body:
"imagingMode": "SPOTLIGHT",Optional parameters
Priority
The task priority specifies the priority level that applies when the scheduler has to resolve a potential conflict.
In the case of a conflict, a COMMERCIAL task will always take priority over a BACKGROUND task.
Task priority can take one of the following string values:
| Priority | Description |
|---|---|
|
The task will be scheduled if there are no conflicts, but will be removed from the schedule if a higher priority task is created in the same time window. |
|
The task has a higher priority than |
Defaults to the contractually agreed priority from your contract.
For example, to specify the priority as a parameter in a request body:
"priority": "COMMERCIAL",| All tasks in a single request must have the same priority |
Service Level Agreement
The service level agreement (SLA) specifies a guaranteed availability time for tasked image products. The availability time is the time elapsed between the moment a satellite finishes acquiring the raw image, and the time when the image products become available for download from ICEYE.
| Availability time does not include the time required to download the product data or deliver the data to an external location. |
The sla parameter can take one of the following string values:
| SLA | Description |
|---|---|
|
Promises availability of standard image products within 8 hours of the satellite acquiring the image (normal delivery priority). |
|
Promises availability of standard image products within 3 hours of the satellite acquiring the image. |
Defaults to SLA_8H.
For example, to specify the SLA as a parameter in a request body:
"sla": "SLA_8H",Incidence angle
The incidenceAngle parameter specifies the range of incidence angles that are accepted by this task.
"incidenceAngle": {
"min": 10,
"max": 45
},The default incidence angle range is automatically set to the recommended range (Performant Incidence Range) of the specified imaging mode, as documented in the ICEYE Product Specification.
If you specify the incidenceAngle parameter explicitly, we recommend that you choose a range lying within the documented Performant Incidence Range for the specified imaging mode, in order to obtain a high quality image.
Angle ranges wider than 10-45 degrees are disallowed, because incidence angles outside this range are not commercially supported in the constellation.
| If you task with an incidence angle range that lies outside the Performant Incidence Range for the specified imaging mode, ICEYE does not guarantee the resulting image quality. |