Skip to main content

geolens (Python SDK)

Auto-generated Python SDK for the GeoLens API.

Apache-2.0 licensed. Typed attrs-based dataclasses + httpx async-ready client + Bearer-token + API-key auth helpers.

See docs.getgeolens.com for installation, regeneration, and version-pin policy.

Quickstart

from geolens import GeolensClient

client = GeolensClient(base_url="https://geolens.example.com/api", bearer_token="...")
# The deployed API is served under /api, so include that suffix in base_url.
# See docs.getgeolens.com for endpoint usage examples.

Downloading a COG

With a remote source behind a raster dataset, the COG download answers 302 with the file's URL. With S3 it may do the same when the server has presigned downloads enabled, and streams the file otherwise. cog_download fetches that URL without sending your GeoLens credentials to the storage host, and returns the file on every storage backend. A further redirect from the storage host is followed only on that same host. The file is streamed into a temporary file that moves to disk past a few MiB, so a large COG isn't held in memory:

import shutil

from geolens import cog_download

cog = cog_download.sync(dataset_id, client=client.client)  # or: await cog_download.asyncio(...)
with cog.payload as source, open("dataset.cog.tif", "wb") as target:
    shutil.copyfileobj(source, target)

Metadata

Release files for geolens 1.22.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for geolens 1.22.0
File Size Uploaded
geolens-1.22.0.tar.gz 354.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for geolens 1.22.0
File Interpreter ABI Platform
geolens-1.22.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.4 MB

Release files / geolens-1.22.0.tar.gz

Download URL geolens-1.22.0.tar.gz
Size 354.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fb34bd28eb8188e5d95097340cda5d58a5f9b3a9676fafa95a60d36137cb0ff3
BLAKE2b-256 checksum
How to use checksums
ef83957c62dfed5df52340154f1a58c3b795e8f16efad7445bca4197ce1e5db8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / geolens-1.22.0-py3-none-any.whl

Download URL geolens-1.22.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
2fd8d779e6768a48b8ed750511c0ddf43b93743043c182e599a8ed6ea236bada
BLAKE2b-256 checksum
How to use checksums
f55b7f6aeb531344b22e2c1d19ff2c3a63fd852afa4ba98d0ca2b98cf5e2332c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

1.24.0

2 release files

1.23.1

2 release files

This release

1.22.0 This release

2 release files

1.21.0

2 release files

1.20.0

2 release files

1.19.1

2 release files

1.17.0

2 release files

1.16.1

2 release files

1.16.0

2 release files

1.15.1

2 release files

1.15.0

2 release files

1.14.2

2 release files

1.14.1

2 release files

1.14.0

2 release files

1.13.1

2 release files

1.13.0

2 release files

1.12.0

2 release files

1.11.1

2 release files

1.11.0

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.1

2 release files

1.7.0

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.13

2 release files

1.4.11

2 release files

1.4.10

2 release files

1.4.9

2 release files

1.4.8

2 release files

1.4.7

2 release files

1.4.6

2 release files

1.4.5

2 release files

1.4.4

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.0

2 release files

1.0.0

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page