Skip to content

🗺️ Catalog Search

Check data availability & download image preview quicklooks via the catalog search. You can filter by various parameters e.g. time period, area of interest, cloud cover etc.

Binder

Initialize Catalog

import up42
up42.authenticate(project_id="your project ID", project_api_key="your-project-API-key")
catalog = up42.initialize_catalog()

See the available data collections

Filter on the "name" key to see the available collections.

catalog.get_collections()

[c["name"] for c in collections]

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",
                                                 collections=["phr"],
                                                 max_cloudcover=20,
                                                 sortby="cloudCoverage", 
                                                 limit=10)
search_results = catalog.search(search_parameters=search_parameters)
display(search_results.head())
catalog.plot_coverage(scenes=search_results, 
                      aoi=aoi, 
                      legend_column="sceneId")

Download & visualize quicklooks

catalog.download_quicklooks(image_ids=search_results.id.to_list(), 
                            sensor="pleiades")

catalog.map_quicklooks(scenes=search_results, aoi=aoi)


Success!

Continue with Ordering!