Release notes

Version 1.4.0 - December, 2023.

This page provides details about enhancements, deprecations, resolved issues, and known issues in the 1.4 release of ArcGIS Maps SDK for Unity.


Building scene layer filtering

With this release, you can now filter building scene layers by creating custom attribute filters with SQL WHERE clauses. Building scene layers enable you to view one or more building models together in their spatial context and to work with the component parts of these buildings by querying and filtering different aspects. Building content is often derived from Building Information Modeling (BIM) workflows in design and construction. BIM processes can produce 3D virtual representations of real-world assets that are commonly used for construction, documentation, and evaluation of structures.

The ability to visualize building scene layers and work with sublayers was already available in a previous release, but with the rich level of detail a building scene layer these models include, you often want to interactively filter elements or parts of a building to see only aspects that relate to your work. For example, you may want to see only the parts of a building that are on the second floor, show only the load-bearing walls, or just the electrical system. As a developer using either the low-code/no-code tools in the Unity Map Creator UI, or programming with the API, you can support these user requirements by applying a filter to a building scene layer. Filters give you access to the full structure of a building scene layer including the discipline, such as Architectural, the categories, such as walls, and custom queries to filter elements based on their attribute values such as the material type or manufacturer. Building scene layer filtering is available in the Unity Map Creator UI with new Building Filter and Disciplines and Categories options in the Layers tab.

Building Scene Layer Filter

Building scene layer filtered with a SQL WHERE clause attribute filter (building data provided by Christchurch City Council).

Spatial filtering and mesh modification

With this release, the ability to spatially filter scene layers and modify meshes can now be accessed through a new UI in the Unity Editor. The new UI tools enable you to interactively draw and modify polygon areas to be applied as spatial filters for 3D object scene layers and building scene layers, and applied as mesh modifications for integrated mesh scene layers and elevation surface. The ability to spatially filter scene layers and modify meshes was already available in a previous release, but only when using the API, and only on the supported desktop platforms (macOS and Windows). This feature can now also be included in applications deployed on the mobile platforms Android and iOS.

3D Object Scene Layer Clip

Clip modification being applied to buildings in a 3D object scene layer.

A further valuable addition for mesh modifications is the new ability to simply apply a constant elevation value to the polygon areas you have defined, avoiding the need to replace with another existing terrain dataset. A corresponding new modification type replace has been added, enabling you to apply a new constant value to the specified area and specify a new altitude.


  • A list of basemap style enum values is added to the ArcGISBasemapStyle, including:
    • ArcGISHumanGeography
    • ArcGISHumanGeographyBase
    • ArcGISHumanGeographyDetail
    • ArcGISHumanGeographyLabels
    • ArcGISHumanGeographyDark
    • ArcGISHumanGeographyDarkBase
    • ArcGISHumanGeographyDarkDetail
    • ArcGISHumanGeographyDarkLabels
    • OSMBlueprint
    • OSMHybrid
    • OSMHybridDetail
    • OSMNavigation
    • OSMNavigationDark
  • FetchStatisticsAsync method has been added to the ArcGISBuildingSceneLayer class.
  • ArcGISBuildingAttributeFilter class has been added to define a set of conditions that can be used to show or hide components in a building scene layer.
  • ArcGISSolidBuildingFilterDefinition class has been added to define which building components should be viewed as solid in the associated ArcGISBuildingSceneLayer.
  • ArcGISBuildingSceneLayerActiveBuildingAttributeFilterChangedEvent has been added to invoke the callback when the ArcGISBuildingSceneLayer.ActiveBuildingAttributeFilter changes.
  • ArcGISBuildingSceneLayerAttributeStatistics class has been added to summarize statistics for an individual attribute field in an ArcGISBuildingSceneLayer.
  • A new type of mesh modification, Replace, has been added to the ArcGISMeshModificationType enums.

Plugin samples

  • The 3D attributes sample and the ArcGIS hit test sample have been moved to the GitHub sample repo. (The 3D attributes sample has been renamed to Material By Attribute.)


There are no OS and framework deprecations with this release.

Issues resolved

  • Unable to compile Unity projects (with Sample Content imported) due to the samples assembly definition file missing a reference.

    Summary: The ArcGIS Camera Controller component in the Sample Content causes compile errors when the Active Input Handling in the Project Settings is set to Input System Package (New) or Both due to the samples assembly definition file (.asmdef) missing a reference to Unity.InputSystem.

  • Repeating textures not mapped correctly for 3D object scene layers.

    Summary: 3D object scene layers that have repeating textures with UV mapping but no geometryUVRegion are rendered with a repeating edge of the texture instead of repeating the full texture.

  • Fully transparent materials are rendered with some artifacts with the Unity 2022 Universal Render Pipeline.

    Summary: Scene nodes with full transparency are rendered with artifacts due to the alpha component not being used correctly with the Unity 2022 Universal Render Pipeline.

  • Cannot 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, a transform.localPosition assign attempt for ... error message is logged in the Console window. Once the errors occur, you cannot select anything else until you restart Unity; attempting to press play causes Unity to crash.

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

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

  • Local file packages cannot be added from the ArcGIS Map component using the meatball menu (three dots icon).

    Summary: Adding local file packages from the ArcGIS Map component using the meatball menu does not add the file path to the Source field, and InvalidOperationException: Stack empty message is logged in the Unity Console.

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

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.

  • Setting opacity to scene layers has no effect.

    Summary: Opacity does not work if the 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.

  • Mesh collider/Terrain occlusion issue

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

    Workaround: No workaround available.

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

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

  • Error messages display in the Unity console after installing the SDK plugin.

    Summary: An error message of [fileanme] has no meta file, but it's in an immutable folder. The asset will be ignored displays in the Unity Console after adding the SDK plugin to the Unity project with Unity version 2021.3.22 or below.

    Workaround: Update your Unity minor version. For example, from 2021.3.11 to 2021.3.24.

  • Custom basemaps disappear from the basemap gallery after play.

    Summary: After adding custom basemaps from the Map Creator UI, click play once removes all custom basemaps that are not currently selected.

    Workaround: To add another custom basemap after playing once, re-add it and select it.

  • Some parts of meshes are missing when there are overwrapping polygon areas with the Replace mesh modification type.

    Summary: When two overlapping mesh modifications of type replace are created on the elevation surface, the overlapping region is not rendered.

    Workaround: No workaround available.

  • In the Add New Basemap dialog, all options in the drop-down lists are disabled when using Unity 2021 versions earlier than Unity 2021.3.33f1 on macOS.

    Summary: When using Unity 2021 versions earlier than 2021.3.33f1 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: Use a higher Unity 2021 version (e.g. Unity 2021.3.33f1).

  • Some parts of the mesh are missing or have bad LOD for the area with the replace mesh modification type.

    Summary: For the flattened area with a new z value where the replace mesh modification type is used, some parts of the mesh are missing or have low LOD depending on the camera position.

    Workaround: No workaround available.

  • Scene layer mesh normals are inconsistent with the Universal Render Pipeline.

    Summary: Scene layers with inconsistent normals in the data are not rendered correctly.

    Workaround: No workaround available.

  • Changing building scene layer opacity doesn't apply in play mode

    Summary: After you change building scene layer opacity and hit play, the opacity value gets lost.

    Workaround: No workaround available.

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

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

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

  • Plugin samples can't be imported into a Unity project if the ArcGIS Maps SDK for Unity plugin is downloaded from the Unity Asset Store.

    Summary: When the plugin is downloaded from the Unity Asset Store, users can't import the plugin sample to their Unity projects when the "Import" button is clicked.

    Workaround: No workaround available. Use the tarball version of the plugin from the Downloads page to import the plugin sample.

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