Named tiles are stored in the repository, and define how an individual hosted named map is used by the Map Tiling Service. For each map you want to expose through the Map Tiling Service you must have an equivalent named tile. In the named tile file, the NamedTile element contains the parameters that define the named tile, each of which contains some or all of the following list of child elements:
Description Required
Type Parameter
The alias of the named map stored in the map repository. This alias can be different than the yes
string DisplayName
actual name of the named map, and will be used in the tiling service requests to call the named tile. The metadata description of the named map. This information is presented to the user when a yes
string Description
getDescriptioncall is sent to the Map Tiling Service.
The directory and name of the actual named map in the repository, from the repository base. For yes
string ResourceLocation
example, if the named map is located at
http://localhost:8080/RepositoryService/repository/ default/Samples/NamedMaps/World, then you would define the ResourceLocation as /NamedMaps/World.
You must specify the starting '/'.
Note:
The coordinate system projection to host the named map. The Map Tiling Service will transform the yes
string Projection
named map into the projection defined. The projection is defined using the EPSG format. For best results, use epsg:3857 (Spherical Mercator). The minimum zoom level to host the map. Must be greater than zero. SeeWhat Is Tile Level?for information to help define the level.
yes integer
MinimumLevel
The maximum zoom level to host the map. Must be greater than zero. SeeWhat Is Tile Level?for information to help define the level.
yes integer
MaximumLevel
Width of a tile in pixels. Must be greater than or equal to 16 and must be a number that can be yes
integer TileWidth
calculated from a 2nequation (for example 24=16, 25=32, 28=256).
The bounds of the map. Coordinates are comma separated and in the coordinate system specified yes
string Bounds
by the projection option. The bounds must represent a square in order for proper tile divsioning.
Description Required
Type Parameter
The available types of tiles generated by the tile server for this map only.
no string
MimeList
The date on which the client should delete the map tile from the cache, and request a new copy from no
string ExpirationDate
the server. The ExpirationDate value must be specified as a W3C formatted date string.
The ExpirationDate parameter has effect only when using external caching software such as Squid or Apache.
Note:
The resolution of the tile images in dots per inch (the number of individual dots that can be placed no
integer MapResolution
within the span of one linear inch). If not specified, the GlobalMapResolution is used. The minimum dpi you can define is 72. Less than 72 dpi, the service will throw an exception.
The rendering quality (anti-alias) of the tile images generated. You can specify either Speed or Quality. no
string MapRendering
If a MapRendering preference is not specified, the global preference in the configuration will be used to determine the maps rendering quality. If neither is specified, the default rendering quality is Speed.
The rendering quality (anti-alias) of the tile images generated from raster maps. You can specify either no
string RasterRendering
Speed or Quality. If a MapRendering preference is not specified, the global preference in the configuration will be used to determine the maps rendering quality. If neither is specified, the default rendering quality is Speed.
Tells the service not to render LabelLayers when generating a tile. The value is case-insensitive. If no
boolean RenderLabels
a RenderLabels preference is not specified, the global preference in the configuration will be used. If neither is specified, the default is 'true'.
Used to prevent the clipping of labels when a label crosses a tile boundary. The PadFactor controls no
double PadFactor
the amount of space is rendered around the requested tile with 0 meaning no padding, 1 meaning padding of 1 tile around the requested tile and so on. If a PadFactor preference is not specified, the global preference in the configuration will be used. If neither is specified, the default is 1.0.
The level of background opacity (transparency) for the tile images. The background opacity is defined no
double BackgroundOpacity
on a scale from 0.0 (zero) to 1.0. Where 0.0 is completely transparent and 1.0 is completely opaque. For example a value of 0.75, would be 75 percent transparent.
The following is an example of a named tile definition:
<Description>Map Of The World</Description> <ResourceLocation>/NamedMaps/WorldMap</ResourceLocation> <Projection>epsg:3857</Projection> <MinimumLevel>1</MinimumLevel> <MaximumLevel>20</MaximumLevel> <TileWidth>256</TileWidth> <Bounds>-20037508.34,-20037508.34,20037508.34,20037508.34</Bounds> <MimeList> <Mime>image/png</Mime> <Mime>image/jpeg</Mime> <Mime>image/gif</Mime> </MimeList> <ExpirationDate>2019-12-31</ExpirationDate> <MapResolution>96</MapResolution> <MapRendering>Speed</MapRendering> <RenderLabels>false</RenderLabels> <PadFactor>1.0</PadFactor> </NamedTile>