Skip to main content

Tilebox Logo

Documentation | Console | Example Gallery

Tilebox Datasets

Access satellite data using the Tilebox datasets python client powered by gRPC and Protobuf.

Quickstart

Install using pip:

pip install tilebox-datasets

Instantiate a client:

from tilebox.datasets import Client

# create your API key at https://console.tilebox.com
client = Client(token="YOUR_TILEBOX_API_KEY")

Explore datasets and collections:

datasets = client.datasets()
print(datasets)

sentinel2_msi = client.dataset("open_data.copernicus.sentinel2_msi")
collections = sentinel2_msi.collections()
print(collections)

Query data:

s2a_l1c = sentinel2_msi.collection("S2A_S2MSI1C")
results = s2a_l1c.query(temporal_extent=("2025-03-01", "2025-06-01"), show_progress=True)
print(f"Found {results.sizes['time']} datapoints")  # Found 220542 datapoints

Spatio-temporal queries:

from shapely.geometry import shape

area_of_interest = shape(
    {
        "type": "Polygon",  # coords in lon, lat
        "coordinates": [[[-5, 50], [-5, 56], [-11, 56], [-11, 50], [-5, 50]]],
    }
)
s2a_l1c = sentinel2_msi.collection("S2A_S2MSI1C")
results = s2a_l1c.query(
    temporal_extent=("2025-03-01", "2025-06-01"), spatial_extent=area_of_interest, show_progress=True
)
print(f"Found {results.sizes['time']} datapoints")  # Found 979 datapoints

Documentation

Check out the Tilebox Datasets documentation for more information.

License

Distributed under the MIT License (The MIT License).

Download files

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

Source Distribution

tilebox_datasets-0.59.0.tar.gz (113.1 kB view details)

Uploaded Source

Built Distribution

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

tilebox_datasets-0.59.0-py3-none-any.whl (172.3 kB view details)

Uploaded Python 3

File details

Details for the file tilebox_datasets-0.59.0.tar.gz.

File metadata

  • Download URL: tilebox_datasets-0.59.0.tar.gz
  • Upload date:
  • Size: 113.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tilebox_datasets-0.59.0.tar.gz
Algorithm Hash digest
SHA256 1404c7f57aa539d26740afe66cb0a29e2330550476b1fc2fffc5260c0f4d06d1
MD5 fa2725c608bc3f65231c9ab12d6aa01c
BLAKE2b-256 61d2ea63bfec641976bf1727c0aa03a194dedad08d783cdd047c85aa9a62da18

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_datasets-0.59.0.tar.gz:

Publisher: publish_tilebox_datasets.yml on tilebox/tilebox-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tilebox_datasets-0.59.0-py3-none-any.whl.

File metadata

File hashes

Hashes for tilebox_datasets-0.59.0-py3-none-any.whl
Algorithm Hash digest
SHA256 94f7d8dc06bbddb8b23a8f7a393830880278bf355a1114636a59e0de67d740df
MD5 f5d991234f1afcfe4f92efbf3a0a57b8
BLAKE2b-256 2eb648813e2da5b041b4f5a6de8810a71a3c30526c633c87a0ae1151b335aa15

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_datasets-0.59.0-py3-none-any.whl:

Publisher: publish_tilebox_datasets.yml on tilebox/tilebox-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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