Create tasking and catalog orders.
A class that represents the schema for the order parameters.
Attributes
Attribute | Description |
---|---|
dataProduct | str The data product ID. |
displayName | str A human-readable name that describes the order. |
params | Dict[str, Any] Order parameters. |
featureCollection | Dict[str, Any] A GeoJSON feature collection. |
tags | List[str] A list of tags that categorize the order. A tag can consist of letters, numbers, spaces, and special characters ( . , - , _ , / , : ). |
A class that represents an order in the system.
Functions
Retrieves the metadata of a specific order. Returns dict
.
Python
order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.info
Retrieves the order status. Returns OrderStatus
.
Python
order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.status
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
Checks if the order is fulfilled. Returns bool
:
True
: the job has theFULFILLED
status.False
: the job has any other status.
Python
order = up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44")
order.is_fulfilled
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()
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
.
Parameter | Description |
---|---|
report_time | float 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)