Loading SGS Layers in Esri Clients 

Esri clients (ArcGIS Pro, ArcGIS Earth, and ArcGIS Online Scene Viewer) can load both 3D (mesh) and 2D (WMTS/WMS) layers from SkylineGlobe Server. Supported versions are: ArcGIS Pro v 2.9.0 and above, ArcGIS Earth v 1.14, and ArcGIS Online Jan 2022 update.

SGS exposes 3DML data on the server as I3S for access by Esri clients, while storing only the original format on the server.

ArcGIS clients support two methods of accessing SGS content:

§  Portal Connection (for 3DML in Pro and Earth) – Secured 3DML layers can be accessed using the SGS portal URL: https://<HostName>/<SiteName>/arcgis. After adding this URL under Manage Portals in ArcGIS Pro or ArcGIS Earth and signing in, you can browse and load secured 3DML layers without adding tokens manually.

§  Direct URL Access (for WMS, WMTS and individual 3DML) - 2D layers (WMS/WMTS) are added directly using their OGC service URLs, either by providing a specific layer URL or the base service URL from which ArcGIS lists available layers. 3DML layers can also be added individually by using their SceneServer URL including their layer ID, i.e., https://<HostName>/<SiteName>/arcgis/rest/services/[LayerID]/SceneServer When added this way, the ArcGIS client accesses the layer directly. Public layers load immediately while secured layers require appending an SGS access token to the URL.

ArcGIS Pro and ArcGIS Online require signing in to an ArcGIS Online or ArcGIS Enterprise account to use the application. This Esri login is separate from SGS authentication. Access to SGS occurs only through the SGS portal login page or by appending an SGS access token to your URL.

Loading Layers in ArcGIS Pro

ArcGIS Pro can load both 3D mesh (3DML) layers and 2D WMS/WMTS layers from SkylineGlobe Server. You can authenticate to SGS either by logging in to your SGS portal (OAuth) or using an access token.

Loading 3DML Layers

To directly load a specific 3DML layer:

1.      Click the user icon in the upper-right corner and select Sign In to sign in to ArcGIS Pro using your ArcGIS Online or ArcGIS Enterprise account.

2.      On the Map tab, from the Add Data dropdown menu, select Data from Path. The Add Data From Path dialog is displayed.

3.      Enter the following path, and click Add. Include an access token if you want to load secured layers. See the "Access Token" property in the "Managing Users" chapter for information.

To browse 3DML layers using ArcGIS portal:

1.      Click the user icon in the upper-right corner and select Sign In to sign in to ArcGIS Pro using your ArcGIS Online or ArcGIS Enterprise account.

2.      From the Login dropdown menu, select Manage Portals. The Portal Manager is displayed.

3.      Click Add Portal. The Add Portal dialog is displayed.

4.      In the URL field enter the following, and click OK: https://<HostName>/<SiteName>/arcgis
E.g., https://cloud.skylineglobe.com/demos/arcgis

5.      In the Portal Manager, right-click the SGS portal connection, and select Set as Active Portal.

6.      To access secured layers, i.e., layers whose permission level was not set to "Everyone", right-click the SGS portal connection, and select Sign in. The Skyline login is displayed. Enter your user name and password, and click Log in. See "Granting Edit or View Access" in this chapter for more information.

7.      Click the back arrow to return to the scene.

8.      In the Catalog pane, on the Portal tab, in the My Content section, all 3DML layers to which you have view access are listed. Right-click the layer you want, and select Add to Current Map.

Loading WMTS/WMS Layers

To directly load individual WMS layers:

This works only for WMS. ArcGIS Pro does not support WMTS in “Data from Path”.

1.      Click the user icon in the upper-right corner and select Sign In to sign in to ArcGIS Pro using your ArcGIS Online or ArcGIS Enterprise account.

2.      On the Map tab, from the Add Data dropdown menu, select Data from Path. The Add Data From Path dialog is displayed.

3.      Enter the following path, select Service Type – A WMS OGC Web Service, and click Add. Include an access token if you want to load secured layers. See the "Access Token" property in the "Managing Users" chapter for information.

To load raster layers using a WMTS/WMS connection:

1.      Click the user icon in the upper-right corner and select Sign In to sign in to ArcGIS Pro using your ArcGIS Online or ArcGIS Enterprise account.

2.      From the Login dropdown menu, select Manage Portals. The Portal Manager is displayed.

3.      Click Add Portal. The Add Portal dialog is displayed.

4.      In the URL field enter the following, and click OK:
https://<HostName>/<SiteName>/arcgis
E.g., https://cloud.skylineglobe.com/demos/arcgis

5.      In the Portal Manager, right-click the SGS portal connection, and select Set as Active Portal.

6.      To access secured layers, i.e., layers whose permission level was not set to "Everyone", right-click the SGS portal connection, and select Sign in. The Skyline login is displayed. Enter your user name and password, and click Log in. See "Granting Edit or View Access" in this chapter for more information.

7.      In the Catalog panel, on the Favorites tab, click Add Item > Server. Then select either New WMTS Server or New WMS Server. The WMTS/WMS Server Connection dialog is displayed.

8.      In the URL field enter the following:

§  For WMTS: https://<HostName>/<SiteName>/arcgis/rest/services/MapServer/WMTS
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/MapServer/WMTS

§  For WMS: https://<HostName>/<SiteName>/arcgis/rest/services/wmsserver
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/wmsserver

9.      Click OK.

10.   In the Catalog panel, on the Favorites tab, expand the SkylineGlobe Server WMS/WMTS node.

11.   Right click the required layer, and select Add to Current Map. All layers to which you have view access are listed.

Loading Layers in ArcGIS Earth

ArcGIS Earth can load both 3D mesh (3DML) layers and 2D WMS/WMTS layers from SkylineGlobe Server. You can authenticate to SGS either by logging in to your SGS portal (OAuth) or using an access token.

Loading 3DML Layers

To directly load a specific 3DML layer:

1.      On the top toolbar, click Add Data .

2.      In the dialog that opens, click the Add from Path tab.

3.      In the Type field, select ArcGIS Server Web Service and then in the Path field enter the following. Include an access token if you want to load secured layers. See the "Access Token" property in the "Managing Users" chapter for information.

4.      Click OK.

 

To browse 3DML layers using an SGS portal:

1.      From the Login dropdown menu, select Manage Portals. The Portal Manager is displayed.

2.      Click Add Portal. The Add Portal dialog is displayed.

3.      In the URL field enter the following, and click OK:
https://<HostName>/<SiteName>/arcgis
E.g., https://cloud.skylineglobe.com/demos/arcgis

4.      Right-click the SGS portal connection, and select Sign in. Enter your user name and password, and click Log in, or selectGuest Mode to log in as a guest. Guest users can only access publicly shared layers, i.e., layers whose permission level was set to "Everyone". See "Granting Edit or View Access" in this chapter for more information.

5.      In the Portal Manager, right-click the SGS connection, and select Set as Active Portal, and then close the dialog.

6.      On the top toolbar, click Add Data .

7.      In the dialog that opens, click the Portal tab, and then select the layer you want. All layers to which you have view access are listed. SSee "Granting Edit or View Access" in this chapter for more information on granting access to layers from other sites.

8.      Click Add .

Loading WMTS/WMS Layers

To directly load a specific WMTS/WMS layers:

1.      On the top toolbar, click Add Data .

2.      In the dialog that opens, click the Add from Path tab.

3.      In the Type field, select OGC WMTS/OGC WMS and then in the Path field enter the following. Include an access token if you want to load secured layers. See the "Access Token" property in the "Managing Users" chapter for information.

a.      For WMTS
https://<HostName>/<SiteName>/[token]/arcgis/rest/services/[LayerID]/MapServer/WMTS
E.g., https://cloud.skylineglobe.com/demos/ac47c01a9b174273adfa18a0abdc308f/arcgis/rest/services/625696/MapServer/WMTS

b.      For WMS
https://<HostName>/<SiteName>/[token]/arcgis/rest/services/[LayerID]/wmsserver
E.g., https://cloud.skylineglobe.com/demos/ac47c01a9b174273adfa18a0abdc308f/arcgis/rest/services/625696/wmsserver

4.      In the Layers section, select the required layers, and click OK.

 

To load layers by adding a WMTS/WMS connection:

1.      From the Login dropdown menu, select Manage Portals. The Portal Manager is displayed.

2.      Click Add Portal. The Add Portal dialog is displayed.

3.      In the URL field enter the following, and click OK: https://<HostName>/<SiteName>/arcgis
E.g., https://cloud.skylineglobe.com/demos/arcgis

4.      To access secured layers, i.e., layers whose permission level was not set to "Everyone", do the following:

a.      Select Sign in using browser.

b.      Right-click the SGS portal connection, and select Sign in. The Skyline login is displayed in your browser.

c.      Enter your user name and password, and click Log in. See "Granting Edit or View Access" in this chapter for more information.

5.      On the top toolbar, click Add Data .

6.      In the dialog that opens, click the Add from Path tab.

7.      In the Type field, select OGC WMTS/OGC WMS and then in the Path field enter the following:

§  For WMTS: https://<HostName>/<SiteName>/arcgis/rest/services/MapServer/WMTS
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/MapServer/WMTS

§  For WMS: https://<HostName>/<SiteName>/arcgis/rest/services/wmsserver
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/wmsserver

8.      In the Layers section, select the required layers, and click OK.

 

Loading Layers in ArcGIS Online Scene Viewer

ArcGIS Online Scene Viewer supports loading layers from SkylineGlobe Server in the following ways:

§  3DML (I3S) layers can be loaded by appending an SGS access token to your SceneServer URL. Sign in to SGS from ArcGIS Online is not supported. See the "Access Token" property in the "Managing Users" chapter for information.

§  WMS and WMTS layers can be loaded only if they are public. ArcGIS Online does not support passing SGS access tokens for OGC services.

All SGS layers must be on public HTTPS servers.

Loading 3DML Layers

To load a layer from SGS in ArcGIS Online Scene Viewer:

1.      Connect to https://www.arcgis.com/home/webscene/viewer.html

2.      Click the user icon in the upper-right corner and select Sign In to sign in with your ArcGIS Online account.

3.      On the left toolbar, click Add  and then select Add layer from URL. The Enter Layer URLpanel is displayed.

4.      Enter the Layer URL:  
https://<HostName>/<SiteName>/[token]/arcgis/rest/services/[LayerID]/SceneServer
E.g., https://cloud.skylineglobe.com/demos/ac47c67a9h174273adfa18a0abdc308f/arcgis/rest/services/729228/SceneServer

5.      Click Add.

Loading WMTS/WMS Layers

To load a layer from SGS in ArcGIS Map Viewer:

1.      Connect to https://www.arcgis.com/apps/mapviewer/

2.      Click the user icon in the upper-right corner and select Sign In to sign in with your ArcGIS Online account.

3.      On the left toolbar, click Add  and then select Add layer from URL. The Add Layer panel is displayed.

4.      Enter the Layer URL. Only public WMS/WMTS layers are supported because ArcGIS Online cannot send SGS access tokens to OGC services.

§  WMTS (public only): https://<HostName>/<SiteName>/arcgis/rest/services/[LayerID]/MapServer/WMTS
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/625696/MapServer/WMTS

§  WMS (public only):
https://<HostName>/<SiteName>/arcgis/rest/services/[LayerID]/wmsserver
E.g., https://cloud.skylineglobe.com/demos/arcgis/rest/services/625696/wmsserver

5.      If your layer's coordinate system does not match the base project's, switch on Use as basemap. If they match, leave it switched off.

6.      Click Add.

7.      Select all the layers you want to add and click Add to map.