A basic example on how to create a tasking order on UP42.
First connect with UP42 as explained in the authentication chapter.
import up42
up42.authenticate(project_id="your project ID", project_api_key="your-project-API-key")
We look at the available data products and decide to create a tasking order for a TerraSar satellite image (see marketplace). The get_data_products
function gives us the desired Terrasar data_product_id
which is required for placing the tasking order.
tasking = up42.initialize_tasking()
products = tasking.get_data_products(basic=True)
products
terrasar_product_id = 'a6f64332-3148-4e05-a475-45a02176f210'
To help with the order parameters we can use tasking.construct_order_parameters
. It will also show you how to adjust parameters that are specific to the selected data product as log messages. Use
tasking.get_data_product_schema(data_product_id)
for more details.
geometry = {'type': 'Polygon',
'coordinates': (((13.375966, 52.515068),
(13.375966, 52.516639),
(13.378314, 52.516639),
(13.378314, 52.515068),
(13.375966, 52.515068)),)}
order_parameters = tasking.construct_order_parameters(data_product_id=terrasar_product_id,
name="My Terrasar tasking order",
acquisition_start= "2022-11-01",
acquisition_end= "2023-03-20",
geometry=geometry)
order_parameters
order_parameters["params"].update({
"acquisitionMode": "spotlight",
"polarization": "hh",
"processingLevel": "ssc"
})
order_parameters
After placing the tasking order, UP42 will carry out a feasibility study for the specified requirements and contact you with next steps via email.
order = tasking.place_order(order_parameters)
order
order.status
After the order placed, the UP42 customer support team will reach out to you via email with the results of the tasking feasibility study and pricing options. You can also see the status of the tasking order on the UP42 Console - in the Storage menu under the "Orders" tab.