Tasking Migration
This document summarizes concepts and changes needed to migrate reseller orders to the Hub Ordering and Tasking APIs. For more information on the Hub APIs, refer to the Developer Portal.
Most of the field names used for ordering carry over the same name to the new system, but use different casing. Hub requests use snake case, not camel case, so an old field like requestedGsd will most likely named requested_gsd.
Tasking endpoint
Tasking requests should be placed to:
https://api.maxar.com/tasking/v1/vantor/
Line Items are separate orders
The Tasking API is not able to process batch requests and does not have a concept similar to "Line Items". Each AOI must be ordered in its own API call.
Tasking request validation
Tasking requests can be validated by adding the URL parameter validation_only=true. See FlexView - Query Parameters.
Product types
Like ordering, product types also use longer, more readable names for the product types. See the table below.
| Product Type | Pipeline Namespace/Name |
|---|---|
1B | imagery/system-ready |
OR2A | imagery/view-ready-ortho |
2A | imagery/view-ready |
3D | imagery/map-ready |
For more information, see Archive Ordering.
Priority and tasking tiers
Hub tasking does not have prioritization. It instead has tasking tiers which simplify tasking options.
The FlexView tier is closest match to the previous tasking experience and would be the easier of the two tiers to migrate to.
FastView tasking can be appropriate for higher-priority tasking requests, but does not accept arbitrary geometry AOIS. FastView restricts the user to specify a center point and one of AOIs of a pre-defined shape. While available, migrating to this tasking tier would require adapting to its AOI rules.
See WorldView 2D Tasking Tiers for more information.
Tasking settings
Tasking settings previous found in taskingDetails have equivalents in tasking_details:
maxCloudCoverismax_cloud_covermaxOffNadirAngleismax_off_nadir_angleminSunElevationAngleismin_sun_elevation_anglemaxCollectedGsdismax_gsd
Product settings
See Reseller Ordering for fields names related to the product output settings and delivery.
Requested GSD
The GSD setting requestedGsd maps to a top level setting named requested_gsd.
High Definition settings
High Definition is not currently available through tasking orders.
Callback URLS to notifications
Tasking sends similar notifications as ordering.
Reseller block
Reseller tasking requests require a reseller_data block, matching the object required for reseller orders.
For an example of a complete tasking request, see Reseller Tasking Example.