altitude-sdk 1.0.0

Python client SDK for the Geotab Altitude APIs

altitude-sdk

altitude-sdk is a lightweight Python client for the Geotab Altitude APIs. It is designed to make getting started quick and easy, handling authentication, async job submission and polling, and result pagination so you can focus on the data rather than the plumbing.

Requires Python 3.10+.

Installation

pip install altitude-sdk

Usage

import time

from altitude_sdk import AltitudeClient

# Authenticate with your API key; sent as `Authorization: Bearer <api_key>`.
client = AltitudeClient(api_key="your-api-key")

params = {
    "zones": [{"code": "32007", "iso_3166_2": "US-NV", "type": "County"}],
    "isMetric": False,
    "dateFrom": "2025-03-05",
    "dateTo" : "2025-03-01"
}

# All-in-one: submit → poll to completion → paginate → list of results
rows = client.stop_analytics.rda(params).all()

# Or step-by-step for more control:
wf = client.stop_analytics.rda(params)
wf.run()                                    # submit the job (non-blocking); sets wf.id
while wf.status()["status"] != "DONE":      # poll until the job finishes
    time.sleep(5)
rows = wf.results()                         # fetch the results once DONE