API Reference

Terrain Tiles API Reference

Base URL

https://tiles.maptoolkit.net

Endpoints

`GET /{id}.json`

Get TileJSON metadata for a tile source

Returns a TileJSON 2.2.0 document describing the tile source. Use terrain.json or hillshading.json to get the metadata for each source.

Parameter	In	Type	Required	Description
`id`	path	string	Yes	Tile source ID. Use `terrain` or `hillshading`. One of: `terrain`, `hillshading`.

Status	Description
`200`	TileJSON 2.2.0 document.
`404`	Tile source not found.
`500`	Internal server error.

`GET /{id}/{z}/{x}/{y}.{format}`

Get a terrain or hillshading tile

Returns a single raster tile.

terrain tiles are returned as WebP (Terrarium-encoded elevation data).
hillshading tiles are returned as PNG.
Tiles above zoom 14 return an empty 200 response.

Parameter	In	Type	Required	Description
`id`	path	string	Yes	Tile source ID. Use `terrain` or `hillshading`. One of: `terrain`, `hillshading`.
`z`	path	integer	Yes	Zoom level (0–14).
`x`	path	integer	Yes	Tile column (X coordinate in the XYZ tile grid).
`y`	path	integer	Yes	Tile row (Y coordinate in the XYZ tile grid).
`format`	path	string	Yes	Tile format. Use `webp` for terrain-RGB, `png` for hillshading. One of: `png`, `webp`.

Status	Description
`200`	Tile data. An empty body indicates the tile is outside the source’s zoom range.
`500`	Internal server error.

Try it

The console below sends live requests against the endpoints above. You can browse it without an API key; Execute needs one, because every endpoint requires the api_key query parameter and returns 403 without it. Use Authorize to add your key. See First Steps if you do not have one yet.