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


The following format is used for HTTP GET requests:

HTTP GET /{mapname}/{level}/{x}:{y}/tile.{image type}


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 inside the repository where the named tile is located.
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, 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. Must be png, gif, or jpeg.


A map image.

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



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