Looking for on-premise 3D Tiling? Contact sales for an evaluation.
Extract the contents of
The main executable is
terrain-tiler and can be found under
If you wish to run the examples download and extract SampleData.zip into a new
Windows binaries require Visual C++ Redistributable for Visual Studio 2017. Download and run the installer.
Using the tiler
The Cesium ion terrain tiler outputs a
terraindb file that can be streamed over the web using the Cesium ion Asset Server.
A typical tiler command follows the following format:
For example, a small section of ZionNationalPark is included at
SampleData/ZionNationalPark.tiff. Tile it into a Cesium terrain database by running:
When using multiple overlapping terrain files, the files earlier in the list will be given preference.
Merging new data into an existing terrain tileset
To merge new raster data into an existing terrain tileset, just pass the existing
terraindb file as the output path:
old.terraindb already exists, then
new.tif will be tiled and layered on top of the data in
old.terraindb. This layering works the same as when tiling multiple raster files into one
terraindb, where files earlier in the input list will overwrite ones later in the list wherever they overlap. When
--void-fill is set to
Underlying, any void data in the new layer will be filled by data from the layer underneath it.
Below is a full list of command line options to configure the tiler.
||Display help message.|
||Display version number.|
||One or more terrain files to be tiled into a single layer. For overlapping terrain files, files earlier in the list are given preference. Input must be single band. Most raster formats are supported. We’re always adding support for more so don’t hesitate to reach out if you found something that’s incompatible. Required if
||A text file containing a list of one or more terrain files to be tiled into a single layer. Required if
||Path to the output
||Custom attribution string that will be stored in the final tileset.|
||Suppress output during tiling.||
||Show verbose output.||
||Specifies what the input elevation values are relative to. Set to
||Configures the default value to use when encountering void elevation values. Set to
Now that we’ve tiled our terrain, the next step is to stream it into CesiumJS. Terrain can be served with the Cesium ion Asset Server. We can then supply a URL to our terrain as shown below.
The Hosting 3D Content tutorial walks you through setting up the Cesium ion Asset Server and streaming your terrain with CesiumJS.
Third-party licenses used by the tilers can be found in