Metadata-Version: 2.4
Name: altitude-sdk
Version: 1.0.1
Summary: Python client SDK for the Geotab Altitude APIs
Project-URL: Homepage, https://www.geotab.com
Project-URL: Documentation, https://developers.geotab.com
Author: Geotab
License: Copyright (c) 2026 Geotab Inc. All rights reserved.
        
        PROPRIETARY AND CONFIDENTIAL
        
        This software and its source code are the proprietary and confidential property
        of Geotab Inc. ("Geotab"). The software is licensed, not sold.
        
        Subject to the terms of a separate written agreement between you and Geotab, you
        are granted a non-exclusive, non-transferable, revocable license to install and
        use this software solely for its intended purpose of accessing the Geotab
        Altitude APIs.
        
        You may NOT, without the prior written permission of Geotab:
          - copy, modify, or create derivative works of the software;
          - distribute, sublicense, lease, rent, or otherwise transfer the software;
          - reverse engineer, decompile, or disassemble the software except to the
            extent expressly permitted by applicable law.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL GEOTAB BE
        LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF
        CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE
        SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
License-File: LICENSE
Keywords: altitude,api,geotab,sdk,telematics
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: typing-extensions>=4.6
Description-Content-Type: text/markdown

# 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

```bash
pip install altitude-sdk
```

## Usage

```python
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
```
