DigitalGlobe 1B products can be ordered and delivered to The GBDX Platform on an as-needed basis. Ordering a 1B product means sending a request to the DigitalGlobe Factory to deliver the product to The GBDX Platform.
The GBDX ordering process is as follows:
- An order is placed for a DigitalGlobe 1B product.
- The DigitalGlobe Factory delivers the product to the GBDX S3 receiving bucket. This can take several hours.
- The status of the product in the GBDX catalog is updated to "delivered" and the s3 location is appended to the product record.
- The product is now available for use.
The GBDX Catalog includes datasets from DigitalGlobe and third-party datasets. Only DigitalGlobe products need to be ordered. Third-party open source data is available for use without ordering.
Products from the following datasets need to be ordered:
Note: WORLDVIEW-4 content is only available through Raster Data Access (RDA). Ordering WORLDVIEW-4 data to the GBDX catalog is not supported.
Third party or open source datasets that do not need to be ordered include:
DigitalGlobe 1B products are deleted from the GBDX S3 receiving bucket after 30 days of no access. "Access" means the product has been ordered or used as an input to a Workflow. If you need access to an image that has been deleted, you can order it again.
We recommend adding the
Auto_Ordering task to the Workflow definition. See Auto Ordering Task Tutorial.
Orders are limited to 100 catalog IDs per order request.
The ability to order DigitalGlobe 1B image products depends on the GBDX Subscription Plan. Once a product has been delivered to The GBDX Platform, it is available for any user on a plan with access to DigitalGlobe imagery.
Evaluation users, placing an order for an image that has already been delivered does not count against your ordering limit.
|GBDX Subscription Plan||Ordering Limits|
|Community||Cannot order, no access to DigitalGlobe 1B imagery|
|Notebooks Only||Cannot order, can use available 1B imagery|
|Evaluation||20 image limit, can use available 1B imagery|
|GBDX Starter||No limit|
|GBDX Enterprise||No limit|
"Notebooks Only" plan subscribers can use DigitalGlobe 1B image products that are already available on The GBDX Platform, but they cannot place an order.
"GBDX Evaluation" plan users can order up to 20 1B image products. They can also use DigitalGlobe 1B image products that are already available on The GBDX Platform.
There are three ways to place an order:
- Add the
Auto_Orderingtask to a Workflow
- Make a request to the Ordering API
- Make a request to the Ordering with Callbacks API
You can also make API requests to check the status of an order and to get the S3 location for a product.
Auto_Ordering task in your workflow definition. This task takes a Catalog ID as input. This is the simplest method for ordering imagery products to use in a Workflow. It also ensures that an image that has been purged from the GBDX receiving bucket will be ordered again when you need it.
To learn how to add the
Auto_Ordering task to a workflow, see Auto Ordering Task Tutorial
When make a
POST request to the GBDX Ordering API, you'll include the list of catalog IDs to be ordered. The list can include up to 100 catalog IDs.
To learn how to make a request to the Ordering API, see Place an Order
You can place an order and get callback notifications by making a request to the Ordering Callbacks (/ordercb) API endpoint.
To learn how to make an ordering with callbacks request, see Place an Order with Callbacks.
When you place an order using the Ordering API, the response will include an Order ID. You can check the status of the order by making an API request with the Order ID.
To learn how to check the status of an order, see Check the status of an order
You can make a request to the Ordering API to get the S3 location of a product. This request does not return the details of an order.
To learn how to get the S3 location for a product, see Get the S3 Location for a Product Tutorial
Learn how to add the Auto Ordering task to a Workflow
|Auto Ordering Task Tutorial|