Web scene of Santa Monica trails created in Scene Viewer and displayed in a custom application
What is a web scene?A web scene is an item in a portal that contains the properties and settings for a scene. The item includes properties such as the initial map extent, basemap, data layers, and all of the styling settings. To create and save a web scene you use Scene Viewer or ArcGIS Pro. These tools allow you to interactively design and configure a scene. After creating a web scene, you can use it to display the scene in custom application. This type of application is known as a map app using web maps.
You use a web scene when you want to:
It is recommended to use the ArcGIS Maps SDKs to build map apps that use web scenes. The SDKs provide full support to access and display all of the settings stored in the web scene. This greatly reduces the amount of code required to style, display, and manage a scene in an application. Most open source libraries do not provide support for web scenes.
How to use a web sceneThe general workflow to use a web scene in a custom application is:
1. CreateTo create a new web scene, you can use Scene Viewer or ArcGIS Pro. These tools allow you to design and configure a scene interactively and then save it in a portal.
Some of the key types of configurations you can make include following:
To access Scene Viewer and ArcGIS Pro you need an ArcGIS account with the appropriate user type, role, and permissions. Learn more about creating web scenes with these tools in ArcGIS Online > Create and ArcGIS Pro > Share.
Code exampleTo create a web scene, go to Display a web scene.
2. ManageAfter configuring a web scene, you use Scene Viewer or ArcGIS Pro to save and share the web scene in a portal. To save a web scene as an item, you need to provide meta data such as the title, folder, categories, tags, and summary. When it is saved, the item is assigned a unique item ID. The final step is to set the sharing level for the web scene item. The sharing level determines which ArcGIS users and applications can access the web scene. The sharing level can be set to owner (private), group, organization, or everyone (public). To learn more about managing items and sharing levels, go to Content and data services > Manage content > Sharing.
Code exampleTo manage a web scene, go to Display a web scene.
Portal and data services guideTo learn more about how to create and manage web scenes in your portal, go to Items.
3. AccessAfter you create and save a web scene, you can access the item with a custom application built with ArcGIS Maps SDKs. To do so, you need the portal URL
and item id
for the web scene. With these, you can access the web scene's preconfigured settings and display the scene. The web scene defines the initial state of the scene when an application starts. If you need to remotely update the scene in your application, you can use Scene Viewer or ArcGIS Pro to edit and save the web scene while it is referenced. The changes will be reflected in your application the next time it is loaded.
Example code to access a web scene:
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
const webscene = new WebScene({
portalItem: {
portal: {
url: "www.arcgis.com" // Portal
},
id: "60c97b287c5c42a68a11fbbf87e07e2c" // Web scene item ID
}
});
Code example
To display a web scene, go to Display a web scene.
TopicTo learn about the JSON properties and structure of a web scene, go to the Web Scene Specification.
Security and authentication guideIf the sharing level of the web map item or any of it's layers are not set to Everyone (public), you need to use authentication to access it. To learn more about accessing secure resources in a portal, go to Types of authentication.
Code examples Display a web sceneThis example shows you how to create a web scene with Scene Viewer and display it in a custom application. The web scene is configured with the Navigation scene and is zoomed to San Francisco.
Create a web sceneNavigation (for Developers)
> Add.OpenStreetMap 3D Buildings
> Add.New York City
.443d5d8c520c416e8d6d948b55f679d6
.To access the web scene, you need to implement authentication if you set the sharing level to private, group, or organization. Learn more about the different types of authentication you can implement in Types of authentication.
When the web scene is loaded by the application, it should look the same as the web scene created with Scene Viewer.
Custom application displaying a web scene of New York.
ArcGIS Maps SDK for JavaScript ArcGIS Maps SDK for JavaScript ArcGIS Maps SDK for .NET ArcGIS Maps SDK for Kotlin ArcGIS Maps SDK for Swift ArcGIS Maps SDK for Java ArcGIS Maps SDK for Qt ArcGIS API for Python
Expand
Use dark colors for code blocks Copy1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
const webscene = new WebScene({
portalItem: {
id: "443d5d8c520c416e8d6d948b55f679d6",
},
})
Tutorial
For step-by-step instructions, go to Create a web scene, Style layers in a web scene, and Display a web scene.
Portal and data services guideTo learn more about how to create and manage web scenes in your portal, go to Items.
Display a web scene with a data layerThis example shows you how to create a web scene with Scene Viewer and display it in a custom application. The web scene is configured with a navigation basemap centered and zoomed to New York City. It also includes the Alternative fuel stations feature layer.
Create a web sceneNavigation (for Developers)
> Add.New York City
The web scene should look like Web scene (alternative fuel stations)
Manage a web scene9769ed8d91b240caa36c46ea0ddbac72
.To access the web scene, you need to implement authentication if you set the sharing level to private, group, or organization. Learn more about the different types of authentication you can implement in Types of authentication.
When the web scene is loaded by the application, it should look the same as the web scene created with Scene Viewer.
Custom application displaying the location of alternative fuel stations in New York.
ArcGIS Maps SDK for JavaScript ArcGIS Maps SDK for JavaScript ArcGIS Maps SDK for .NET ArcGIS Maps SDK for Kotlin ArcGIS Maps SDK for Swift ArcGIS Maps SDK for Java ArcGIS Maps SDK for Qt ArcGIS API for Python
Expand
Use dark colors for code blocks Copy1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
esriConfig.apiKey = "YOUR_ACCESS_TOKEN"
const webscene = new WebScene({
portalItem: {
id: "9769ed8d91b240caa36c46ea0ddbac72",
},
})
const view = new SceneView({
container: "viewDiv",
map: webscene,
})
Tutorial
For step-by-step instructions, go to Create a web scene, Style layers in a web scene, and Display a web scene.
Portal and data services guideTo learn how to host your own data in ArcGIS, go to Introduction to data services.
Tutorials Style layers in a web sceneUse Scene Viewer to style layers in a web scene.
Create and display a scene from a web scene.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4