The Cyclomedia ArcGIS Web Service 3DNL, built on Esri's SLPK (Scene Layer Package) and I3S (Indexed 3D Scene Layer) standards, provides a high-fidelity, large-scale 3D representation of urban environments. Seamlessly integrated into the Esri ArcGIS Pro and ArcGIS Online ecosystems, this service allows users to visualize, analyze, and interact with accurate 3D models of cities, infrastructure, and landscapes.
Before you can start using the 3DNL ArcGIS Web Service, you need to have credentials. If you do not have them yet, please use this form to request access.
Everything you need to know about the use of our 3DNL ArcGIS Web Service can be found below in the Service Documentation.
To help you getting started, we have created a set of code examples for you. You can use them as a basis for your own service requests.
The 3D mesh is created from Cyclomedia's extensive aerial imagery and LiDAR data, delivering rich, photorealistic visualizations that support various GIS processes such as urban planning, asset management, and spatial analysis. The use of the SLPK and I3S formats ensures optimized streaming and efficient rendering of large datasets, even when handling complex cityscapes.
The ArcGIS Web Service 3DNL I3S service is an ArcGIS service which can be accessed through this URL: https://atlasapi.cyclomedia.com/i3s/arcgis/rest/services/3dnl/SceneServer
This service an be used in ArcGIS Pro, ArcGIS Online and integrated with the ArcGIS JavaScript API
1. Open a new project in ArcGIS Pro.
2. Create a local Scene.
3. Go to Map navigation bar and choose ‘Add Data’ > ‘From Path’ or directly choose ‘Add Data From Path’.
4. Add the 3DNL layer (https://atlasapi.cyclomedia.com/i3s/arcgis/rest/services/3dnl/SceneServer) to the Path input field.
5. Choose ‘Add’.
6. There will be a prompt to login. Add your Cyclomedia username and password.
7. Complete steps.
1. Open ArcGIS Online
2. Check with your organization admin if the Cyclomedia 3DNL ArcGIS Web Service URL is added as a trusted server. For more information, refer to Configure security settings—ArcGIS Online Help | Documentation
3. Create a WebScene.
4. Use the '+' icon to create a Local Scene.
5. Add a new layer and choose for ArcGIS web service.
6. Fill the 3DNL Layer URL (https://atlasapi.cyclomedia.com/i3s/arcgis/rest/services/3dnl/SceneServer) in the Layer URL box.
7. Fill the prompt for adding username and password.
8. 3DNL is now successfully added to your Scene.
This article describes how API Keys can be used to authorize 3DNL in ArcGIS. The first way is to authorize 3DNL as a layer in the Scene Viewer, the second way is to save a Scene Layer as an item.
1) Authorize 3DNL as a layer in an ArcGIS web scene with API Key.
In a local scene it is possible to add the 3DNL ArcGIS web service. This can be done with the following easy steps.
1. Open the Layer manager and click on ArcGIS web service
2. Fill in the Layer URL
https://atlasapi.cyclomedia.com/i3s/arcgis/rest/services/3dnl/SceneServer
3. Configure custom parameters
Parameter: apikey
Value: fill your api key here
4. 3DNL will now be available within the Scene Viewer. The layer with the API Key will be saved within the Scene and the Scene can be shared.
2) Authorize 3DNL as an item in ArcGIS with API Key.
At this moment custom parameters can not be saved in Scene layers and the API Keys can not be used to authorize 3DNL as an item in your ArcGIS Online or ArcGIS Enterprise environment.
1. Add local elevation layer
With the Living Atlas, an elevation layer can be added in the RD New coordinate system. It can be found in the Living Atlas under the name "Elevation 3D (RD)". This layer is based on AHN3 and AHN4 and corresponds to the coordinate system of 3DNL. Height layers can be used as a surface that provides base heights for other layers in scenes.
When adding, the pop-up 'Data mismatch will appear, click on ‘Drop’ so that the projection of the scene is switched to RD New.
To learn more about Applying Elevation in a 3D Scene, read Esri's Storymap (in Dutch).
2. Set the visibility range
In the layer properties, which can be found for every layer in the Layer Manager, it is possible to set the visibility range of the 3DNL layer.
It is advised to set a minimum Visibility range, for example of 1:15,000 – max. This makes sure that 3DNL is only loaded when the scene is sufficiently zoomed in.
3. Make use of a base layer
By adding a base layer the user has the possibility to go to the correct location in the scene. A suggestion to use as a base layer is the ‘Topo RD voor 3D’ which can be found in the Living Atlas.
The visibility range of both layers can also be combined, when 3DNL is visible starting at 1:15,000, the Topo layer can be visible up to 1:15,000. For this the Visibility range has to be set ‘min – 1:15,000’.
4. Mesh modification
Mesh modifications can be used to clip, mask or replace the 3DNL mesh. The modifications can be found in the layer properties in the Layer Manager.
The Mask modification can be used to show a certain part of the 3DNL mesh. The areas outside of the area will not be shown, which improves the performance of the 3DNL layer.
The Clip modification gives the possibility to exclude a certain part of the mesh. This can be used to make other layers visible which would otherwise overlap the 3DNL mesh.
Lastly the Replace modification can be used to adjust the height of the mesh inside the polygon. This can for example be used to flatten the mesh to ground level.
More information about mesh modifications can be found here.
See below code examples to start using the service with ArcGIS JavaScript API
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no" />
<title>Cyclomedia ArcGIS JavaScript API Example</title>
<link rel="stylesheet" href="https://js.arcgis.com/4.29/esri/themes/light/main.css" />
<script src="https://js.arcgis.com/4.29/"></script>
<style>
html, body, #viewDiv { padding: 0; margin: 0; height: 100%; width: 100%; }
#menu { padding: 1em; }
</style>
<script>
require([
"esri/WebScene",
"esri/views/SceneView",
"esri/layers/IntegratedMeshLayer",
"esri/config",
"esri/request" ],
(WebScene, SceneView, IntegratedMeshLayer, esriConfig, esriRequest) => {
const webscene = new WebScene();
const params = new URLSearchParams(window.location.search);
var t = params.get("t")
const baseUrl = 'https://atlasapi.cyclomedia.com/i3s/arcgis/rest/services/3dnl/SceneServer';
esriConfig.request.interceptors.push({
urls: new RegExp(baseUrl, "i"), // Match your server URL
before: function(params) {
// Add authorization header
params.requestOptions.headers = params.requestOptions.headers || {};
// Basic auth
params.requestOptions.headers.Authorization = 'Basic <Base64-encoded Cyclomedia's username and password, separated by a colon>';
// In case of API Key authorization, add header like below
params.requestOptions.headers.Authorization = 'APIKey <Your API Key>';
}
});
fetch(baseUrl, {
method: 'GET',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Basic ' //or 'APIKey' when using API Key authorization
}
}
) .then((response) => { return response.json(); })
.then((json) => {
var count = 0;
json.layers.forEach((layer) => {
const l = new IntegratedMeshLayer({
url: '${baseUrl}/layers/${count++}',
copyright: "Cyclomedia",
title: layer.name
});
webscene.add(l);
});
});
const view = new SceneView({
container: "viewDiv",
map: webscene,
qualityProfile: "high",
zoom: 1
});
});
</script>
</head>
<body> <div id="viewDiv"> </div>
</body>
</html>
ArcGIS Pro version support
Version 3.3 and above
I have added the I3S service to ArcGIS Online, but run into trouble.
Check with your organization admin to add the Cyclomedia 3DNL ArcGIS Web Service URL as a trusted server. For more information, refer to Configure security settings—ArcGIS Online Help | Documentation
ArcGIS JavaScript API support
Version 4.29 and above
Start developing your own integration? Join our developer community today.
Van Voordenpark 1b
5301 KP Zaltbommel (NL)
T +31 (0) 418 - 55 61 00
E info@cyclomedia.nl
Go to cyclomedia.com