Skip to main content

Load 2D and 3D Layers in Cesium Clients

Yaniv Navon
  • Updated

Cesium clients can load mesh, point cloud, and imagery layers from SkylineGlobe Server using either Skyline's SGSProvider or Cesium API. Elevation layers can only be loaded via Skyline's SGSProvider.

In this article:

Loading Layers in Cesium Clients Using Skyline's SGSProvider

Cesium clients can load mesh, point cloud, imagery, and elevation layers from SkylineGlobe Server using Skyline's SGSProvider. SGSProvider is supported in Cesium 1.62 and above.

  • Mesh and point cloud layers – Exposed as 3D Tiles. Only the original data format is stored on the server.
  • Imagery layers – Served as WMS.
  • Elevation layers – Served via SGSTerrainProvider, SkylineGlobe Server's custom Cesium terrain provider.

Note: When a project is loaded, SkylineGlobe Server's custom terrain provider, “SGSTerrainProvider", overrides the Cesium terrainProvider set in the Cesium client project, and its MPT or TBP is set as the base terrain. If the loaded project also contains elevation layers or other elevation layers from a different project are loaded, the last elevation layer loaded is set as the base terrain. If you do not want a project's elevation layers to replace your base terrain, set the layerType only to layer types other than elevation, i.e., _LayerType.MESH, _LayerType.IMAGERY, or _LayerType.POINT_CLOUD or any combination of these. See below for more information.

 

To load your layers in a Cesium client using Skyline's SGSProvider:

  1. Open .\TerraExplorerWeb\js, and copy the SGSProvider folder to your .\Cesium\Apps folder.
  2. Add the SGSProvider.v2.js in your main HTML to start using the SGSProvider library.
    <script src="SGSProvider/SGSProvider.v2.js" type="text/javascript"></script>
  3. Connect to SGS using the SGSProvider.connect method. After the initial connection to SGS, there is no need to reconnect before loading additional layers. 
    SGSProvider.connect(URL, username, password)
  4. The following connection options are available:
    • Connect as a guest user only to public layers, e.g., 
      SGSProvider.connect("https://www.skylineglobe.com/sg"); 
    • Connect with a token, e.g., 
      SGSProvider.connect("https://www.skylineglobe.com/sg/[TOKEN]”);
    • Connect with a user and password, e.g., 
      SGSProvider.connect("https://www.skylineglobe.com/sg”, “Username", "Password");
  5. Load layers in either of the following ways:
    • Load all layers in a specific TE4W project - Load all layers in a specific TE4W project. The layerType parameter can be left empty to load all supported layer types in the project, or a specific layer type can be passed to load only layers of that type. More than one layer type can be passed in a single call. The supported layer types are: _LayerType.MESH, _LayerType.POINT_CLOUD, _LayerType.IMAGERY, and _LayerType.ELEVATION.
      SGSProvider.loadLayersFromProject(project, layerType)

      The following example loads all mesh and imagery layers in the SampleProject project:

      SGSProvider.loadLayersFromProject("SampleProject", [_LayerType.MESH, _LayerType.IMAGERY]);

    • Load individual layers by ID, alias, or tag - Load individual layers by ID, alias, or tag. For loading by tag, set the resourceType to _ResourceType.TAG. 
      SGSProvider.loadLayers(resourceID, resourceType, layerType)
        • This example loads a single layer by ID:
          SGSProvider.loadLayers(“123456”);
        • This example loads a single layer by alias: 
          SGSProvider.loadLayers(“SomeAlias);
        • This example loads all layers of a specified LayerType that share a common tag. The supported layer types are: MESH, POINT_CLOUD, IMAGERY, and ELEVATION. For loading by tag, set the resourceType to _ResourceType.TAG: 
          SGSProvider.loadLayers(“TagName”, _ResourceType.TAG, [_LayerType.POINT_CLOUD]);

More about: Loading your layers in a Cesium client using Skyline's SGSProvider >

 

Loading Layers in Cesium Clients Using Cesium API

Cesium clients can load mesh, point cloud, and imagery layers from SkylineGlobe Server using Cesium API. SGS exposes 3DML mesh and point cloud data as 3D Tiles for access by Cesium clients, while storing only the original data format on the server. Imagery layers are served as WMS.

Loading 3DML Exposed as 3D Tiles in Cesium Clients

3D Tiles can be requested in different elevation reprojection methods and different formats.

  1. Add a Cesium3DTileSet element: 
    var tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
    url : "https://cloud.skylineglobe.com/sg/demos/b3dm/623979/tileset.json"
    }));
  2. Use the following path format:  
    http://[ServerName]/sg/b3dm/[SGSID]/tileset.json
    E.g. https://cloud.skylineglobe.com/sg/demos/b3dm/623979/tileset.json
    Example: 
    var viewer = new Cesium.Viewer("cesiumContainer");
    var tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
    url : "https://cloud.skylineglobe.com/sg/demos/b3dm/623979/tileset.json"
    }));
    tileset.readyPromise.then(function(tileset) {
    viewer.camera.flyToBoundingSphere( tileset.boundingSphere);
    });
    Note: You can also interactively browse, edit and run this code example in Cesium Sandcastle.
  3. You can set the OGC 3D Tiles version to serve to all Cesium clients (including TE4W) requesting 3D mesh layers exposed as 3D Tiles, by appending the 3D Tiles version (b3dmversion) query parameter to the end of your 3D Tile URL. Leave the parameter value empty to use the latest version. Use the following format:  
    b3dmversion=[version #] 
    E.g. https://cloud.skylineglobe.com/sg/demos/b3dm/623979/tileset.json?b3dmversion=V0.2
    Note: If a b3dmversion query parameter is not appended to the URL, the 3D Tiles version is determined by the Default 3D Tiles Version setting on the Settings page. More about: SkylineGlobe Server settings >
  4. If you want to define how to handle the 3DML’s elevation values, append the vertical datum (vdatum) parameter to the end of your 3D Tile URL. The vdatum parameter can have either of the following values: 
    • convert_z: Reproject to ellipsoid (as required by the OGC 3D Tiles standard) for compatibility with terrain that uses true ellipsoid elevation.
    • copy_z: Maintain elevation values as geoid, while declaring them as ellipsoid.
      Note: Most input coordinate systems and terrain data, including MPT, use geoid elevation values even though they are declared as ellipsoid when delivered to TE4W/Cesium, and thus they are actually compatible without reprojection.

Use the following format: ?vdatum=[reprojection value: either copy_z. OR convert_z]
E.g. https://cloud.skylineglobe.com/sg/demos/b3dm/623979/tileset.json?b3dmversion=V0.2&vdatum=convert_z  
OR https://cloud.skylineglobe.com/sg/demos/b3dm/Frederick/tileset.json?b3dmversion=V0.2&vdatum=convert_z 
Note: You can also define the handling of 3DML's elevation values in SkylineGlobe Server Manager> Layer Properties > Description field by defining the vDatum value per layer, [vdatum=copy_z] or [vdatum=convert_z]. More about: Setting SkylineGlobe Server settings >

vdatum.png

Loading Point Cloud Layers in Cesium Clients

To load your point cloud layer in a Cesium client using Cesium API:

  1. Add a Cesium3DTileset element: 
    var tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({url: "https://www.skylineglobe.com/SG/pnts/1725996/tileset.json"}));
  2. Use the following path format for the layer to load:
    https://[ServerName]/sg/pnts/[LayerID]/tileset.json
    E.g., https://www.skylineglobe.com/SG/pnts/1725996/tileset.json
    Example:
    var viewer = new Cesium.Viewer("cesiumContainer");
    var tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
    url: "https://www.skylineglobe.com/SG/pnts/1725996/tileset.json"
    }));
    tileset.readyPromise.then(function(tileset) {
    viewer.camera.flyToBoundingSphere(tileset.boundingSphere);
    });
    Note:    You can also interactively browse, edit and run this code example in Cesium Sandcastle.
  3. If you want to define how to handle the point cloud's elevation values, append the vertical datum (vdatum) parameter to the end of your 3D Tile URL. The vdatum parameter can have either of the following values:
      • convert_z: Reproject to ellipsoid (as required by the OGC 3D Tiles standard) for compatibility with terrain that uses true ellipsoid elevation.
      • copy_z: Maintain elevation values as geoid, while declaring them as ellipsoid.
        Note:        Most input coordinate systems and terrain data, including MPT, use geoid elevation values even though they are declared as ellipsoid when delivered to TE4W/Cesium, and thus they are actually compatible without reprojection.
        Use the following format:
        ?vdatum=[reprojection value: either copy_z. OR convert_z]
        E.g., https://www.skylineglobe.com/SG/pnts/2925566/tileset.json?vdatum=copy_z

Loading Imagery Layers in Cesium Clients

SGS serves imagery layers to Cesium viewers.

To load imagery data in a Cesium client using Cesium API:

  1. Add a Cesium ImageryProvider 
    var imageryLayers = viewer.imageryLayers;
    imageryLayers.addImageryProvider();
  2. Create a new Cesium WebMapServiceImageryProvider
    new Cesium.WebMapServiceImageryProvider({});
    Example: 
    var viewer = new Cesium.Viewer("cesiumContainer");
    var imageryLayers = viewer.imageryLayers;
    Cesium.when(imageryLayers.addImageryProvider(
      new Cesium.WebMapServiceImageryProvider({
        url: "https://www.skylineglobe.com/sg/default/streamer.ashx",
        layers: "landsat_oahu.ii.2927284",
    rectangle:Cesium.Rectangle.fromDegrees(-158.38508605957,21.2051582336426,-157.554759979248,21.8001365661621),
        parameters: {
          transparent: true,
          format: "image/png",    
          },
      })),function(a){viewer.camera.flyTo({destination: new Cesium.Rectangle.fromDegrees(-158.38523979, 21.8002224, -157.55467415, 21.2050724)});});

Notes:

More about: Loading layers in Cesium clients using Cesium API >

 

 

 

 

Related articles