Skip to main content
class Client(
    *,
    url: str = "https://api.tilebox.com",
    token: str | None = None,
    warn_if_unauthenticated: bool = True,
    transport: Literal["grpc", "http1"] = "grpc",
)
Create a Tilebox datasets client.

​
Parameters

​
url
str
Tilebox API Url. Defaults to https://api.tilebox.com.
​
token
str | None
The API key to authenticate with. If not set, the TILEBOX_API_KEY environment variable is used.
​
warn_if_unauthenticated
bool
Whether to log a warning when no API key is provided for the Tilebox API URL. Defaults to True.
​
transport
Literal["grpc", "http1"]
Network transport to use for API requests. Defaults to "grpc". Use "http1" to force the Connect protocol over HTTP/1.1 on networks that do not support gRPC over HTTP/2 correctly.
If no API key is provided, the client uses anonymous open data access for public datasets. 
from tilebox.datasets import Client

# read token from an environment variable
client = Client()

# or provide connection details directly
client = Client(
    url="https://api.tilebox.com",
    token="YOUR_TILEBOX_API_KEY",
)