Whether you have imagery, terrain, 3D buildings, point clouds, BIM/CAD, or photogrammetry, this guide provides an overview of uploading data to the ion tiling pipeline.
Cesium ion accepts a variety data formats and tiles them into one of three types of assets:
The following table lists accepted data formats and their corresponding asset types:
| Format | 3D Tiles | Terrain | Imagery |
|---|---|---|---|
| Zip Archive (.zip) | |||
| glTF (.gltf, .glb) | |||
| CityGML (.citygml, .xml, .gml) | |||
| KML/COLLADA (.kml, .kmz) | |||
| LASer (.las, .laz) | |||
| COLLADA (.dae) | |||
| Wavefront OBJ (.obj) | |||
| Floating Point Raster (.flt) | |||
| Arc/Info ASCII Grid (.asc) | |||
| Source Map (.src) | |||
| GeoTIFF (.tiff, .tif) | |||
| Erdas Imagine (.img) | |||
| USGS ASCII DEM and CDED (.dem) | |||
| JPEG (.jpg, .jpeg) | |||
| PNG (.png) | |||
| Cesium Terrain Database (.terraindb) |
While not listed in the above table, sidecar files such as .aux.xml, .tab, .tfw, .wld, .prj, .ovr, .rrd, etc. are also supported for raster source files. When in doubt, upload any additional files that came with your data.
If you have data in a format not listed here and would like to see ion support it, please let us know.
The maximum combined size of source data that you can upload for a single asset is 20GB.
glTF, COLLADA, and OBJ files must be in local coordinates. Geographic (lat/long) or global cartesian coordinates are not supported.
CityGML, raster imagery, and raster terrain must include a coordinate reference system.
Raster terrain must be a single band of floating point or integer elevations.
When terrain clamping is enabled, CityGML will adjust the height of the following object types:
If an error is encountered during the tiling process, we try our best to detect exactly what went wrong and report the error to you. If you encounter any of the above limitations in your data, please let us know.
If you need help, want to report an issue, or just want to say hi, you can open an issue on the ion community github repository or feel free send an email.