Generating Tiles from a File with Tile Generator


This process generates tiles using a request file.


To generate tiles, use the following options:

Parameter Required Description Example
-url=<url> yes The URL to the MapTiling service (MTS) or proxy when configured with MTS as an origin server.
Note: When using a third-party cache tool, specify the third-party URL instead of the Spectrum MapTiling service URL. Refer to the third-party help for details.
url=http://<server>:<port>/ rest/Spatial/MapTilingService
-fileInput=<fileInput> yes Path and name of the request file to generate the tiles. fileInput=C:\SpatialServer\ TILING\MapTilingRequests.txt
-format=<format> yes Tile format type (gif, jpeg, jpg, mvt, png).
Note: The -format type replaces the deprecated -image type.
-threads=<threads> no Number of threads to use to generate the tiles. To maximize throughput, set to the number of CPUs for the machine. threads=4
-dirOutput=<dirOutput> no Directory path to save generated tiles locally. See also Output Directory (-dirOutput).
Note: When using a third-party cache tool, you may not need to write tiles to a directory (using dirOutput). Refer to the third-party help for details.
dirOutput=C:\SpatialServer\ TILING\OUTPUT
-username=<username> yes Spectrum user accessing the repository. Either an administrator (any user with the Spectrum admin role) or a user with Spatial access permission to the named tile and its dependent resources. username=admin
-password=<password> yes Password for the Spectrum user. password=admin
-cache=<cache> no Use when working with a third-party cache tool that requires a cache header. See also Tile Caching (-cache). cache=false


First you must have a file containing tile information. For details about creating this request, see Creating a Tile Request File with Tile Generator. This request is an example that generate the file:

cache_builder.bat -url=http://<server>:<port>/rest/Spatial/MapTilingService -fileOutput=C:\SpatialServer\TILING\MapTilingRequests.txt -map=/NamedTiles/WorldTile -level="2,5-8" -mbr-8275553,4932706,-8188786,5003330" -username=admin -password=admin

This request reads the file containing tile information and then generates tiles using that information:

cache_builder.bat -url=http://<server>:<port>/rest/Spatial/MapTilingService -fileInput=C:\SpatialServer\TILING\MapTilingRequests.txt -format=png -threads=4 -dirOutput=C:\SpatialServer\TILING\OUTPUT -username=admin -password=admin