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.58.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.58.0-py3-none-any.whl (172.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tilebox_datasets-0.58.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.58.0.tar.gz
Algorithm Hash digest
SHA256 01b92a7b9e16f1eb470dbde8cd26077e5c21b5317ca2c779df31222d3f0d8e37
MD5 8036ffb48ab1e6bc686c84640e273333
BLAKE2b-256 7b5199a65a0c39fd2ca927e307d2b30d189d806fdb245a11e9d082c58943fddd

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for tilebox_datasets-0.58.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fe8cd0eae1b83db3b2709ce0b8f2a15bf7631dbdc25abd0476eccc42408bf358
MD5 a87a6f0fc38dc9683137ebf1be494a7d
BLAKE2b-256 7a2e0472bd9c25979525425f24f369dd97e9435d7f50e96c01ebf754eb1a7b37

See more details on using hashes here.

Provenance

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