Release notes

Version 1.3.0 - August, 2023.

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

Enhancements

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

Mesh modification

Support for mesh modification has been added, enabling you to include other GIS content without re-creating the underlying data. Clip, mask, and replace modifications can be made to integrated mesh scene layers and the elevation surface.

In this release, you can define and apply mesh modifications using the C# API. Mesh modifications are not currently supported in the Map Creator UI or components.

Spatial filtering

You may want to remove some parts of 3D object scene layers and building scene layers after they are added to your ArcGIS Map. Spatial filtering enables you to remove areas of 3D object scene layers and building scene layers in your ArcGIS Map by providing polygon geometries to specify the areas.

In this release, you can define and apply spatial filters using the C# API. Spatial filters are not currently supported in the Map Creator UI or components.

Virtual tabletops

Support for creating virtual tabletop experiences helps you visualize and interact with real-world geographic data in a scene placed on a surface within your virtual or physical environment. It includes a new tabletop sample scene for both the Universal Render Pipeline (URP) and the High Definition Render Pipeline (HDRP). This sample, once imported with the plug-in, can be found under Assets/Samples/ArcGIS Maps SDK for Unity/[version]/Sample Content/Scenes/URP or HDRP. The sample also contains an ArcGIS Tabletop Controller component that determines the geospatial content to render as well as a new ArcGIS Tabletop Input Controller component that supports user navigation with the virtual tabletop. They can be found under Assets/Samples/ArcGIS Maps SDK for Unity/[version]/Sample Content/Components.

C# API

• FeatureFilter property has been added to the ArcGIS3DObjectSceneLayer and ArcGISBuildingSceneLayer classes.
• MeshModifications property has been added to the ArcGISIntegratedMeshLayer and ArcGISMapElevation classes.
• ArcGISMeshModification class has been added to define the modification to apply to a layer or terrain.
• ArcGISMeshModificationType enum has been added to define the type of mesh modification to perform.
• ArcGISSpatialFeatureFilter class has been added to define spatial feature filter to mask out parts of the layer.
• ArcGISSpatialFeatureFilterSpatialRelationship enum has been added to keep features that are either inside or outside the polygon.

Deprecations

OS and framework

• Support for Windows 10 Enterprise LTSC Version 1809 (Build 17763) and Windows Server 2019 Standard and Datacenter is deprecated. Version 1.3 is the last release to support these versions. A minimum of Windows 10 Enterprise LTSC Version 21H2 (Build 19044) and Windows Server 2022 Standard and Datacenter will be required at the next release.

• Support for iOS 14 is deprecated. The last release to support iOS 14 is version 1.3. A minimum of iOS 15 will be required at the next release.

Issues resolved

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

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

• Collider mesh does not update in response to changes in the current LOD displayed for layers in the scene.

  Summary: When collider meshes are enabled, they are generated only for the current LOD of layers in the scene. The collider mesh is not updated when layer content is updated with different LOD tiles.

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 on 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 button 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 on Align with View button on the Map Creator UI sometimes although the camera position has been updated.

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

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

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

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

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

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

  Workaround: Set the file path manually in the Source field. For example: C:/Users/my_username/my_folder/example.slpk.

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

  Summary: 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.

  Workaround: Open the ArcGISMapsSDK.Samples.asmdef file in the Project window, and add Unity.InputSystem to the Assembly Definition References. If you still have compile errors after adding it to the Assembly Definition References, install the required package following the troubleshooting information under Why are there compile errors when I switch to the new Input System?