Python SDK for UP42, the geospatial marketplace and developer platform.
Documentation • UP42.com • Support
- Python package for easy access to UP42's geospatial collections and analytics workflows
- Use UP42 functionality together with your preferred Python libraries!
See the documentation for getting started guides, examples and the code reference.
Install via pip or conda. The package requires Python > 3.6.
pip install up42-py
conda install -c conda-forge up42-py
Search & order satellite images from the UP42 catalog.
import up42
up42.authenticate(
username="<your-email-address>",
password="<your-password>",
)
# Identify the right data product for your use-case
catalog = up42.initialize_catalog()
# FIXME: to be fixed in a follow PR using newer ProductGlossary::get_collections
data_product_id = catalog.get_data_products(basic=True).get("Sentinel-2").get("data_products").get("Level-2A")
data_products = catalog.get_data_products(basic=True)
# Search and select the right scene for your use-case
search_results = catalog.search(search_parameters=catalog.construct_search_parameters(
geometry=[13.488775, 52.49356, 13.491544, 52.495167],
start_date="2022-01-01", end_date="2023-11-01",
collections=[data_products.get("Sentinel-2").get("collection")],
max_cloudcover=10, limit=10))
# Place and track the order of your selected scene
order_parameters = catalog.construct_order_parameters(
data_product_id=data_product_id, image_id=search_results.id[0])
catalog.estimate_order(order_parameters)
order = catalog.place_order(order_parameters, track_status=True)
# Stream cloud-native files directly for your use case
asset = up42.initialize_order(order_id=order.order_id).get_assets()[0]
stac_items = asset.stac_items
asset.get_stac_asset_url(stac_asset=stac_items[0].assets.get("b02.tiff"))
For any kind of issues or suggestions please see the documentation or contact support.