Tasking
Note: This is the Tasking V1 guide. Tasking V2 is planned for release in early November. Once V2 is released, V1 will no longer be available. See the Tasking V2 Guide and the Tasking V2 Migration Guide.
Overview
The Tasking API lets you request a new imagery collection over your Area of Interest (AOI) within a specified time frame. You may include additional parameters such as image resolution and off-nadir angle. Within the Tasking documentation you'll find an introduction to Worldview 2D tasking, a tutorial and examples, and API reference.
User guides and examples
| Page | Topic |
|---|---|
| Intro to Tasking | An overview of Worldview 2D Tasking through the Tasking API. If you're new to tasking, read this first. |
| Tutorial: How to Place a Tasking Request | A step-by-step tutorial for creating a tasking request body. |
| Core Imagery Default Recipes | The default settings for each of the core imagery products. |
| Example: Request for 30 CM Color | A tasking request example for 30 cm color, view-ready ortho (OR2A) imagery. |
| Example: Request for 50 CM Color | A tasking request example for 50 cm system-ready (1B) imagery. |
| Validation and Errors | Describes the validation checks and statuses in the Tasking workflow. |
API reference
| Page | Topic |
|---|---|
| Tasking Request Limits | The limitations on the number of tasking requests that can be placed in an hour. |
| Tasking Parameters | A table that describes the required and optional parameters of a tasking request. |
| Tasking End Use Codes | Allowed values for the required "end use code" tasking parameter. |
| Tasking Status and Errors | Status definitions and common error messages for failed statuses. |
POST Quote a Tasking Request | Get a usage estimate quote for a tasking request before submitting. |
POST Submit a Tasking Request | Submit a tasking request, or add validation_only=true to the URL path to validate the request before submitting. |
GET Get the Status of a Tasking Request | Get the latest status and details for a tasking request. Requires the order ID which was provided in the response when the tasking request was submitted. |
GET List all Tasking Requests | Lists all tasking requests for the account. |
POST Cancel a Tasking Request | Cancel a tasking request before it's fulfilled. Requires the tasking order ID. |