Order replacement occurs during imaging window selection for Assured tasking order creation. At this stage, users will 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 for users and does require 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 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, a new GET request parameter will need to be provided. When requesting the retrieval of Imaging Windows, show_replacing_imaging_windows will need to be added for 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, users will pay for replacements that happen less 24 hours before the collect. Further, if a user replaces TWO orders for ONE less than 24 hours in advance of collection, they will then have to pay for two orders.
Comments
Please sign in to leave a comment.