cesiumjs-3d-tiles

CesiumJS 3D Tiles

Version baseline: CesiumJS v1.144 (ES module imports, async factory methods).

Loading a Tileset

Always use async factory methods -- never call the constructor directly. For public/no-token examples, prefer URL-backed tilesets such as CesiumGS sample tilesets. fromIonAssetId, createOsmBuildingsAsync, and Google Photorealistic 3D Tiles require external entitlements; use them only when the caller explicitly asks for those services and the runtime is configured for them.

import { Cesium3DTileset, HeadingPitchRange, Math as CesiumMath } from "cesium";

// From a URL
const tileset = await Cesium3DTileset.fromUrl(
  "https://example.com/tileset.json",
  { maximumScreenSpaceError: 16 }, // lower = higher quality
);
viewer.scene.primitives.add(tileset);
await viewer.zoomTo(tileset, new HeadingPitchRange(
  0.0, CesiumMath.toRadians(-25.0), tileset.boundingSphere.radius * 2.0,
));

CesiumJS 1.143 applies standalone model loading to glTF embedded in tilesets. Read the glTF compatibility matrix for automatic KHR_meshopt_compression, CAD extension behavior, and the unsupported planar-fill boundary.

// From Cesium ion
const tileset = await Cesium3DTileset.fromIonAssetId(75343);
viewer.scene.primitives.add(tileset);

// Google Photorealistic 3D Tiles
import { createGooglePhotorealistic3DTileset } from "cesium";
const google3D = await createGooglePhotorealistic3DTileset({
  onlyUsingWithGoogleGeocoder: true,
});
viewer.scene.primitives.add(google3D);

// OSM Buildings
import { createOsmBuildingsAsync } from "cesium";
const osmBuildings = await createOsmBuildingsAsync();
viewer.scene.primitives.add(osmBuildings);

Key Constructor Options

Option	Default	Purpose
maximumScreenSpaceError	16	LOD quality threshold (pixels)
cacheBytes	536870912	Tile cache trim target (bytes)
maximumCacheOverflowBytes	536870912	Extra cache headroom
shadows	ShadowMode.ENABLED	Shadow casting/receiving
modelMatrix	Matrix4.IDENTITY	Root transform
clippingPlanes	undefined	ClippingPlaneCollection
clippingPolygons	undefined	ClippingPolygonCollection (WebGL 2)
enableCollision	false	Camera collision with tileset surface
pointCloudShading	undefined	Point attenuation options object
classificationType	undefined	TERRAIN, CESIUM_3D_TILE, or BOTH
dynamicScreenSpaceError	true	Horizon LOD optimization
foveatedScreenSpaceError	true	Center-screen tile priority
preloadFlightDestinations	true	Prefetch tiles at flight target
featureIdLabel	"featureId_0"	EXT_mesh_features ID set label
backFaceCulling	true	Cull back faces per glTF material
edgeDisplayMode	EdgeDisplayMode.SURFACES_ONLY	Render glTF edge-visibility data when present