sdk.tasking_order.create()

Create a tasking order.

Create a new satellite tasking order to request a new imagery acquisition. Tasking orders specify the target geometry, acquisition window, and product specification.

Parameters

data_source_id (str) - The ID of the satellite data source
product_spec_name (str) - The name of the product specification
target_geom_wkb (bytes) - The target geometry in WKB format
start_ts (datetime) - Start of the acquisition window
end_ts (datetime) - End of the acquisition window
[Optional] metadata (Struct) - Additional metadata for the order

Returns

TaskingOrder - The created tasking order object

Example(s)

from datetime import datetime
from shapely.geometry import Polygon

# Define the target area
target_polygon = Polygon([
    (-122.5, 37.7),
    (-122.5, 37.8),
    (-122.4, 37.8),
    (-122.4, 37.7),
    (-122.5, 37.7)
])

# Create a tasking order
tasking_order = await sdk.tasking_order.create(
    data_source_id="satellite-provider",
    product_spec_name="high-resolution",
    target_geom_wkb=target_polygon.wkb,
    start_ts=datetime(2024, 6, 1),
    end_ts=datetime(2024, 6, 30)
)

# Output (TaskingOrder)
id: "tasking-order-uuid"
state: PENDING
data_source_id: "satellite-provider"
acq_window {
  start_utc { seconds: 1717200000 }
  finish_utc { seconds: 1719705600 }
}