Tiles API

Lists the tilesets, describes each as TileJSON and delivers tiles as {z}/{x}/{y}. The whole product is also available as one PMTiles file; see Tilesets.

Base URL: https://api.mapx.at · Rate-limit zone: search (10/s), tiles (100/s) · Guide: Maps

List tilesets

GET /v1/tiles

Name, aliases, type (vector, raster, dem), format, zoom range, bounds, TileJSON URL, attribution and data date (stand) per tileset. Old German names (basis, kataster, hoehenlinien, relief, dop, dop_flugblock) are listed under aliases and remain valid until 2027-05-31 (responses carry Deprecation, Sunset and Link headers).

Example

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/tiles" | jq

const res = await fetch("https://api.mapx.at/v1/tiles", { headers: { Authorization: "Bearer YOUR_TOKEN" } });
const data = await res.json();

import requests

res = requests.get("https://api.mapx.at/v1/tiles", headers={"Authorization": "Bearer YOUR_TOKEN"})
data = res.json()

Example response

{
  "tilesets": [
    {
      "name": "streets",
      "aliases": [
        "basis"
      ],
      "type": "vector",
      "format": "pbf",
      "tilejson": "https://api.mapx.at/v1/tiles/streets.json",
      "minzoom": 0,
      "maxzoom": 14,
      "bounds": [
        9.5,
        46.3,
        17.2,
        49.1
      ],
      "attribution": "...",
      "stand": "2026-10-01"
    }
  ]
}

Errors (details: error catalog)

TileJSON 3.0.0

GET /v1/tiles/{tileset}.json

TileJSON of a tileset (names from /v1/tiles, plus dtm and dsm). ETag/Last-Modified, If-None-Match gives 304.

Parameters

Example

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/tiles/streets.json" | jq

const res = await fetch("https://api.mapx.at/v1/tiles/streets.json", { headers: { Authorization: "Bearer YOUR_TOKEN" } });
const data = await res.json();

import requests

res = requests.get("https://api.mapx.at/v1/tiles/streets.json", headers={"Authorization": "Bearer YOUR_TOKEN"})
data = res.json()

Example response

{
  "tilejson": "3.0.0",
  "name": "streets",
  "tiles": [
    "https://tiles.mapx.at/v1/tiles/streets/{z}/{x}/{y}.pbf"
  ],
  "minzoom": 0,
  "maxzoom": 14,
  "bounds": [
    9.5,
    46.3,
    17.2,
    49.1
  ]
}

Errors (details: error catalog)

XYZ tile

GET /v1/tiles/{tileset}/{z}/{x}/{y}.{ext}

ext must match the tile type: pbf (alias mvt) for vector, webp, png or jpg for raster. Missing tile or wrong extension: 404 problem+json. Vector tiles are gzip-compressed (Content-Encoding: gzip, decompressed if the client does not accept gzip). ETag from the file hash, If-None-Match gives 304, Cache-Control: public.

Parameters

Example

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/tiles/streets/14/8937/5681.pbf" -o result.png

const res = await fetch("https://api.mapx.at/v1/tiles/streets/14/8937/5681.pbf", { headers: { Authorization: "Bearer YOUR_TOKEN" } });
const blob = await res.blob();

import requests

res = requests.get("https://api.mapx.at/v1/tiles/streets/14/8937/5681.pbf", headers={"Authorization": "Bearer YOUR_TOKEN"})
open("result.png", "wb").write(res.content)

Example response: application/vnd.mapbox-vector-tile, image/webp, image/png, image/jpeg · Tile

Errors (details: error catalog)

Playground

Playground GET /v1/tilesGET /v1/tiles/{tileset}.jsonGET /v1/tiles/{tileset}/{z}/{x}/{y}.{ext}

Send request

curl

The response appears here.