Skip to content

📮 Ordering

Order images and download them via the ordering and assets. You can filter by various parameters e.g. time period, area of interest, cloud cover etc, using Catalog Search. Then, you can order an image into the UP42 Storage and download it to inspect the result - all with the convenience of the UP42 Python SDK!

Supported Provider

Currently ordering supports these data providers: OneAtlas.

Binder

Initialize Catalog

import up42
up42.authenticate(project_id="123", project_api_key="456")
#up42.authenticate(cfg_file="config.json")

catalog = up42.initialize_catalog()

Search scenes in aoi

aoi = up42.get_example_aoi(location="Berlin", as_dataframe=True)
#aoi = up42.read_vector_file("data/aoi_washington.geojson", 
#                            as_dataframe=False)
search_parameters = catalog.construct_parameters(geometry=aoi, 
                                                 start_date="2018-01-01",
                                                 end_date="2020-12-31",
                                                 sensors=["pleiades"],
                                                 max_cloudcover=5,
                                                 sortby="cloudCoverage", 
                                                 limit=1)
# Select only immediately available images
# Use {"in": ["MINUTES", "HOURS"]} for archive data
search_parameters["query"]["deliveryTime"] = {"in": ["MINUTES"]}
search_results = catalog.search(search_parameters=search_parameters)
search_results

Estimate the order price

catalog.estimate_order(aoi, search_results.loc[0])

Catalog Search

For more detail on how to perform a catalog search, and additional options, go to Catalog Search.

Place an order for the image, tracking it's status

order = catalog.place_order(aoi, search_results.loc[0])
order.track_status()

Get the assets or results of the order

assets = order.get_assets()
assets[0].download()

You can also get previously ordered assets from UP42 Storage:

storage = up42.initialize_storage()
assets = storage.get_assets()


Success!

Continue with the Detailed Example!