Skip to content

🔍 Search & Order Data

This chapter gives a quick example on how to search & purchase data from the UP42 catalog.

Binder

Authenticate

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")

Search image in the catalog

For the catalog search, first define the desired data collection, area of interest, time period etc. with the help of the construct_parameters function. The search outputs a dataframe with the available satellite images.

catalog = up42.initialize_catalog()

collections = catalog.get_collections()
print([c["name"] for c in collections])

# E.g. Pleiades Neo (`pneo`), Pleiades (`phr`), Spot (`spot`) etc.

aoi = up42.read_vector_file("data/aoi_washington.geojson")


search_parameters = catalog.construct_parameters(geometry=aoi, 
                                                 start_date="2019-01-01",
                                                 end_date="2021-12-31",
                                                 collections=["phr"],
                                                 max_cloudcover=20,
                                                 sortby="cloudCoverage", 
                                                 limit=10)

search_results = catalog.search(search_parameters=search_parameters)

Search results

Order the image

When you have decided on a specific image in the search results you can purchase it by placing an order. Before ordering the image, estimate the order price. After the order is finished the image is available in the UP42 user storage.

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

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

Download the image

You can check the status of the order via order.status. If you want to continuously track the order status until it is finished, use order.track_status(). To then download the image assets use:

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


⏭️ Continue with the Run an analytics workflow chapter or see the advanced section.