Skip to main content

SpatialFlow Python SDK

The official Python SDK for SpatialFlow - a real-time geospatial automation platform.

Installation

pip install spatialflow

Development Installation

cd sdks/python
pip install -e ".[dev]"

Quick Start

import asyncio
from spatialflow import SpatialFlow

async def main():
    async with SpatialFlow(api_key="sf_xxx") as client:
        # List geofences
        response = await client.geofences.list()
        for geofence in response.geofences:
            print(f"{geofence.name}: {geofence.id}")

        # Get workspace usage
        usage = await client.workspaces.get_usage()
        print(f"Event units: {usage.event_units}")

asyncio.run(main())

Supported Resources

Resource Methods Description
Geofences CRUD, upload, bulk, groups Manage geofence boundaries
Workflows CRUD, execute, monitor, versioning Automation workflows
Webhooks CRUD, deliveries, DLQ, metrics Webhook endpoints and delivery tracking
Devices CRUD, location updates, shifts, sessions Device management
Account profile, API keys, metrics User account management
Workspaces get, update, usage, members, invitations Workspace settings and usage metrics
Locations ingest, batch, stats Public location ingestion API
Integrations CRUD, test Third-party service connections
Storage presigned URLs, files File upload and management

Features

  • Fully async with aiohttp
  • Automatic retry with exponential backoff
  • Pagination helpers
  • Webhook signature verification
  • Workflow builders for common patterns
  • File upload with streaming (memory efficient)

Error Handling

from spatialflow import SpatialFlow, NotFoundError, ValidationError

async with SpatialFlow(api_key="sf_xxx") as client:
    try:
        geofence = await client.geofences.get("invalid-id")
    except NotFoundError as e:
        print(f"Geofence not found: {e}")
    except ValidationError as e:
        print(f"Invalid request: {e.errors}")

Raw API Access

For advanced use cases, access the generated API clients directly:

async with SpatialFlow(api_key="sf_xxx") as client:
    # Use raw generated API
    response = await client.raw.geofences.apps_geofences_api_list_geofences()

Available via client.raw:

  • geofences, workflows, webhooks, devices, storage, locations, integrations, workspaces, account (also wrapped)
  • authentication, admin, billing, subscriptions, tiles (raw only)

Some generated APIs (email, system, public, default, e2e_test) are not exposed on the client. Use the generated client directly for those.

Documentation

Full documentation: docs.spatialflow.io/sdks/python

License

MIT

Metadata

Release files for spatialflow 3.1.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 spatialflow 3.1.0
File Size Uploaded Provenance Actions
spatialflow-3.1.0.tar.gz 328.7 kB With provenance Details for spatialflow-3.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.3 MB

Release files / spatialflow-3.1.0.tar.gz

Download URL spatialflow-3.1.0.tar.gz
Size 328.7 kB
Tags Source
SHA-256 checksum
How to use checksums
9be312cd6e3a576dfe7a887d0ae5390ef458fcc01629a505a1c53b172de72fea
BLAKE2b-256 checksum
How to use checksums
eef7e388719c53d1a4fc974a1c6f6df9aec20d995c56830b167008a67bb65c22
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Release files / spatialflow-3.1.0-py3-none-any.whl

Download URL spatialflow-3.1.0-py3-none-any.whl
Size 953.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9c59a2b4c08f859158e30bed21bf60a79f2202a05075a9c5a4d8a2cccab28f8f
BLAKE2b-256 checksum
How to use checksums
b69963a74dedf7cb8b03f762a4bbbaf09f1077567cba2dbe2efc94d72c736a2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

Security for spatialflow 3.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for spatialflow-3.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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