Release notes

Version 1.2.0 - April, 2023.

This page provides details about enhancements in ArcGIS Maps SDK for Unreal Engine version 1.2.0. It also lists this release's resolved issues and known issues.

Enhancements

This section describes new features and improvements (what's new).

Building scene layer support

Support for building scene layers has been added. A building scene layer is a 3D representation of a building model, which may be derived from 3D construction content, such as 3D BIM (Building Information Modeling) data. A building scene layer can contain both 3D object scene layers and point scene layers as sublayers. As point scene layers are not supported, only 3D object scene layers will be rendered. You can load building scene layers from online services or your device locally as scene layer package (.slpk) files.

Individual or group sublayer filtering in the building scene layer is not currently supported in the Modes Panel UI or components. You can use the C++ API to filter sublayers and perform layer operations such as changing the sublayer opacity and visibility.

Multiple elevation sources support

There can be multiple elevation sources for your ArcGIS Map that generate a combined terrain relief. When you have multiple elevation sources, the source with higher priority overwrites the elevation data of the lower priority sources.

The spatial reference of all elevation sources should match the ArcGIS Map's spatial reference, like the custom elevation source in the previous version.

Scene layers support improvement

• Higher LOD data is now used if available.

C++ API

• ArcGISBuildingSceneLayer has been added to the ArcGISLayerType.
• ArcGISBuildingSceneSublayer and ArcGISBuildingSceneSublayerDiscipline are added to support building scene layer sublayers.
• ElevationSources property has been added to ArcGISMapElevation to support multiple elevation sources.

Blueprints

• New nodes are added under ArcGIS Building Scene Layer for adding building scene layers as well as getting sublayers from them.
• New nodes are added under ArcGIS Building Scene Sublayer and ArcGIS Building Scene Sublayer Immutable Collection to get the sublayer's properties and work with the sublayer's visibilities and opacities.
• A new node Create ArcGIS Map Elevation with Elevation Sources is added under ArcGIS Map Elevation for creating elevation relief with multiple elevation sources.

Components

• The default value of the Quality Scaling Factor in the ArcGIS Camera Component has been changed from 2 to 1.
• The Elevation section has been updated to allow adding more array elements for multiple elevation sources.
• The building scene layer option has been added to the drop-down selection of layer Type under the Layers section.

Modes Panel UI

• The Elevation tab content has been updated to support multiple elevation sources.
• The Layers tab content has been updated to support building scene layers.

HTTP request handling

Android HTTP requests are now handled using Unreal Engine's built-in HTTP stack. This removes the need to provide binaries for OpenSSL when targeting Android.

Others

• Moving ArcGIS Map using Unreal Engine's gizmos is now supported.

Deprecations

OS and framework

Support for macOS Big Sur 11 is deprecated. The last release to support macOS Big Sur 11 is version 1.2. A minimum of macOS Monterey 12 will be required at the next release.

Issues resolved

• Generated normal maps have geometric patterns when elevation is enabled.

  Summary: When elevation is enabled, generated normal maps have geometric patterns and are visible on the surface.

• Image tiles flash when the basemap is a vector tile layer

  Summary: While navigating in the level, several image tiles flash if the basemap is a vector tile layer.

• Layers with non-ASCII characters in the URL, the file name, or the path cannot be loaded.

  Summary: When there are non-ASCII characters in the URL, the file path, or the name, the layer cannot be loaded.

Known issues

• A basemap that fails to load will cause all layers in the ArcGIS Map to fail to display.

  Summary: If you are using a basemap that fails to load (for example, a preset basemap that requires an API Key, but no API Key is set) then the loading of the ArcGIS Map will be interrupted and it will appear blank. This also impacts the SDK samples that use a preset basemap.

  Workaround: Be sure to set an API key when using one of the preset basemaps.

• View state report propagated warning messages

  Summary: When you subscribe to the error messages by using the view state report, propagated error messages are logged in the Output Log although it is not an error.

  Workaround: This issue does not impact the usage of the plugin. If you use the ArcGIS View State Logging Component in your level, you have the option to hide warnings.

• Tile flashing

  Summary: While navigating in the level, a few tiles flash occasionally.

  Workaround: Disable hardware occlusion by following the Unreal Engine's documentation

• OAuth edge case issue

  Summary: The authentication cannot be completed even if the sign-in is successful when there are expired sign-in pop-up windows from the previous private layer loading attempt. Using or closing an expired pop-up window causes Unreal Engine to crash.

  Workaround: When the sign-in window pops up, always close the window by either signing in or closing it manually.

• Some parts of integrated mesh scene layers flash while navigating around the area.

  Summary: When elevation is enabled in the scene, some parts of the integrated mesh scene layers flash.

  Workaround: Disable elevation.

• The extent dimension values are incorrectly applied in the scene when the extent center is away from the Equator.

  Summary: When you set an extent in the area away from the Equator in an ArcGIS Map with a geographic coordinate system, the shape dimension is bigger than the values set for the extension.

  Workaround: No workaround available.

• Services cannot be loaded with the item URL if non-ASCII characters in the service URL.

  Summary: When there are non-ASCII characters in the service URL, the layer cannot be loaded by using the item URL.

  Workaround: Use the service URL that is encoded in UTF-8.

• Mesh collider/Terrain occlusion issue

  Summary: When using an integrated mesh layer that dips below the elevation, the terrain occlusion mechanism is not showing the elevation but the collider still exists, which in some edge cases can make objects float above the integrated mesh.

  Workaround: No workaround available.

• Android packaging issue (Unreal Engine 5.1 only)

  Summary: When you package to Android using Unreal Engine 5.1 and open the app on your phone, you might see the error message "Permission required, you must approve the permission in App Settings: Storage" but are unable to grant the storage permission.

  Workaround: No workaround available.

• PCS (Projected Coordinate System) layer orientation changes

  Summary: After exiting out of Play mode while a PCS layer is loaded, the orientation of the layer changes in the Viewport.

  Workaround: No workaround available.

• Unreal Editor crashes when you click play just after opening the level

  Summary: When you click play after opening a level without waiting enough for the editor mode to load, Unreal Editor crashes.

  Workaround: No workaround available.

• Custom basemap name will be lost after clicking play

  Summary: The name for the custom basemap that is added from the Modes Panel UI will be automatically changed to User Basemap after clicking play.

  Workaround: No workaround available.

• Disabled elevation sources are active during the Play mode

  Summary: Elevation sources are active although they are disabled in the Modes Panel UI or in the ArcGIS Map Component.

  Workaround: Remove elevation sources from the ArcGIS Map Component.

• RGBA initializers shown in rendered basemaps

  Summary: Some basemaps, when utilized with scenes, include RGBA value initiator labels (e.g. RGBA(255,12,87,0)) that don't represent actual map locations.

  Workaround: No workaround available.

• Political boundaries not shown in Light/Dark Gray Canvas vector tile layers

  Summary: When adding a Light/Dark Gray Canvas as a basemap or a vector tile layer, political boundaries are not displayed.

  Workaround: No workaround available.