Tasking Requests

Overview

If suitable data over your area of interest doesn't exist, you can submit a request for new data to be collected by Capella's SAR satellite constellation. To submit a new request, you will need to know where you would like the data to be collected, when you would like the data to be collected, what imaging mode you would like to use (spotlight, sliding spotlight, or stripmap), the frequency of the tasking request (single vs repeat), and whether you would like to apply a tasking tier for collection of data within a certain period of time. Once a tasking request has been submitted, Capella's tasking system will automatically determine whether it is possible to fulfill your tasking request. When a tasking request is accepted, the system will provide information on the status of the request.

Submitting a Tasking Request for Standard Products

Single Tasking Request

To submit a single tasking request, you will make a request to the task endpoint. The request body is a GeoJSON feature, which includes properties describing the parameters for the tasking request:

POST https://api.capellaspace.com/task
{
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              179.84893798828125,
              66.42553717157787
            ],
            [
              180.25543212890625,
              66.42553717157787
            ],
            [
              180.25543212890625,
              66.58430877083293
            ],
            [
              179.84893798828125,
              66.58430877083293
            ],
            [
              179.84893798828125,
              66.42553717157787
            ]
          ]
        ]
      },
    "properties": {
      "taskingrequestDescription": "My first tasking request",
      "taskingrequestName": "Tasking Test 1",
      "windowOpen": "2022-11-18T00:00:00.000Z",
      "windowClose": "2022-12-29T00:00:00.000Z",
      "collectionTier": "7_day",
      "collectConstraints": {
        "collectMode": "stripmap"
      },
      "preApproval": true,
      "customAttribute1": "My New Project",
      "customAttribute2": "XYZ123"
    },
    "type": "Feature"
}

The geometry can be either a point or polygon. Multi-polygons and intersecting polygons are not accepted. The taskingrequestName and taskingrequestDescription can be used to help characterize and describe the tasking request. The remaining properties define how the data will be collected:

windowOpen is a required field that should be set at the earliest time (UTC) you would like data collected
collectionTier can be either 1_day, 3_day, 7_day, or background and will indicate your preference for data to be collected within that period from windowOpen
windowClose can optionally be set for a time longer than the collectionTier indicates, which will extend the imaging window for your request
collectMode indicates the desired imaging mode, which can be either spotlight, sliding_spotlight, or stripmap
preApproval will skip the tasking request cost review step if set to true
customAttribute1 is an optional custom attribute to help you track a Capella task with your own metadata or internal systems
customAttribute2 is an optional custom attribute to help you track a Capella task with your own metadata or internal systems

The response will contain detailed information about your single tasking request, including the specific constraints used for imaging.

Repeat Tasking Request

To submit a repeat tasking request, you will make a request to the repeat-requests endpoint. The request body is a GeoJSON feature, which includes properties describing the parameters for the repeat tasking request:

POST https://api.capellaspace.com/repeat-requests
{
  "type":"Feature",
  "geometry":{
    "coordinates":[
      -118.22537899999998,
      36.561082999999996
    ],
    "type":"Point"
  },
  "properties":{
    "repeatRequestName":"Repeat Task Test 1",
    "repeatRequestDescription":"My first repeat task request",
    "repetitionProperties":{
      "repeatStart": "2022-12-20T22:02:20.093Z",
      "repetitionInterval":7,
      "repetitionCount":4,
      "maintainSceneFraming":false
    },
    "collectionTier":"routine",
    "collectConstraints":{
      "collectMode":"spotlight",
    },
    "preApproval":false,
    "customAttribute1": "My New Project",
    "customAttribute2": "XYZ123"
  }
}

The geometry can be a point target. Polygon, multi-polygons and intersecting polygons are not accepted. The repeatRequestName and repeatRequestDescription can be used to help characterize and describe the repeat tasking request. The remaining properties define how the data will be collected:

repeatStart - the earliest time (UTC) you would like data collected
repetitionInterval - number of days between the start of derived requests. For example, repetitionInterval==5 means requests will open 5 days after the opening previous request
repetitionCount - total number of acquisitions for a repeat series
maintainSceneFraming - flag to maintain consistent framing (look direction, orbit state, orbital plane) across all acquisitions
collectionTier can be either repeat or background and will indicate your preference for the repeat request service level
collectMode indicates the desired imaging mode, which can be either spotlight, sliding_spotlight, or stripmap
preApproval will skip the tasking request cost review step if set to true
customAttribute1 is an optional custom attribute to help you track a Capella task with your own metadata or internal systems
customAttribute2 is an optional custom attribute to help you track a Capella task with your own metadata or internal systems

The response will contain detailed information about your repeat tasking request, including the specific constraints used for imaging.

Submitting a Task with Custom Collect Constraints

To submit a task with custom collect constraint criteria that deviate from the standard products, you will make a request to the task endpoint with specific parameters defined in the collectConstraints object.

POST https://api.capellaspace.com/task
{
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              179.84893798828125,
              66.42553717157787
            ],
            [
              180.25543212890625,
              66.42553717157787
            ],
            [
              180.25543212890625,
              66.58430877083293
            ],
            [
              179.84893798828125,
              66.58430877083293
            ],
            [
              179.84893798828125,
              66.42553717157787
            ]
          ]
        ]
      },
    "properties": {
      "taskingrequestDescription": "My custom constraint tasking request",
      "taskingrequestName": "Custom Constraint Tasking Test 1",
      "windowOpen": "2022-11-18T00:00:00.000Z",
      "windowClose": "2022-12-29T00:00:00.000Z",
      "collectionTier": "7_day",
      "collectConstraints": {
        "collectMode": "stripmap",
        "lookDirection": "right",
        "ascDesc": "ascending",
        "orbitalPlanes": [45, 53],
        "offNadirMin": 28,
        "offNadirMax": 38,
        "localTime": [[0, 21600], [64800, 86400]]
      },
      "preApproval": true
    },
    "type": "Feature"
}

In the example above, the request is for a stripmap image taken at nighttime with right looking, ascending, mid-inclination orbits, and a look angle between 28 degrees and 38 degrees. For any collectConstraints parameter not specifically defined, the default will be used.

lookDirection - indicates the view angle, which can be right, left, or either
ascDesc - indicates the orbit state, which can be ascending, descending, or either
orbitalPlanes - an array of orbital plane values that can be used to service the request, which can be 45, 53
offNadirMin - indicates the minimum off-nadir angle (look angle) permitted. This value must be less than offNadirMax and is defined in degrees.
offNadirMax - indicates the maximum off-nadir angle (look angle) permitted. This value must be greater than offNadirMin and is defined in degrees.
localTime - indicates the constraints on local access time, which can be used to restrict the time of day at which the image is collected. This value is defined by a list of time ranges, representing the seconds in the day when the collect can be taken.
- [[0, 86400]] - any time during the 24 hour period. 0 is the first second in the day and 86400 is the last second in the day (default)
- [[21600, 64800]] - between 6AM and 6PM. 21600 is the number of seconds elapsed at 6AM (60 seconds per minute, 60 minutes per hour, for 6 hours) and 64800 is the number of seconds elapsed at 6PM (60 seconds per minute, 60 minutes per hour, for 18 hours)
- [[0, 21600], [64800, 86400]] - between 6PM and 6AM. 0 is the first second in the day and 21600 is the number of seconds elapsed at 6AM. 64800 is the number of seconds elapsed at 6PM and 86400 is the last second in the day.

There are many other collectConstraints parameters that can defined, see the API reference for Tasking for more details.

Additional Information

For more information on constellation tasking requests, see the API reference for Tasking.