up42-py on Pypi

Python SDK for UP42, the geospatial marketplace and developer platform.

Highlights

Python package for easy access to UP42's geospatial collections and analytics workflows
Use UP42 functionality together with your preferred Python libraries!

Installation & Documentation

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

Use cloud-native geospatial data for your use cases in less than 25 lines of code!

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