Tiles API

Generally available

Vector (MVT) and raster (PNG) XYZ tiles.

Standards-based XYZ tiles. Use the URL template in any tile-capable client. Vector tiles are MVT; raster tiles are PNG. Tiles carry ODbL attribution + licensing headers. Bulk .mbtiles/.pmtiles download is not offered (share-alike).

GET/maps/tiles/{z}/{x}/{y}.mvt

Vector tile (Mapbox Vector Tile).

Parameters

Name	In	Req	Description
`z`	path	yes	Zoom level.
`x`	path	yes	Tile column.
`y`	path	yes	Tile row.
`key`	query	yes	API key (or X-API-Key header).

Responses

200 — MVT tile (application/x-protobuf).
404 — No tile at this coordinate.

curl "https://airfreemap.com/api/v1/maps/tiles/14/14731/9038.mvt?key=$AIRFREE_MAPS_KEY" -o tile.mvt

GET/maps/tiles/{z}/{x}/{y}.png

Raster tile (PNG).

Parameters

Name	In	Req	Description
`z/x/y`	path	yes	Tile coordinate.
`key`	query	yes	API key.

Responses

200 — PNG tile.

curl "https://airfreemap.com/api/v1/maps/tiles/14/14731/9038.png?key=$AIRFREE_MAPS_KEY" -o tile.png