Set up a Cesium asset

Cesium is a powerful open-source platform to create 3D geospatial applications and visualize large datasets of terrain data. In this tutorial, you will discover how to add a Cesium asset to your scene and configure its options.

This feature is currently experimental and may change in the future.

Prerequisites

Before getting started, create a free Cesium ion account. You will need:

• Your Cesium ion access token with at least the assets:read scope enabled.
• The asset ID of the dataset you want to load.

Create a Cesium ion access token.

Create a scene in 3dverse

If it's your first time using 3dverse, you will need to create a new scene in the 3dverse console before adding a Cesium asset.

1. Log in or sign up at the 3dverse Console.
2. Create a New Project.
3. In the Asset Browser, create an empty scene by hitting New / Upload then Create Scene.
4. Double-click on the newly created scene asset to open it in the 3dverse editor.

Create a new scene asset in the 3dverse console Asset Browser.

Enable the Cesium Plugin in your scene

Open the 3dverse scene you want to load your Cesium asset into from the 3dverse console.

Then in the Settings extension, locate the Plugins section under Miscellaneous. Click Add a row, then enter the following lowercase value: cesium.

Enable the Cesium plugin in the editor Scene Settings extension.

For the newly enabled Cesium plugin to be loaded, reopen your scene from the editor notification or from your project in the 3dverse console to recreate a new session with the new settings applied.

Create a Cesium Entity

1. In the Scene Graph, create a new blank entity. You may name it anything you like, such as the city or location represented by the dataset.

   

   Create a new blank entity from the Scene Graph.

2. Select the new entity, then in the Components extension, click the Add a component or attach a script text field and search for the Tags component.

   Cesium entity properties are defined directly in the

   Tags

   Entity Component

   Tags tags

   Free-form tags used to group and filter entities.

   Schema

   value

   Array[String]

   List of tags applied to this entity.

   List of tags applied to this entity.

   View in component reference

   component.

   

   Select the new entity.

   

   Add the tags component to an entity.

3. Add a new tag with the Add a row button.

   

   The tags component is empty by default.

Configure the Tags Component

Every Cesium-related entity must have its first tag begin with cesium (lowercase).

The cesium tag is used by the engine as a header tag to identify Cesium entities.

The configuration tags must be added as key-value pairs using the following format:

{key}: {value}

Example with Kobe, Japan from Google Photogrammetry Tileset:

List of Cesium tileset configuration tags

The tag keys and values are case-sensitive. Keys use camelCase.

Key	Required	Description
accessToken	Yes	Cesium ion access token.
assetId	Yes	Cesium ion asset ID (3D Tiles or Terrain).
imageryAssetId	No	Imagery asset draped over the tileset.
latitude	No	Georeference origin latitude.
longitude	No	Georeference origin longitude.
height	No	Georeference origin height.
enableCollisions	No	Use true/false to enable/disable collisions.
maxCollisionRange	No	Maximum distance (meters) from the camera within which tile collisions are enabled.

Example

Explore a 3dverse scene of Marseille, France using cesium.

https://player.demo.3dverse.com/viewer/cesium