Vector basemap endpoint · zoom 0–16
This endpoint serves pre-rendered vector map tiles in Mapbox Vector Tile format. Tiles are static protobuf blobs generated from an OpenStreetMap extract and refreshed on a weekly schedule. There is no interactive map here — the endpoint is consumed by map clients, not opened in a browser.
GET /tiles/{z}/{x}/{y}.pbf
Coordinates follow the XYZ scheme (origin top-left, Web Mercator, EPSG:3857).
Responses carry Content-Encoding: gzip and are already compressed on disk;
clients must not request re-compression.
| Layer | Zoom | Geometry |
|---|---|---|
| water | 0–16 | polygon |
| landuse | 4–16 | polygon |
| roads | 5–16 | line |
| buildings | 13–16 | polygon |
| place_labels | 2–16 | point |
Tiles are immutable between rebuilds and are served with
Cache-Control: public, max-age=604800. Each rebuild changes the
ETag, so conditional requests remain cheap for long-lived clients.
Missing tiles return 204 No Content rather than an error — an empty
tile is a valid answer for an area with no features at that zoom.