Display a map (Components)

Learn how to set a basemap, elevation source, and data layers and display a specific area by using the Components.

In this tutorial, you will create an Unreal Engine local scene using a basemap layer service, and data layers. The surface of the scene is defined with an elevation layer and the camera is positioned to display a cropped area of New York City.

Local scene UI

Prerequisites

Before starting this tutorial, you should:

  1. Have an ArcGIS Location Platform account or ArcGIS Online account and an API key to access ArcGIS services. If you don't have an account, sign up for free.

  2. Ensure your development environment meets the system requirements.

  3. Follow install and setup steps and install the plugin.

If you are not familiar with the Unreal Engine's Components, see the Unreal Components page for more information.

Steps

Create a new level

  1. Click File on the Menu Bar and select New Level.

  2. If using a blank template from the games category for your project, select Empty Level in the popup window.

    New Level

    If using a simulation blank template from the simulation category for your project, select Simulation Blank in the popup window,

    New Level Simulation

    and remove the included Floor static mesh actor from the Outliner window.

    New Level Outliner
  3. Click File on the Menu Bar and select Save Level As. Name your level and click Save.

Create a map

In this tutorial, you will create a local scene and set a circular extent.

ArcGIS Map Actor is an Actor that has the essential ArcGIS Map Component for the plugin to load the data. You can include the ArcGIS Map Component in your level by directly adding the ArcGIS Map Actor in the level.

  1. Drag-and-drop the ArcGIS Map Actor into your current level. You can search for the ArcGIS Map Actor using the search bar on the Place Actors panel or find it in the Unreal Editor Content Drawer from the directory below:

    Plugins > ArcGIS Maps SDK for Unreal Engine C++ Class > ArcGISMapsSDK > Public > ArcGISMapsSDK > Actors

    Set up ArcGIS Map Actor
  2. ArcGIS Map Actor will place your GIS content in Unreal Engine space, and you can enable/disable the editor mode and Mesh Colliders. In this tutorial, you will configure where your GIS content is to be placed at 0, 0, 0 of the game engine space. Click ArcGIS Map Actor in the Outliner panel and set the Origin Position in the Details panel. You will need to configure the Origin Position with a WKID (Well-Known ID) for the values. In this tutorial, you are setting up the following Origin Position values for New York City:

    • Longitude: -74
    • Latitude: 41
    • Altitude: 0
    • Spatial Reference WKID: 4326

    For information about spatial reference, see the spatial references page.

  3. Find the Map Type section, then select Local.

  4. Add mark on the Enable Extent checkbox, and expand both the Extent and the Geographic Center section. Set the extent of the map to these values:

    • Longitude: -74.0
    • Latitude: 40.72
    • Shape: Circle
    • Spatial Reference WKID: 4326
    • Shape Dimensions (Radius): 5000

An example result of the ArcGIS Map Actor looks like the following:

ArcGIS Map View Result

Set basemap

In this tutorial, you will set a basemap with a service that requires an API key.

  1. Select the ArcGIS Map Actor in the Outliner panel.

  2. In the Details panel, expand the Basemap section.

  3. Set the ArcGIS Online item page URL for the basemap service in the Basemap property.

    Use dark colors for code blocksCopy
    1
    https://www.arcgis.com/home/item.html?id=c7d2b5c334364e8fb5b73b0f4d6a779b
  4. Select the Basemap option from the drop-down list in the Basemap Type property.

Set the API key

  1. Go to your portal to get your API key.

  2. Select the ArcGIS Map Actor in the Outliner panel.

  3. Find and expand the Authentication section in the Details panel.

  4. Set the API key in the API Key field.

Another way to set up a global API key for multiple levels in your Unreal project is through Project Settings. For more information about the API key, refer to the API keys section.

Set elevation

  1. Expand the Elevation section.

  2. Click the + icon to add a new array element.

  3. Expand the newly added row and enter Terrain 3D in the Name field.

  4. Enter the online service URL for the elevation service in the Source field.

    Use dark colors for code blocksCopy
    1
    https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer
  5. Check the Is Enabled checkbox to create relief.

For more information about the elevation, refer to the Elevation page.

Add data layers

You will add operational data from ArcGIS Online.

  • ArcGIS Online item: UrbanObservatory_NYC_TransitFrequency
    • Layer name: 01 - New York Transit Frequency
    • Type: ArcGIS Image Layer
    • Online service URL (source):
    Use dark colors for code blocksCopy
    1
    https://tiles.arcgis.com/tiles/nGt4QxSblgDfeJn9/arcgis/rest/services/UrbanObservatory_NYC_TransitFrequency/MapServer
    • Opacity: 0.9
  • ArcGIS Online item: New_York_Industrial
    • Layer name: 02 - New York Industrial Areas
    • Type: ArcGIS Image Layer
    • Online service URL (source):
    Use dark colors for code blocksCopy
    1
    https://tiles.arcgis.com/tiles/nGt4QxSblgDfeJn9/arcgis/rest/services/New_York_Industrial/MapServer
    • Opacity: 0.6
  • ArcGIS Online item: NewYorkCity_PopDensity
    • Layer name: 03 - New York Population Density
    • Type: ArcGIS Image Layer
    • Online service URL (source):
    Use dark colors for code blocksCopy
    1
    https://tiles.arcgis.com/tiles/4yjifSiIG17X0gW4/arcgis/rest/services/NewYorkCity_PopDensity/MapServer
    • Opacity: 1.0
  • ArcGIS Online item: New York, USA Buildings
    • Layer name: 04 - New York Buildings
    • Type: ArcGIS 3D Object Scene Layer
    • Online service URL (source):
    Use dark colors for code blocksCopy
    1
    https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/Buildings_NewYork_17/SceneServer
    • Opacity: 1.0

Follow these steps to add each layer.

  1. Select the ArcGIS Map Actor in the Outliner panel.

  2. Find the Layers section in the Details panel, and click the + icon to add a new layer array.

  3. Type the layer name in the Name field.

  4. Enter the layer's online service URL in the Source field to add an image tile layer.

  5. Set the Opacity to a specific value by dragging the slider.

  6. Select the Is Visible checkbox.

  7. Select the appropriate layer type from the drop-down list in Type.

This is the result of the Layers panel.

Add data

Create a camera

The ArcGIS Camera Component controls the data that is loaded into your scene. The ArcGIS Location Component is responsible for the position and the angle of the camera. You can create your own camera controller and attach these components to a Default Pawn, which is a subclass of the Pawn class that comes with some additional Components and functionality. For more information about Default Pawn and Pawn, you can reference the Unreal Engine documentation.

  1. Place the Default Pawn in your current level by doing drag-and-drop. You can search for the Default Pawn directly from the search bar of the Place Actors panel.

  2. While having the Default Pawn selected, go the the Details panel, and click the +Add button and search for ArcGIS Camera and ArcGIS Location.

  3. Add both components respectively.

Replace the Default Pawn with the ArcGIS Pawn

You can move the camera around by using WASD keys during the Editor mode regardless you attach a controller Component to it before it responds to player input. For the runtime, you can attach your own controller Component to your Default Pawn. You can also replace the Default Pawn with the sample ArcGIS Pawn that is used in the sample levels. For information about the sample ArcGIS Pawn, see the ArcGIS Pawn section.

  1. Locate the ArcGIS Pawn from the Content Drawer and select it. When it is selected the background color changes to blue.

    Pawn
  2. Right click your Default Pawn in the Outliner panel.

  3. Click Replace Selected Actor with, then select ArcGIS Pawn.

  4. Click the Actor and select ArcGIS Location Component in the Details panel.

  5. In the ArcGIS Location Component, set the Position to:

    • Longitude: -74.054921
    • Latitude: 40.691242
    • Spatial Reference WKID: 4326
    • Altitude: 3000 Meters
  6. Set the Rotation to:

    • Heading: 55
    • Pitch: 58
    • Roll: 0

This is the result of the ArcGIS Pawn settings.

Pawn local Result

Set up sky and lighting

  1. From the Create menu on the Main Toolbar, select Lights > Directional Light and drag it into the level to create a Directional Light. For more information about Directional Lights, see Lights.

    Directional Light
  2. Select the Directional Light in the Outliner, and open the Transform section in the Details panel.

  3. Reset the Location and Set the Rotation to:

    • X: 0
    • Y: -28
    • Z: -28
  4. Set the Mobility to Movable.

    Directional Light Transform
  5. In the Light section, change the Intensity Value to 3.1416.

  6. In the Cascaded Shadow Maps section, change the Dynamic Shadow Distance MovableLight to 2000000.

  7. In the Atmosphere and Cloud section, enable Atmosphere Sun Light.

  8. In the Actor > Spawn Collision Handling Method section, select Always Spawn, Ignore Collisions.

    Directional Light Actor
  9. From the quick add menu on the toolbar, select Lights > Sky Light and drag it into the level to create a Sky Light. For more information about Sky Light, see Lights.

  10. In the Transform section, reset the Location and set the Mobility to Movable.

  11. In the Light section, enable Real Time Capture.

    SkyLight
  12. From the quick add menu on the toolbar, select Visual Effects > Sky Atmosphere and drag it into the level to create a Sky. For more information about Sky Atmosphere, see Fog Effects.

  13. In the Planet section, change the Ground Radius to 6378.137207.

You have successfully configured the local scene with the Components.

In the Outliner panel, double-click the Pawn Actor to move the Editor camera to the configured camera position. Use the WASD keys while holding the right mouse button mouse to move around, or hold the left mouse button to look around during the Editor mode.

Click the Play icon on the Toolbar, and Use the WASD keys to move around, hold the right mouse button mouse to look around or hold the left mouse button to pan. If you cannot move the camera during runtime, make sure you have replaced the Default Pawn with the ArcGIS Pawn.

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