Tiles and Collects

Overview

Once a tasking request has been accepted or is in an active state, you can view the tile and collect information for that tasking request. Tiles are the spatial footprints used to plan imaging area for a tasking request and are representative of the footprints of products that will be collected as part of the tasking request. Collects are the objects containing information about the imaging opportunities and status of imaging for each tile. The information from tiles and collects can be used to better understand the imaging plan and status of imaging for a tasking request, particularly for larger area requests where multiple scenes are required to cover the full area.

Tiles

Tiles are primarily used to represent and visualize the footprints of scenes that will be part of the tasking request. They are geoJSON polygon features with properties that describe the size and area of the tile. Tiles are only available for tasking requests that have reached an accepted or active state. To list all tiles for a tasking request, you can use the list tiles endpoint:

GET https://api.capellaspace.com/tiles/list/{{taskingrequestId}}

The response will include the tileId, which you will need to associate tile and collect information.

Collects

Collects contain properties describing the imaging geometry, radar parameters, and status of imaging for a particular tile. Collects are also only available for tasking requests that have reached an accepted or active state. To list all collects for a tasking request, you can use the collects list endpoint:

GET https://api.capellaspace.com/collects/list/{{taskingrequestId}}

The response body contains all of the relevant information about each collect:

• tileId can be used to associate the collect information with the related tile.
• windowOpen indicates the expected start time of imaging for the collect.
• windowClose indicates the expected end time of imaging for the collect.
• accessProperties will include information about the imaging geometry for the collect.
• collectProperties will include information about the radar operating parameters.
• collectStatusHistory will include information about the current and historical status of imaging and product processing for the collect.

Additional Information

For more information on tiles and collects, see the API reference for Tasking.