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.57.0.tar.gz (82.3 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.57.0-py3-none-any.whl (132.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for tilebox_datasets-0.57.0.tar.gz
Algorithm Hash digest
SHA256 a5016519d72c3ac28f7b6b1aa94f76efdede6c443ae2120b9bfbb2460cbad669
MD5 5a8b087e6a4e4b1dfcb8e2b0eed266f1
BLAKE2b-256 8a6a1a826e55ee27e4fc0afa5870e42046f137ca7cebf55e130b0e6865c21b94

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for tilebox_datasets-0.57.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a13dee6643d7c930b14db8d48ffaa2ec2cdca9cd06763fb63d868cfe2f55c5ba
MD5 d60ab41e6cd60cba5ff0ae3f07a46f77
BLAKE2b-256 2f7486a6212a22265140a56cf0d6e71c571137e1b588cd7c214a1ae2bf6b45bf

See more details on using hashes here.

Provenance

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