Release notes 1.2.0

Version 1.2.0 - April, 2023.

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


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 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 Map Creator 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 there are 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, much like the custom elevation source in the previous version.

Scene layers support

  • The LOD selection of scene layers has been changed to use higher resolution texture data when available.


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


  • 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.

Map Creator 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 Unity's built-in HTTP stack. This removes the need to provide binaries for OpenSSL when targeting Android.

OS and framework

Mac computers with Apple silicon are now supported for development and deployment. You can now use the Unity Editor Apple silicon version to develop your apps and deploy your apps to Mac computers with Apple silicon.


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 the elevation is enabled.

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

  • Scene layer packages with non-ASCII characters in their file name or in the path cannot be loaded.

    Summary: When there are non-ASCII characters in the scene layer package name or if the path that contains the scene layer package has non-ASCII characters, the layer cannot be loaded.

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

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

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 error messages by using the view state report, propagated error messages are logged in the Console although it's not an error.

    Workaround: No workaround available.

  • Changes on the component not reflected in the Map Creator UI.

    Summary: After making changes to the component, the Map Creator UI does not automatically update with the new values.

    Workaround: Click a different tab in the Map Creator UI to pull the new values from the component.

  • 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.

  • One image tile layer is still visible in the Scene view window even after removing all during the editor mode.

    Summary: One image tile layer remains visible after removing all the image tile layers in the level.

    Workaround: Play the scene once or reload the scene.

  • Setting opacity to scene layers has no effect.

    Summary: Opacity does not work if Unity material for the scene layer is opaque.

    Workaround: Change the scene layer material to the one that has transparency.

  • 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 the elevation.

  • The layer management popup of the Map Creator UI stays visible.

    Summary: The layer management popup of the Map Creator UI stays visible even after clicking outside of it.

    Workaround: Click again on the icon in the layers panel.

  • The layer management popup of the Map Creator UI is covered by other Unity Editor tabs.

    Summary: The layer management popup of the Map Creator UI is covered by other Unity Editor tabs and is not fully visible.

    Workaround: Adjust other tab sizes to display all layer management options.

  • Not be able to deselect the original tiles or select new tiles while selecting a group of tiles in the Scene view.

    Summary: While selecting a group of tiles in the Scene view by holding the Shift key, transform.localPosition assign attempt for ... error message logged in the Console window. Once the errors come up, you cannot select anything else until you restart Unity, attempting to press play will cause Unity to crash.

    Workaround: No workaround available.

  • The default layer opacity is set to 0 instead of 1 in the ArcGIS Map component.

    Summary: When you add the first array element in the Layers section or the ArcGIS Map component, the default layer opacity is set to 0 instead of 1.

    Workaround: Manually change the layer opacity value to make it visible after adding the row.

  • Adding a new layer array or Authentication Configuration array row in the ArcGIS Map component duplicates the layer that is already added.

    Summary: When you add a new layer array element or Authentication Configuration array element in the ArcGIS Map component, it duplicates the last row with its values.

    Workaround: Replace values with new values after adding the row.

  • 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.

  • Updating the initial camera position by clicking Align with View on the Map Creator UI prints an error message in the Console.

    Summary: An error message transform.position is printed in the Console after clicking Align with View on the Map Creator UI even though the camera position has been updated.

    Workaround: Change the camera angle and click Align with View to update the Rotation.

  • Moving the scene camera by clicking Zoom to Layer doesn't make any effect.

    Summary: When the layer source is an item page URL, clicking Zoom to Layer doesn't move the scene camera.

    Workaround: Use the service URL instead of the item page URL as the layer source.

  • Integrated mesh scene layer behind terrain relief is rendered with URP.

    Summary: When an integrated mesh scene layer is behind terrain such as behind a mountain, the layer is visible.

    Workaround: No workaround available.

  • All options in the drop-down lists are grayed out in the Add New Basemap pop-up window on macOS

    Summary: On macOS, it is not possible to select Type and Authentication in the Add New Basemap pop-up window opened from the Map Creator UI.

    Workaround: Click the ArcGIS Map game object in the Hierarchy window and change the selection in the Inspector window.

  • Custom basemap name will be lost after clicking play

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

    Workaround: No workaround available.

  • 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.

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