AcuGIS Python SDK

Python SDK for the AcuGIS Cloud geospatial platform. Manage maps, datasets, reports, and search programmatically.

from acugis_sdk import Client

client = Client(
    host="https://cloud.acugis.com",
    token="agp_xxxxxxxx",
)

projects = client.maps.list()
client.maps.publish("roads.qgz", title="Road Network")

datasets = client.datasets.list()
client.datasets.download("roads", output="roads.gpkg")

reports = client.reports.list()
results = client.search("roads")

Installation

pip install acugis-sdk

Development install

cd acugis-sdk
python -m venv .venv

# Linux / macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

pip install -e ".[dev]"

Authentication

Personal access token (recommended)

from acugis_sdk import Client

client = Client(
    host="https://cloud.acugis.com",
    token="agp_xxxxxxxx",
)

Environment variables

export ACUGIS_URL=https://cloud.acugis.com
export ACUGIS_TOKEN=agp_xxxxxxxx

client = Client()  # uses env / saved config

Saved configuration

If neither host nor token are passed, the SDK reuses the same configuration as other AcuGIS tools under ~/.config/acugis/ (config.json and optional session cookies).

Quick start

from acugis_sdk import Client

client = Client(token="agp_xxxxxxxx", host="https://cloud.acugis.com")

for m in client.maps.list():
    print(m["title"])

client.maps.publish("roads.qgz", title="Road Network")
client.datasets.download("roads", output="roads.gpkg")
results = client.search("roads")

Service objects

Documentation

See docs/SDK.md for full API documentation and examples/ for runnable samples.

Exceptions

SDK methods raise acugis_sdk.AcugisError for domain and API failures. They do not print to the console.

License

MIT — see LICENSE.