getTile

Description

Returns generated map tiles from the Map Tiling Service based on the input parameters specified.

Parameters

For information on the parameter types listed below, see Request URL Data Types.

Parameter Type Required Description
name String yes Specifies the name of the named tile from which the tile is generated. You must specify the location in the repository for the named tile.
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 Tile Service. For example, the levels demonstrated above are for Envinsa's High named map. 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. You can determine these values by calling the getDescription method and examining the returned MapDescription object. For more information, see getDescription and MapDescription.

col Integer yes Specifies the column of the tile, based on the level parameter specified.
row Integer yes Specifies the row of the tile, based on the level parameter specified.
output String yes Specifies the response image format. Must be png, gif, or jpg.

Returns

A map image.

A JSON error will be returned if one of the following conditions are met:

Example


http://<server>:<port>/rest/Spatial/LegacyMapTilingService/getTile?
  name=/NamedTiles/WorldTile
  &level=2
  &col=1
  &row=1
  &dpi=96
  &output=png
			

The following example shows the image output returned in the response: