Skip to main content
Tilebox indexes Sentinel-2 metadata and asset locations in the open_data.aws_earth.sentinel2 dataset. Query the metadata first, then use the storage client to read only the image data you need.
Asset collections and the storage client are currently available in the Python SDK.

Prerequisites

Select a Sentinel-2 datapoint

Query a small time and area of interest, then select one low-cloud observation:
Python
See Query open data metadata for more query patterns.

Resolve the assets

Turn the selected datapoint into an asset collection. Each asset describes one file and the locations from which it can be accessed.
Python

Read a Cloud Optimized GeoTIFF window

The Sentinel-2 image assets are Cloud Optimized GeoTIFFs (COGs). Open an image remotely and request a pixel window without downloading the complete file:
Python
window_from_bounds transforms geographic bounds into the image coordinate system and clips the resulting window to the image.

Download an asset

Use download when you need the complete file locally:
Python

Next steps

Read and download assets

Learn about streaming, downloads, GeoTIFF access, and location selection.

Assets and storage

Understand how asset metadata connects dataset queries to file storage.