Skip to main content

Tasking Migration

note

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 TypePipeline Namespace/Name
1Bimagery/system-ready
OR2Aimagery/view-ready-ortho
2Aimagery/view-ready
3Dimagery/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:

  • maxCloudCover is max_cloud_cover
  • maxOffNadirAngle is max_off_nadir_angle
  • minSunElevationAngle is min_sun_elevation_angle
  • maxCollectedGsd is max_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.