Intro to WorldView 3D Tasking
Worldview 3D tasking is in limited release and is not currently available to all accounts.
Overview
WorldView 3D tasking captures a stereo pair image of your AOI and uses the WorldView 3D pipeline to deliver 3D data.
Credits and usage
A usage quote is calculated when a request is submitted. Account credits are reserved to cover the quoted amount. Once the order is fulfilled, any reserved credits that were not used are released.
Quoting and placing Tasking orders
The following endpoints can be used to estimate tasking credit use, and to submit the tasking request:
| Request | Endpoint | Description |
|---|---|---|
| Quote a tasking order | /tasking/rapid3d/estimate | Returns estimate data for credits consumed for the request. |
| Submit a WorldView 3D tasking order | /tasking/rapid3d | Submit your WorldView 3D tasking request |
| Validate a Tasking Request | /tasking/rapid3d?validation_only=true | add the path parameter validation_only=true to validate your request. |
See also the WorldView 3D example.
Collection window (start and end date)
The collection window for a Worldview 3D tasking request can start immediately and must end at most 364 days in the future.
Area of interest
The AOI must be a GeoJSON Polygon following these guidelines:
- Maximum area: 1000 sq km.
- Minimum area: 40 sq km.
- Width must be between 5 and 10 km.
- Length must be between 8 and 100 km.
- Polygon must be a rectangle oriented north-south.
Tasking parameters and options
The tasking parameters and output options are described in the WorldView 3D parameter page.
Order deliveries
Once imagery is collected, ordered, and processed, it can be delivered to the following cloud storage platforms:
- Amazon S3 commercial cloud
- Azure cloud storage
- Google cloud storage
Tasking V2 does not currently support the download option but this delivery method is planned to be reinstated.
The order is also delivered to the Orders Manager in the Hub User Interface.
Delivery details are also included in the status messages found in the Tasking response object. See Delivery details.
Note for AWS S3 users: V2 APIs deliver to S3 from a new ARN. If you have previously delivered to S3 from the Ordering API or Tasking V1 API, you will need to add an additional ARN to your bucket policy. The updated bucket policy can be found here.
See Ordering Output Delivery Options for more detail.
Managing Tasking orders
The following endpoints can be used to manage tasking orders:
| Request | Endpoint | Description |
|---|---|---|
| Get an existing tasking | /tasking/{id} | Returns an existing tasking by its ID. |
| List tasking orders | /tasking | List your tasking orders. Includes filtering and pagination. |
| Cancel tasking order | /tasking/cancel | Cancel a tasking request. |