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.21.1

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.21.1
File Size Uploaded
geolens-1.21.1.tar.gz 347.3 kB Details

Built distribution (wheel)

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

Total release size: 1.4 MB

Release files / geolens-1.21.1.tar.gz

Download URL geolens-1.21.1.tar.gz
Size 347.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f448f2825f359d8ba7a090d8dc9af7ec4a70d8146bc335c0ffcf942f2121aa5a
BLAKE2b-256 checksum
How to use checksums
d9f7701b917c979c9e9624abcc7015af2e496c93c6e66e82a696fea7b280175b
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":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

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

Download URL geolens-1.21.1-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
3fba222dd978acef065a1ded2de2f9790a19afca430abd13949406f8c87d7c6f
BLAKE2b-256 checksum
How to use checksums
349c3d417f2c5c849275a9f335dee5413907bae998021a16a3cdc79c1129b29a
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":"24.04","id":"noble","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

This release

1.21.1 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