Skip to main content
Use this guide when you already have a Copernicus datapoint from a Tilebox metadata query and want to access the product files behind it. The example uses Sentinel-2 Level-2A data, but the same storage client pattern applies to Copernicus products supported by Tilebox. Tilebox indexes product metadata as datasets. Product files remain in the Copernicus Data Space Ecosystem, so file access uses the CopernicusStorageClient with Copernicus S3 credentials.

Prerequisites

Select a Sentinel-2 datapoint

Start with a small metadata query and select one datapoint to access. For a deeper guide to open data discovery and metadata filtering, see Query open data metadata.
Python

Create the Copernicus storage client

Create a CopernicusStorageClient with your Copernicus S3 credentials. The optional cache_directory controls where downloaded files are stored locally.
Python
These credentials are Copernicus Data Space S3 credentials, not your Tilebox API key.

Download the complete product

Use download when you need the complete Sentinel-2 product directory. The storage client resolves the product location from the Tilebox datapoint metadata and downloads the matching files into the local cache directory.
Python
Output

Download selected product files

Sentinel-2 products contain many files, including metadata, masks, quicklook images, and bands at different resolutions. Use list_objects and download_objects when you only need specific files.
Python
Use this pattern when a workflow only needs a few bands or metadata files. It reduces transfer time and local storage compared with downloading the full .SAFE product.

Preview the product

Many Copernicus products include a quicklook image. In a notebook, use quicklook to display the product preview without downloading the full product first.
Python
Sentinel-2 quicklook image

Sentinel-2 quicklook image © ESA

Next steps

Query open data metadata

Find Copernicus products by time, location, and metadata fields.

Storage clients

Learn about the other Tilebox storage clients for open data products.

Access USGS Landsat data

Download Landsat product files with the USGS Landsat storage client.