Tile
Description
Returns generated map tiles from the Map Tiling Service based on the input parameters specified.
HTTP GET URL Format
The following format is used for HTTP GET requests:
HTTP GET /{mapname}/{level}/{x}:{y}/tile.{image type}
Parameters
For information on the parameter types listed below, see Request URL Data Types.
Parameter | Type | Required | Description |
---|---|---|---|
mapname | String | yes | The name of the named tile to generate the tile from. You must specify the location of the named tile in the repository. |
level | Integer | yes |
Determines the zoom level of the tile to be returned. The level shows how close the map image is to the Earth. Level 1 is the furthest away and is composed of one tile that the entire map will be drawn into. Level 2 is composed of 4 tiles, 2 across and 2 down. Each tile is a quarter of the entire map. Level 3 is composed of 16 tiles, 4 across and 4 down, and so on. The higher the level specified, the closer to the Earth the map image appears. For example, levels 1 to 3 usually show global or hemispheric detail, levels 4 to 15 show county/state/province level of detail and some larger cities, levels greater that 15 show street level views. What the levels actually display is dependant on the named map published to the Map Tiling Service. For example, if you published a map of New York, Toronto, or London then level 1 would be a street level map of Toronto while high levels would be more detailed. This parameter must be set to a value greater than or equal to the minLevel value and less than or equal to the maxLevel value for the named map. |
x | Integer | yes | Specifies the column of the tile, based on the level parameter specified. |
y | Integer | yes | Specifies the row of the tile, based on the level parameter specified. |
.{image type} | Image Mime | yes | Specifies the response image format (gif, jpeg, jpg, mvt, or png). |
Returns
A map image.
A JSON error will be returned if one of the following conditions are met:
- The mapname parameter is not specified.
- The name specified is not an available named map on the Tiling Service.
- The level parameter is less than the minlevel defined in the metadata for the specified map.
- The level parameter is greater than the maxlevel defined in the metadata for the specified map.
- The x parameter is less than 1.
- The x parameter is greater than what the level dictates the map can provide.
- The y parameter is less than 1
- The y parameter is greater than what the level dictates the map can provide.
Example
http://<server>:<port>/rest/Spatial/MapTilingService/Samples/NamedTiles/WorldTile/2/1:1/tile.png
The following example shows the image output returned in the response: