Order

Order tasking and catalog imagery using the SDK.


Overview

Create tasking and catalog orders.

View repository

Class: OrderParamsV2

A class that represents the schema for the order parameters.

Attributes
AttributeDescription
dataProductstr
The data product ID.
displayNamestr
A human-readable name that describes the order.
paramsDict[str, Any]
Order parameters.
featureCollectionDict[str, Any]
A GeoJSON feature collection.
tagsList[str]
A list of tags that categorize the order. A tag can consist of letters, numbers, spaces, and special characters (., -, _, /, :).

Class: Order

A class that represents an order in the system.

Functions

info

Retrieves the metadata of a specific order. Returns dict.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.info

  

status

Retrieves the order status. Returns OrderStatus.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.status

  

order_details

Retrieves the details of a specific tasking order. It doesn’t work with catalog orders. Returns dict.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.order_details

  

is_fulfilled

Checks if the order is fulfilled. Returns bool:

  • True: the job has the FULFILLED status.
  • False: the job has any other status.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.is_fulfilled

  

get_assets

Retrieves assets from orders that have FULFILLED or BEING_FULFILLED statuses. Returns List[asset.Asset].

Use this function to retrieve multiple assets from the same order. To search across all assets in your storage, use the get_assets function from the Storage class.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.get_assets()

  

track_status

Tracks the order status by retrying until the status changes to FULFILLED or FAILED_PERMANENTLY. It will query the order every 120 seconds. Returns str.

ParameterDescription
report_timefloat
An interval between queries, in seconds. The default value is 120.

Python

    order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.track_status(report_time=150)

  

Learn more