Airfree
Developers

Build on Airfree

APIs, SDKs, and developer tools for building location-aware applications on the world's most complete spatial intelligence platform.

Quickstart

Up and running in minutes

01

Create an account

Sign up for an Airfree developer account — free tier included.

02

Get your API key

Generate a key in your dashboard under Settings → API Keys.

03

Make your first call

Follow a quickstart guide and get a live response in under five minutes.

04

Build and scale

Upgrade to a paid plan when you are ready to go to production.

Read the full quickstart
maps-quickstart.ts
// Install the Airfree Maps SDK
// npm install @airfree/maps-sdk

import { AirfreeMap } from '@airfree/maps-sdk';

const map = new AirfreeMap({
  container: 'map',
  style: 'airfree',
  center: [138.6007, -34.9285],
  zoom: 12,
});

// Add a cadastre layer
map.addLayer({
  id: 'cadastre',
  type: 'fill',
  source: 'airfree',
  'source-layer': 'parcels',
  paint: {
    'fill-color': '#1847D1',
    'fill-opacity': 0.25,
  },
});

APIs

Platform APIs

Geospatial API

REST + OGC

Access the full Airfree GIS platform — tile rendering, feature queries, OGC endpoints, geocoding, and analysis operations.

View docs

Maps Embed SDK

JavaScript

Drop an interactive Airfree map into any web application with a few lines of JavaScript. Supports custom styles, layers, and event hooks.

View docs

Earth Observation API

REST + STAC

Stream and analyse satellite imagery, change detection results, and AI-labelled rasters programmatically.

View docs

Digital Twin API

WebSocket + REST

Ingest IoT sensor feeds, control 3D scene state, and query the live digital twin model of a city or asset.

View docs

Documentation

Browse the docs

Reference

API changelog

A running record of additions, changes, and deprecations across the Airfree platform APIs, newest first.

Read
Guides

Webhooks

Receive real-time event notifications from the Airfree platform, verify their signatures, and process them reliably.

Read
Reference

API reference

An overview of the Airfree platform APIs: one origin, one token, versioned service paths, and consistent conventions across every service.

Read
Guides

SDKs & libraries

Official Airfree SDKs for Python, TypeScript, Go, and Java handle authentication, retries, and typed responses so you can skip the boilerplate.

Read
Guides

Rate limits

How the Airfree platform applies rate limits and quotas, the headers that report your budget, and how to back off cleanly.

Read
APIs

Cadastre API

Read and manage authoritative parcels and boundaries — tenant-scoped, topology-validated, and versioned — through the Airfree cadastre service.

Read
APIs

Earth Observation API

Stream and analyse satellite imagery, analysis-ready data, and change-detection results programmatically over a STAC-catalogued archive.

Read
APIs

Digital Twin API

Ingest IoT sensor feeds, control 3D scene state, and query the live digital twin model of a city or asset over WebSocket and REST.

Read
APIs

Geospatial API

Access the full Airfree GIS platform over REST and OGC standards — tile rendering, feature queries, coverages, processing, and geocoding.

Read
APIs

Maps Embed SDK

Drop an interactive Airfree map into any web application with a few lines of JavaScript — custom styles, layers, and event hooks included.

Read
Getting Started

Quickstart

Create an account, obtain a token, and make your first authenticated call to the Airfree platform in under five minutes.

Read
Getting Started

Authentication

How the Airfree platform authenticates requests: OpenID Connect via Keycloak, Authorization Code with PKCE for browser apps, and bearer-token validation at the edge.

Read

Join our developer community

Connect with other developers building on Airfree. Ask questions, share projects, and get early access to new features.

Get access