Client libraries

Official SDKs

Typed client libraries for Python and JavaScript/TypeScript, plus a native QGIS plugin — all maintained by the Airfree engineering team.

Python SDK

pip install airfree-geo

Async-ready, fully typed, and Jupyter-friendly. Ideal for data science, scripting, and automation workflows. Supports Python 3.10+.

Features

Type-safe models with Pydantic v2
Async/await with httpx
Streaming responses for large datasets
Jupyter notebook integration
Built-in pagination helpers

Usage

$ pip install airfree-geo

import asyncio
from airfree_geo import AirfreeClient

client = AirfreeClient(api_key="your-api-key")

async def main():
    parcels = await client.cadastre.query(
        bbox=[150.9, -33.9, 151.0, -33.8],
        limit=50,
    )
    for parcel in parcels.features:
        print(parcel.properties.lot, parcel.properties.area_m2)

asyncio.run(main())

JavaScript / TypeScript SDK

npm install @airfree/geo

First-class TypeScript types, tree-shakeable ESM build, and isomorphic Node.js + browser support. Built for modern web applications.

Features

Full TypeScript types generated from OpenAPI spec
Tree-shakeable ESM + CJS builds
Browser and Node.js 18+ support
Retry with exponential back-off
WebSocket support for real-time field sync

Usage

$ npm install @airfree/geo

import airfree from '@airfree/geo';

const client = airfree({ apiKey: process.env.AIRFREE_API_KEY });

// Query cadastral parcels within a bounding box
const parcels = await client.cadastre.query({
  bbox: [150.9, -33.9, 151.0, -33.8],
  limit: 50,
});

// Compute NDVI for an earth observation scene
const ndvi = await client.eo.compute.ndvi({ sceneId: 'scene_01J8XZ' });

console.log(parcels.features.length, ndvi.stats);

QGIS Enterprise Plugin

QGIS Plugin Manager

Install directly from the QGIS Plugin Manager. Provides native access to Airfree layers, OGC services, cadastre editing, and offline field sync from within QGIS Desktop.

Features

Native QGIS panel for Airfree layers
Drag-and-drop cadastre editing with validation
OGC WMS / WMTS / WFS layer browser
Offline field sync with sub-100 ms conflict resolution
GNSS integration for field survey workflows

View QGIS platform page →

Install

$ Search "Airfree Geospatial" in Plugins → Manage and Install Plugins

Ready to integrate?

Get your API key, pick your SDK, and make your first geospatial query in minutes.

Get API key — free Read the quickstart →

$ pip install airfree-geo import asyncio from airfree_geo import AirfreeClient client = AirfreeClient(api_key="your-api-key") async def main(): parcels = await client.cadastre.query( bbox=[150.9, -33.9, 151.0, -33.8], limit=50, ) for parcel in parcels.features: print(parcel.properties.lot, parcel.properties.area_m2) asyncio.run(main())

$ npm install @airfree/geo import airfree from '@airfree/geo'; const client = airfree({ apiKey: process.env.AIRFREE_API_KEY }); // Query cadastral parcels within a bounding box const parcels = await client.cadastre.query({ bbox: [150.9, -33.9, 151.0, -33.8], limit: 50, }); // Compute NDVI for an earth observation scene const ndvi = await client.eo.compute.ndvi({ sceneId: 'scene_01J8XZ' }); console.log(parcels.features.length, ndvi.stats);