Skip to content
/ up42-py Public

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

License

Notifications You must be signed in to change notification settings

up42/up42-py

Repository files navigation

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

Documentation   •   UP42.com   •   Support

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

Support

For any kind of issues or suggestions please see the documentation or contact support.