Map Tiles

A map tile is a square geographic region on a Spherical Mercator map identified by a Google Maps XYZ-coordinate or Bing Maps quadkey.


Single-Frame Map Tile

This provides a map tile from a product frame or forecast frame.

GET /v2/frames/{frame-id}/tile/{z}/{x}/{y}.{format}?style={style-id}
GET /v2/frames/{frame-id}/tile/{quadkey}.{format}?style={style-id}

Tile Formats and Styles

The style query string parameter is not required and only affects pre-rendered image formats. The following formats are supported:

Format Image Type Style ID Applies
mvt MVT no
jpeg JPEG yes
png PNG yes
tiff GeoTIFF no

Request Examples

$ curl http://skywise-tiles.api.wdtinc.com/v2/frames/77d3b884-3833-495f-9b64-dfefe527fd28/tile/6/14/25.png
$ curl http://skywise-tiles.api.wdtinc.com/v2/frames/77d3b884-3833-495f-9b64-dfefe527fd28/tile/023112.png?style=0cadca40-1d71-46f8-8c14-a1780e43d76c

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK

Single-Frame TileJSON

This provides TileJSON (version 2.1.0) for a product frame or forecast frame.

GET /v2/frames/{frame-id}/tiles.json?format={format}&style={style-id}

Tile Formats and Styles

No query string parameters are required. PNG images are provided by default. Styles only affect pre-rendered image formats. The following formats are supported:

Format Image Type Style ID Applies
mvt MVT no
jpeg JPEG yes
png PNG yes
tiff GeoTIFF no

Request Examples

$ curl http://skywise-tiles.api.wdtinc.com/v2/frames/77d3b884-3833-495f-9b64-dfefe527fd28/tiles.json?format=png
$ curl http://skywise-tiles.api.wdtinc.com/v2/frames/77d3b884-3833-495f-9b64-dfefe527fd28/tiles.json?style=0cadca40-1d71-46f8-8c14-a1780e43d76c

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "tilejson": "2.1.0",
  "attribution": "<a href='http://wdtinc.com'>Weather Decision Technologies</a>",
  "scheme": "xyz",
  "tiles": [
    "http://skywise-tiles.api.wdtinc.com/v2/frames/77d3b884-3833-495f-9b64-dfefe527fd28/tile/{z}/{x}/{y}.png?style=0cadca40-1d71-46f8-8c14-a1780e43d76c"
  ],
  "minzoom": 2,
  "maxzoom": 17,
  "bounds": [ -136.45, 20.09, -60.83, 52.46 ]
}