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.56.0.tar.gz (78.9 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.56.0-py3-none-any.whl (128.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tilebox_datasets-0.56.0.tar.gz
  • Upload date:
  • Size: 78.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for tilebox_datasets-0.56.0.tar.gz
Algorithm Hash digest
SHA256 142a3b398ac7f040b0fd9278879369c609083f948bb5e97412ad945c030b3962
MD5 0c450078b15a1465869c0e9ea37f0277
BLAKE2b-256 8ac5465ade8addbaea01883861ae17455984b4b2472fb57111a12419bfde8736

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_datasets-0.56.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.56.0-py3-none-any.whl.

File metadata

File hashes

Hashes for tilebox_datasets-0.56.0-py3-none-any.whl
Algorithm Hash digest
SHA256 259d490a4154f97c0f6c82eb4438ac5e707b82b25c3d594e7f3cebab2ff13d69
MD5 22d828c401326f82ab99de11db25bb7e
BLAKE2b-256 2f01aee2773f095e1905d27802fe9a049ed7ef182b958ae158bc4196a0ed2302

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_datasets-0.56.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