Skip to main content

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

Project description

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()
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, open a GitHub issue or contact support.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

up42_py-0.35.0.tar.gz (47.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

up42_py-0.35.0-py3-none-any.whl (58.4 kB view details)

Uploaded Python 3

File details

Details for the file up42_py-0.35.0.tar.gz.

File metadata

  • Download URL: up42_py-0.35.0.tar.gz
  • Upload date:
  • Size: 47.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.7 Darwin/22.6.0

File hashes

Hashes for up42_py-0.35.0.tar.gz
Algorithm Hash digest
SHA256 b1dea95dc959240fe4d68562b36113da69f132447243f956678ad481e23e82b5
MD5 e8efa59b4da54ac67e737c5845669ab7
BLAKE2b-256 4ff794e2d1183ebe533ecdc942182fa45c68476443aa1f40b1fe147e933b63a7

See more details on using hashes here.

File details

Details for the file up42_py-0.35.0-py3-none-any.whl.

File metadata

  • Download URL: up42_py-0.35.0-py3-none-any.whl
  • Upload date:
  • Size: 58.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.7 Darwin/22.6.0

File hashes

Hashes for up42_py-0.35.0-py3-none-any.whl
Algorithm Hash digest
SHA256 faa84ac641899b030988c7666bdbc7c8ef214a539c36e36688f4d0b23a23772f
MD5 d3f8fff68f60851fa65a32b8f6d40abc
BLAKE2b-256 afa927cd40e69f49efda943c1ce7c4c8fa960288961a69047e28dce51955f64d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page