Order templates in SDK

Overview

Order new or archive geospatial data.

Constants

Constant	Description	Value
`UnitType`	The type of unit.	`Literal["SQ_KM", "SCENE"]`

Class: OrderError

A data class that represents errors encountered during order cost estimation or creation.

Attributes

Attribute	Description
`index`	int The failed geometry index number.
`message`	str The error message associated with the failed geometry.
`details`	str Error message details.

Class: OrderReference

A data class that represents references to orders in the system.

Attributes

Attribute	Description
`index`	int A sequence identifier for the order reference.
`id`	str The order ID.

Properties

order

Retrieves the full details of the order associated with the reference.

1
from up42.order_template import OrderReference
2

3
# Select an order
4
order_id = "68567134-27ad-7bd7-4b65-d61adb11fc78"
5

6
# Create an OrderReference instance for the given order and access order details
7
order_ref = OrderReference(index=0, id=order_id)
8
full_order = order_ref.order
9

10
# Define output
11
print(f"Display name: {getattr(full_order, 'display_name', 'N/A')}")
12
print(f"Status: {full_order.status}")
13
# Uncomment the following lines to fetch tasking-only parameters
14
# print(f"Substatus: {full_order.details.sub_status}")
15
# print(f"Acquisition start date: {full_order.details.acquisition_start}")
16
# print(f"Acquisition end date: {full_order.details.acquisition_end}")
17
# print(f"Order description: {full_order.details.extra_description}")
18
# print(f"Geometry: {full_order.details.geometry}")
19
tags = getattr(full_order, "tags", [])
20
print("Tags:", ", ".join(tags) if tags else "No tags")

Class: OrderCost

A data class that represents the cost details of an order.

Attributes

Attribute	Description
`index`	int The geometry index number. Indexing starts from zero.
`credits`	float The estimated cost of the geometry, in credits.
`size`	float The size of the geometry.
`unit`	UnitType The unit of measurement used to calculate the size.

Class: Estimate

A data class that represents the estimated cost of a tasking or catalog order batch.

Attributes

Attribute	Description
`items`	list[Union[OrderCost, OrderError]] A list of geometries in the estimation. It might include successful cost details (`OrderCost`) or errors encountered during the estimation (`OrderError`).
`credits`	float The estimate of the order batch cost, in credits.
`size`	float The size of the order batch in square kilometers or the number of scenes needed to cover the requested geometry.
`unit`	UnitType The unit of measurement used to calculate the size.

1
# Define order geometry
13 collapsed lines
2
geometry = {
3
    "type": "Polygon",
4
    "coordinates": [[
5
        [13.369713, 52.452327],
6
        [13.369713, 52.470760],
7
        [13.339159, 52.470760],
8
        [13.339159, 52.452327],
9
        [13.369713, 52.452327]
10
    ]]
11
}
12

13
# Wrap the geometry into a GeoJSON FeatureCollection
14
features = geojson.FeatureCollection(features=[geojson.Feature(geometry=geometry)])
15

16
# Instantiate a BatchOrderTemplate with the given parameters
17
order_template = up42.BatchOrderTemplate(
18
    data_product_id="c3de9ed8-f6e5-4bb5-a157-f6430ba756da",
19
    display_name="Sentinel-2 over Berlin",
20
    features=features,
21
    params={
22
        "id": "S2B_T32UQD_20250520T102551_L2A"
23
    },
24
    tags=["sentinel-berlin"]
25
)
26

27
# Estimate the cost
28
estimate = order_template.estimate
29

30
# Define output
7 collapsed lines
31
print(f"Total credits: {estimate.credits}")
32
print(f"Total size: {estimate.size} {estimate.unit}")
33
print("Geometry items:")
34
for item in estimate.items:
35
    print(f"    - Index: {item.index}")
36
    print(f"      Credits: {item.credits}")
37
    print(f"      Size: {item.size} {item.unit}")

Class: BatchOrderTemplate

A data class that defines a template for creating and estimating batch orders.

Attributes

Attribute	Description
`data_product_id`	str The data product ID.
`display_name`	str A human-readable name that describes the order.
`tags`	list[str] A list of tags that categorize the order. A tag can consist of letters, numbers, spaces, and special characters (`.`, `-`, `_`, `/`, `:`). If the list is empty, tags will be removed.
`features`	geojson.FeatureCollection A GeoJSON FeatureCollection representing the order’s geometry.
`params`	dict Order parameters. To retrieve the required and optional parameters needed to create an order for a specific data product, use DataProduct.schema.

1
# Define order geometry
13 collapsed lines
2
geometry = {
3
    "type": "Polygon",
4
    "coordinates": [[
5
        [13.369713, 52.452327],
6
        [13.369713, 52.470760],
7
        [13.339159, 52.470760],
8
        [13.339159, 52.452327],
9
        [13.369713, 52.452327]
10
    ]]
11
}
12

13
# Wrap the geometry into a GeoJSON FeatureCollection
14
features = geojson.FeatureCollection(features=[geojson.Feature(geometry=geometry)])
15

16
# Instantiate a BatchOrderTemplate with the given parameters
17
order_template = up42.BatchOrderTemplate(
18
    data_product_id="c3de9ed8-f6e5-4bb5-a157-f6430ba756da",
19
    display_name="Sentinel-2 over Berlin",
20
    features=features,
21
    params={
22
        "id": "S2B_T32UQD_20250520T102551_L2A"
23
    },
24
    tags=["sentinel-berlin"]
25
)

Methods

place

Submits a batch order. Returns list[Union[OrderReference, OrderError]].

1
# Define order geometry
13 collapsed lines
2
geometry = {
3
    "type": "Polygon",
4
    "coordinates": [[
5
        [13.369713, 52.452327],
6
        [13.369713, 52.470760],
7
        [13.339159, 52.470760],
8
        [13.339159, 52.452327],
9
        [13.369713, 52.452327]
10
    ]]
11
}
12

13
# Wrap the geometry into a GeoJSON FeatureCollection
14
features = geojson.FeatureCollection(features=[geojson.Feature(geometry=geometry)])
15

16
# Instantiate a BatchOrderTemplate with the given parameters
17
order_template = up42.BatchOrderTemplate(
18
    data_product_id="c3de9ed8-f6e5-4bb5-a157-f6430ba756da",
19
    display_name="Sentinel-2 over Berlin",
20
    features=features,
21
    params={
22
        "id": "S2B_T32UQD_20250520T102551_L2A"
23
    },
24
    tags=["sentinel-berlin"]
25
)
26

27
# Submit the order
28
order_template.place