Order replacement occurs during imaging window selection for Assured tasking order creation. At this stage, you see more imaging window options in the Tasking Dashboard. These extra options appear when a user cancels an existing order, making room for a replacement. Users can then choose to replace an existing order if the new request is more urgent. In these cases, the imaging window will show one or two existing orders, their names, predicted weather, and off-nadir angles. This allows users to see which of their existing orders will be replaced by a new one.
The screenshot above shows what a user might see when an existing order is preventing a new order from being placed on the collection deck. Order replacement typically occurs within an approximately 100 x 100 km area, meaning any order within this area could be under the order replacement option.
FAQ
Can users opt out of order replacement?
The feature is optional and requires a specific opt-in. By selecting "I understand that the orders listed above in grey will be cancelled to reserve the selected imaging window (…)” users should not be able to replace orders accidentally.
How does this affect the Tasking API?
The process of placing a tasking order via API doesn't change if this feature is active. If users would like to receive their imaging windows with conflicting orders, you need to provide a new GET request parameter. When you retrieve imaging windows, add show_replacing_imaging_windows to that search. The tasking API will indicate the ability to replace an existing order on each retrieved imaging window. Imaging windows will now contain two new fields, conflicting_orders and quota_priority_multiplier, to let the user know about the replacement process.
Example of conflicting Imaging windows:
{
"count": 42, // higher amount of imaging windows
"next": null,
"previous": null,
"results": [
{
"id": "cdba1487-33a6-4c17-93db-1353f7197ea6",
"start_time": "2023-11-26T13:47:53.114000Z",
"end_time": "2023-11-26T13:49:05.033000Z",
"conflicting_orders": [
{
"id": "886ed050-a16b-4c5d-a252-c805720afd80",
"name": "existing order",
// …
}
],
"quota_priority_multiplier": 1.0
// …
},
// …
]
}
Example of a conflict free window:
GET https://api.planet.com/tasking/v2/imaging-windows/?search_id=63bda5f9-e607-47f2-a649-58199234397a&show_replacing_imaging_windows=false
{
"count": 42, // reduced number of imaging windows
"next": null,
"previous": null,
"results": [
{
"id": "2d5a650b-ef53-4d09-bc76-902b721bb00d",
"start_time": "2023-11-26T13:47:53.114000Z",
"end_time": "2023-11-26T13:49:05.033000Z",
"conflicting_orders": [],
"quota_priority_multiplier": 1.0
// …
},
// …
]
}
Is there a fee for late order cancellation?
No additional fees for late order cancellation. However, you pay for replacements that happen less than 24 hours before the collect. If you replace two orders with one less than 24 hours before collection, you pay for two orders.
Comments
Please sign in to leave a comment.