Use the Details Panel UI

Learn how to use ArcGIS data and other geospatial content within a scene.

Start Unreal Engine and you should see an ArcGIS Maps button in the Unreal UI toolbar. The Toolbar is displayed at the top-left of the Blueprint Editor by default.

ArcGIS Maps SDK for Unreal Engine

To initialize the , click the ArcGIS Maps button, it will generates a Map Controller Actor. You can find it in the WorldOutliner.

By selecting the Map Controller Actor in the details panel, you can choose between a global or a local scene, set the initial position of the camera, change the basemap, add data, and organize the content

Prerequisites

Review the first three steps from the Get started page to ensure your development environment is set up correctly.

Select global or local

When working with 3D content, you can choose to display your data within one of two different scene environments: global or local. The best environment for a global or local scene depends on the spatial reference of your data, the layer types, and what you are trying to achieve in your scene.

Global scene

A global scene is a view mode where you can display your 2D and 3D content on a sphere based on either the WGS84 or Web Mercator (Auxiliary Sphere) coordinate systems. A global scene is good for when you want to understand or provide context for phenomena that wraps around the spherical surface of the earth, such as global weather measurements, airline traffic paths, or shipping lanes.

To set up a global scene:

  1. Click Global scene.

    Global scene

  2. Setup initial camera position.

    • Latitude: Specifies the north–south position of a point on the Earth's surface.
    • Longitude: Specifies the east–west position of a point on the Earth's surface.
    • Altitude: Vertical distance of the camera above the terrain.
    • Heading: Provides the ability to either get or set the map view rotation value. This is also known as yaw or azimuth. It represents the number of degrees by which the map's data will be rotated, measured counterclockwise from the north. To rotate clockwise, use a negative value.
    • Pitch: Provides the ability to either get or set a map view's pitch. Pitch is the equivalent of moving a plane's nose up or down (rotating along the axis that passes through the plane's wings). Positive values, looking forward, are above the horizon (pointing upward) and negative values are below the horizon (pointing downward).
    • Roll: Provides the ability to either get or set a map view's roll. Roll is the equivalent of tilting a plane's wings up or down (rotating along the axis that passes through the center of the plane from front to back). A zero value is perfectly horizontal. Positive values will tilt the left side upward (or right side downward). Negative values do the opposite.

Local scene

A local scene is a view mode that projects the terrain and layers on a planar surface rather than on a sphere and is only projected with the Web Mercator (Auxiliary Sphere) coordinate system. A local scene can be used to represent the entire world, and it has the option of using a fixed extent that can be clipped to the dimensions of your layers. Local scenes can be used for displaying or analyzing data at the local or city scale and are valuable for urban planning and visualizations when you want to view defined areas such as campus facilities or building developments.

To set up a local scene:

  1. Click Local scene.

  2. Setup initial camera position.

    Local scene

Use the map extent

The map extent is defined by a series of bounding coordinates that delineate the area of the map or scene with which you want to work. It's only used in local scenes.

To set up a map extent:

  1. Fill in the center and the scale of the extent using the Latitude, Longitude and Altitude fields.
  2. Select the shape of the extent.
  3. Fill in the shape dimensions of the extent.

If you want to reset the extent values, or you just don't want to have a map extent, click the Reset Extent button.

Configure an API Key

An API key allows access to services, web maps, and web scenes hosted in ArcGIS Online while you are developing your own application. To set up an API key, enter your API key in the API key field in the Authentication panel.

API Key

Select basemap

A basemap provides a background of geographical context for the content in your scene. ArcGIS Maps SDK for Unity includes a basemap gallery with a variety of choices, including topography, imagery, and streets.

To switch between basemaps:

  1. Click on the dropdown menu.

  2. Select a basemap.

    Select a basemap

Turn elevation off in your scene

You can view the ground at sea level and keep your scene in 3D when you turn your elevation off. Click on the Terrain elevation checkbox to turn on and off elevation.

Add data

Layers are the contents of a map. They include a wide range of topics about people, earth, life, and so on, and are composed of imagery, web services and local data.

What layers can you add?
  • Web Services: Raster Tile Layers, Integrated Mesh Scenes (v1.7), 3D Object Scene Layers (v1.7) and Elevation Layers
  • Local Services: Integrated Mesh and 3D Object SLPK files and TPK files (Imagery and elevation)

Add layers from a web service

Add data from URL

  1. Click the Add from URL button.
  2. Enter the layer's web address in the URL field.
  3. Enter the layer name in the Layer Name field.
  4. Click Add Layer to add the layer to your map.

Add layers from a local file

Add data from a local file

  1. Click the Add from File button.
  2. Introduce file path into the File Name field.
  3. Enter the layer name in the Layer Name field.
  4. Click Add Layer to add the layer to your map.

A new layer will be created automatically in the Layers panel. Use the Clear button to clear the content from the input fields.

Layers

Layers are managed from the Layers panel. You can turn layers on and off, delete them, change the opacity, copy the layer's URL to the clipboard, and reorder them. A layer’s opacity can have a value set between 0 and 100.

Layers

Description of the UI icons:

  • Visiblity Enable / Disable layer visibility
  • Move up Move layer up
  • Move down Move layer down
  • Copy URL Copy layer URL to clipboard
  • Delete Delete layer

Configure OAuth 2.0

When your app requires access to private content in the ArcGIS Platform, you should implement OAuth 2.0 to obtain an ArcGIS identity (previously called a named user login). This allows individual users to authorize your app to use the content and services to which the user has been granted access.

In the Authentication panel, you can add an OAuth Authentication Configuration for each protected service in the OAuth Configuration section. Configuration Mappings allows you to set an OAuth configuration for each protected service.

To set up an OAuth Configuration:

  1. Open the OAuth Configurations in the Authentication panel.

    OAuth Configurations

  2. Click the plus icon to add a new OAuth configuration.

  3. Change the name of the OAuth configuration or leave the one that is by default.

  4. Enter the Client ID and Redirect URI for your app.

To set up a Configuration mapping:

  1. Open the Configuration Mappings in the Authentication panel.

    Configuration Mappings

  2. Click the plus icon to add a new configuration mapping.

  3. Enter the protected layer's web service URL in the URI input field.

  4. Click the Configuration dropdown menu to select the configuration for the layer.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.