Hachureextracts and tiles from OpenStreetMap
Hachure / Docs / Tile API reference

Tile API reference

Version 1 of the API. Base URL https://n72.assetlines.net. Responses are gzip-compressed unless noted.

Last reviewed 2026-10-28

Authentication

Send your key as a bearer token or as a key query parameter. Use the header on servers and the query parameter in browser style URLs, where the key is visible anyway. Restrict browser keys to your origins in the dashboard.

Authorization: Bearer hx_live_8f2c...
GET /v1/tiles/planet-v4/11/1161/598.mvt?key=hx_live_8f2c...

Tiles

GET /v1/tiles/{tileset}/{z}/{x}/{y}.mvt returns a Mapbox Vector Tile in the XYZ scheme. Tilesets: planet-v4 (zoom 0 to 14, overzoom to 16) and contours-v2 (zoom 8 to 14). An empty tile returns 204.

HeaderExampleMeaning
ETag"p4-261105-a91c"Tileset, build date and content hash. Send back in If-None-Match for a free 304.
Cache-Controlpublic, max-age=3600Safe for shared caches and CDNs.
X-Hx-Build261105Build date of the data in this tile.
X-RateLimit-Remaining212Requests left in the current second.

Styles and glyphs

GET /v1/styles/{name}.json returns a MapLibre style. Names: sand and graphite. Sprites live at /v1/sprites/{name}@2x.png and glyphs at /v1/glyphs/{fontstack}/{start}-{end}.pbf. Style URLs embed your key automatically when you request them with one.

Usage

GET /v1/usage?from=2026-11-01&to=2026-11-05 returns daily counts of origin requests, cache revalidations and bytes for the key that made the call. Numbers lag real time by up to 10 minutes.

{
  "key": "hx_live_8f2c",
  "from": "2026-11-01",
  "to": "2026-11-05",
  "requests": 3418207,
  "revalidated": 22183004,
  "bytes": 108421993344
}

Rate limits

Limits are per key and per second: 10 (Field), 50 (Survey), 250 (Atlas) and 1,000 or more (Meridian). Short bursts of up to twice the limit are tolerated. Beyond that the API returns 429 with a Retry-After header in seconds.

Errors

StatusCodeWhat to do
400bad_tileCoordinates outside the tile grid or zoom out of range.
401invalid_keyKey missing, revoked or restricted to another origin.
403plan_requiredThe resource needs a higher plan. The body names it.
429rate_limitedBack off for Retry-After seconds.
503region_unavailableRetry. Routing moves you to another region within seconds.

All errors are JSON: {"error":"rate_limited","message":"Limit of 50 requests per second exceeded.","retry_after":2}.