Tasking Archive
Archive orders are used to request SkySat collects that are already in the archive. After an Archive order is created, the capture containing the requested SkySat collects is populated. SkySatCollects and related SkySatScenes can be downloaded using the usual flow, similar to regular Tasking orders.
Archive orders captures cannot be the target of Capture Review. Archive orders cannot be edited or cancelled.
Prerequisites to Archive Order Creation
Before creating an Archive order, you must have a list of desired SkySat collects, which intersect with the requested geometry. For the list of SkySat collects, use the following request to Data API:
- CURL
curl --request POST --url 'https://api.planet.com/data/v1/quick-search' \
--header 'Accept: application/json' \
--header "Authorization: api-key $PL_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"filter": {
"type": "AndFilter",
"config": [
{
"type": "GeometryFilter",
"field_name": "geometry",
"config": {
"type": "Point",
"coordinates": [
47.817578706298946,
22.0761858843631
]
}
},
{
"type": "DateRangeFilter",
"field_name": "acquired",
"config": {
"gte": "2023-10-30T14:17:21.376Z",
"lte": "2024-10-30T14:17:21.377Z"
}
}
]
},
"item_types": [
"SkySatCollect"
]
}'
Archive Order Creation
The creation of a Archive order is done using a POST request to the Tasking API /orders endpoint. Create an Archive order using the following request example:
- CURL
curl --request POST --url 'https://api.planet.com/tasking/v2/orders/' \
--header 'Accept: application/json' \
--header "Authorization: api-key $PL_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Archive Order 01",
"geometry": {
"type": "Point",
"coordinates": [
50.919139,
34.814306
]
},
"requested_item_ids": ["item_id_1", "item_id_2"],
"product": "Archive Tasking",
"pl_number": "$PL_CONTRACT_NUMBER"
}
The requested_item_ids
field should contain the list of SkySat collects that you want to be included in the Archive order. They need to be available in Archive and intersect with the geometry of the order.