GBDX

Ordering Course

This document provides an overview of the GBDX ordering process.

Last Updated: March 20, 2019

Overview

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:

  1. An order is placed for a DigitalGlobe 1B product.
  2. The DigitalGlobe Factory delivers the product to the GBDX S3 receiving bucket. This can take several hours.
  3. The status of the product in the GBDX catalog is updated to "delivered" and the s3 location is appended to the product record.
  4. The product is now available for use.

Datasets that Require Ordering

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:

GEOEYE-1
QUICKBIRD
WORLDVIEW-1
WORLDVIEW-2
WORLDVIEW-3 VNIR
WORLDVIEW-3 SWIR

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:
IKONOS
LANDSAT-8
MODIS
SENTINEL-1
SENTINEL-2

Data Retention

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.

Ordering Limits

Orders are limited to 100 catalog IDs per order request.

Subscription Plan Ordering Access

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.

How to Order DigitalGlobe 1B Products

There are three ways to place an order:

  • Add the Auto_Ordering task 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

Include the 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

Ordering API

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

Ordering with Callbacks API

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.

Check the Status of an Order

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

Get the S3 location for a Product

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


What's Next

Learn how to add the Auto Ordering task to a Workflow

Auto Ordering Task Tutorial