Skip to main content

Load SGS Data in External Clients

Yaniv Dayan
  • Updated

In this article:

Note:  In your Getting Started email, you received a personal "Customer Key", "Access Token", and "Password". This information and your "User Name" (i.e., your email address) will be used for loading data in clients. Enter this information wherever required in the steps below.

Loading SGS data in a Cesium viewer

You can access SGS 3D mesh layers in OGC 3D Tiles format in your Cesium viewer using Skyline's SGSProvider:

  • 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.

To load SGS data layers in your Cesium viewer:

Note:   SGSProvider is supported in Cesium 1.62 and above.

  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.
    Note:       After the initial connection to SGS, there is no need to reconnect before loading additional layers. 
    SGSProvider.connect (URL, username, password)
    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]”); More about: Access tokens (set in User Properties in SGS) >
    • Connect with a user and password, e.g.,
      SGSProvider.connect("https://www.skylineglobe.com/sg”, “Username", "Password");
  4. Load layers in either of the following ways:
    • Load all Layers in a 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 - Load individual layers by ID, alias, or tag. Tags are key words or terms associated with the layer set in the layer's properties. 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 LayerTypethat 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 layers in Cesium clients >

 

Loading SGS 3D data in an Esri viewer

You can access SkylineCloud 3DML layers exposed as i3S in your Esri viewer in ArcGIS Earth, ArcGIS Pro and ArcGIS Online. The following Esri versions are supported: ArcGIS Pro v 2.3.0 and above, ArcGIS Earth v 1.9, and ArcGIS Online June 2019 update.

In ArcGIS Earth:

  1. Connect to SkylineGlobe Server.
  2. Open the Portal Manager, and click Add Portal. The Add Portal dialog box is displayed.
    download.png
  3. In the URL field, enter the following URL, and click OK: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis
  4. In the Portal Manager, right-click the SkylineCloud connection, and select Set as Active Portal.
  5. Click Add Data .
  6. Do either of the following:
    • In the Add Data dialog box, click Portal, and then in the My Content list, select the layer you want.
    • In the Add Data dialog box, click Enter a URL, and then in the URL field, enter the following URL, and click OK: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/[LayerName].[LayerID]/SceneServer
  7. Click Add.

In ArcGIS Pro:

  1. Create a project: Create a new project using a Blank template.
  2. On the Blank Templates, from the New tab, select Global Scene.
  3. Enter a Project name and the project location and click OK.
  4. Connect to SkylineGlobe Server: Click the Project tab.
  5. In the Portals page, click Add Portal.
  6. In the URL field enter the following, and click OK: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis
  7. In the Portal Manager, right-click the SkylineCloud connection, and select Set as Active Portal.
  8. Click the back arrow to return to the scene
  9. Load a layer: Do either of the following to load the premium data:
  10. In the Catalog pane, on the Portal tab, in the My Content section, right-click the layer you want, and select Add to Current Map.
  11. On the Map tab, from the Add Data drop-down menu, select Data from Path. Then in the Add Data From Path dialog that opens, enter the following URL, and click Add: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/[LayerName].[LayerID]/SceneServer

In ArcGIS Online:

  1. Open https://www.arcgis.com/home/webscene/viewer.html
  2. Sign in with an ArcGIS account.
  3. Open the Designer by clicking on Modify scene. Then, click Add Layers, and then click Enter layer URL.
  4. In the URL field, enter the URL below, and click OK: https://cloud.skylineglobe.com/sg/Default/[TOKEN]/arcgis/rest/services/[LayerName]/[LayerID]/SceneServer
    Note: All SGS layers must be on public HTTPS servers.
  5. Click Add.

More about: Loading 3D layers in Esri clients >

 

Loading SGS 3D data in QGIS Desktop

You can connect to SGS in QGIS Desktop version 3.36.0 and above to load 3DML layers exposed as 3D Tiles. 

To load SGS 3DML layers in your QGIS:

  1. Open QGIS Desktop
  2. Create a new Scene connection: From the Layer menu, select Data Source Manager.
  3. In the Navigation pane, select Scene.
  4. Select Source Type = Services and click on New, and select New Cesium 3D Tiles Connection.
  5. In the Tiles Scene Connection dialog box, enter the following:
  6. Click OK.
  7. Load a layer: In the Data Source Manager, click the Scene tab, select the new connection, and click Add.
  8. Open a 3D Window: From the View menu, select 3D Map Views, and then New 3D Map View.

 

Loading SGS 2D data in an Esri viewer

You can access premium 2D raster layers in your Esri viewer in ArcGIS Earth, ArcGIS Pro and ArcGIS Online.
Note: The following Esri versions are supported: ArcGIS Pro v 2.3.0 and above, ArcGIS Earth v 1.9, and ArcGIS Online June 2019 update.

In ArcGIS Earth:

  1. Open the Settings dialog, and under the General tab, set the Spatial Reference to WGS 84.
  2. Click Add Data .
  3. In the Add Data dialog box, click Enter a URL, and then in the Type field, select OGC WMS or OGC WMTS.
  4. In the URL field, copy-paste the following URL, select the required layers, and click OK: https://[ServerName]/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/wmsserver
  5. Click Add.

In ArcGIS Pro:

  1. Create a project: On the Blank Templates , from the New tab, select Global Scene.
  2. Enter a Project name and the project location and click OK.
  3. On the Insert tab, click Add Item, and select either New WMS Server or New WMTS Server.
  4. In the URL field enter the following, and click OK:
    • For WMS: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/wmsserver
    • For WMTS: https://cloud.skylineglobe.com/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/mapserver
  5. Click OK.
  6. In the Catalog pane, on the Favorites tab, open the connection that recently added, right-click the layer you want, and select Add to Current Map.

In ArcGIS Online:

  1. Connect to SkylineGlobe Server: Connect to a base map of spatial reference WGS 84 https://www.arcgis.com/home/group.html?id=4c790318395940c18a16e8acd721de25#overview
  2. Hover over the thumbnail of the layer you want to add, and click Open in Map Viewer.
  3. Log in with an ArcGIS account.
  4. Load a layer: Click Add, and select Add Layer from Web. The Add Layer from Web dialog box is displayed.
  5. Select either A WMS OGC Web Service or A WMTS OGC Web Service.
  6. Enter the following URL: https://[ServerName]/sg/[CUSTOMER_KEY]/[TOKEN]/arcgis/rest/services/wmsserver
    Note: All SGS layers must be on public HTTPS servers.
  7. Click Get Layers.
  8. Check all the layers you want to add and click Add Layer.

More about: Loading 2D layers in Esri clients >

Loading SGS 2D data in QGIS

You can access premium WMS/WMTS and WFS layers in your QGIS viewer.

  1. Create a new WMS/WMTS or WFS connection: From the Layer menu, select Data Source Manager.
  2. In the Navigation pane, select WMS/WMTS or WFS.
  3. In the Layers tab, click New.
  4. In the Create a New WMS/WMTS Connection or Create a new WFS Connection dialog box, enter the following:
    • Name - Enter a name for the connection.
    • WMS URL - https://[ServerName]/sg/[CUSTOMER_KEY]/streamer.ashx?token=[Access_Token]
    • WMTS URL - https://[ServerName]/sg/[CUSTOMER_KEY]/streamer.ashx?token=[Access_Token]&request=GetCapabilities&Version=1.0.0&Service=WMTS
    • WFS URL - https://[ServerName]/sg/[CUSTOMER_KEY]/streamer.ashx?token=[Access_Token]
  5. Click OK.
  6. Load a layer: In the Data Source Manager, click the Layers tab, and select the new connection’s name.
    QGIS_Add_Layer.ae38d570.png
  7. Click Connect .
  8. Select the layer to access.
  9. Click Add and Close.

More about: Loading 2D layers in QGIS clients >

 

 

 

Related articles