Release notes for 200.7

Snap geometry edits using utility network rules

The utility network includes a set of rules to determine what features can connect to one another. For example, you can connect a fuse to an electric power line, but not to a gas pipe. You can now configure the interactive snapping behavior of a GeometryEditor to account for these connectivity rules, helping you create true edits for utility network features that can be successfully validated.

You can now configure rule-based snapping by first creating SnapRules that are applicable to the utility network asset type of the feature you will edit. If you are editing existing features, create the snap rules by passing the UtilityAssetType to SnapRules.rules(for:assetType:). If you are creating new features, pass the attributes of the new feature that includes the asset type to SnapRules.rules(for:featureTable:attributes:). Next, call SnapSettings.syncSourceSettings() to synchronize the snap sources of the GeometryEditor to refer to these snap rules. Provide the SnapRules that you have created and specify the SnapSourceEnablingBehavior.

Snapping support for each sublayer of a subtype feature layer

When using GeometryEditor snapping and working with subtypes, you can now configure each SubtypeSublayer for snapping individually. Each SnapSourceSettings that corresponds to a SubtypeSublayer is now available from the SnapSourceSettings.childSourceSettings collection of its parent SubtypeFeatureLayer snap source, and can be enabled or disabled independently of its parent layer.

User input location support for Popups

Arcade expressions in popups can now use Popup.userinput to access information about the map location that was used to show the popup. For more information, see popup profile in Arcade.

Override the popup definition for an individual feature in a feature collection

Popup definitions can now be defined for individual features in a feature collection, allowing map authors to customize what a popup looks like for an individual feature instead of using the same definition for all features in the collection. Use FeatureCollectionTable.setPopupDefinitionOverride(_:for:) to override the feature collection popup definition for a specific feature. When an identify method returns popups, the identify result will automatically have the overridden PopupDefinition. You can also use FeatureTable.popupDefinition(for:) to return the overridden feature-specific PopupDefinition.

Support for user-configured popup chart colors

User-configured chart colors are now supported in popups. Use PopupMediaValue.chartColors to access the collection of colors defined for a popup when rendering charts in popups. For more information, see custom colors in pop-up charts in ArcGIS Online.

New utility associations popup element

A UtilityAssociationsPopupElement is a new type of PopupElement that gives you complete control over which associations are displayed through the use of the new UtilityAssociationsFilter class. You can configure filters to only display associations of a particular type and role (such as content or connectivity), or that the feature on the other side of the association matches a particular network source, asset group, or asset type.

A PopupDefinition with a UtilityAssociationsPopupElement will be honored when included in a web map. You can also create or update a UtilityAssociationsPopupElement and save it in a web map. Note that the UtilityAssociationsPopupElement is not integrated into the "Popup" toolkit component at this time, but is a planned improvement.

Check for unsaved edits in a feature form

FeatureForm has a new FeatureForm.hasEdits property that allows you to know if there are active attribute edits on the feature. You can use it to enable UI elements like buttons to prompt the user to Save or Discard the edits.

Utility network associations element in feature forms

When a feature form is created (using Map Viewer or Field Maps Designer) on a layer or table that is part of a utility network, elements can now be added to show features that are associated to the feature being edited. The association form elements show all the features associated in a particular way; for example, features connected to the feature being edited, features contained within the feature being edited, and so on.

The UtilityAssociationsFormElement objects are now supported as part of the FeatureForm.elements collection. They support fetching the associated features and returning UtilityAssociationResult objects that can be displayed in a user interface.

Form notifications when features are updated externally

When a feature is updated in a local geodatabase outside of the feature form editing experience, the feature form will reflect the feature's changes when Feature.refresh() is called. This can occur when there are attribute rules that run for the feature that update the geodatabase. Feature form handles this by an observed change to FieldFormElement.value as the feature's attribute is updated via to a call to Feature.refresh().

Query dynamic entities

You can now query a DynamicEntityDataSource to find dynamic entities that meet spatial and/or attribute criteria. Because dynamic entities change over time, the query returns a collection of entities that match the DynamicEntityQueryParamaters at the moment the query is executed. Although the number of dynamic entities in the result set is fixed, you can monitor these entities and be notified when new observations are received. This is useful for scenarios such as: finding a flight with a particular ID, identifying all first responders in the same task team, or returning all emergency vehicles currently within a specified distance of a reported incident.

Improved performance of feature layers in a scene

In this release, performance of feature layers in 3D has been improved for line and polygon geometries. The improvement is pronounced when the layer contains a significantly large number of vertices. This improvement can result in 3 to 5 times increase in draw times and a lower CPU usage.

Support for subtype group tables

Similar to SubtypeFeatureLayer, subtype group tables allow each FeatureSubtype in a non-spatial object class to have their own query methods, edit operations, popup definitions, and more.

If a web map contains a subtype group table, the ArcGISFeatureTable.subtypesubtables collection will be populated with SubtypeSubtable objects when the web map is loaded. You can also create, configure, and add new SubtypeSubtable objects to this collection and save them in the web map.

Load a WMTS layer from a portal item

With this release, you can now load a WMTSLayer from a portal item.

Support for image overlays in map views

MapView now supports image overlays; previously only supported in scene views. You can use an ImageOverlay to quickly render frequently changing images such as realtime sensor data. For example, to display a dynamic weather system, each frame from the weather radar is represented as a static image. This image is constantly updated via a new ImageFrame as new data comes in to give a fast-refreshing display.

Support for new Arcade version

The SDK now supports Arcade 1.31.

The following functions have been added:

• Geotrigger profile support for the Data Access bundle.
• Different curve types support in geodetic geometry functions.

Adaptive radio positioning

Indoor positioning accuracy has been improved using enhanced algorithms in our indoor positioning system (IPS) engine. The indoor location data source (ILDS) now caches statistics on received radio signals and uses the cached data to deliver more accurate positions in subsequent sessions. In addition to this new feature, the behavior of the blue dot on Android phones has been improved. Due to poor quality built-in sensors, some Android phones struggle to provide the same level of positioning accuracy as phones with higher quality sensors. The new adaptive radio positioning algorithm will mitigate this by continuously adjusting the received radio signals so that our IPS engine can calculate more accurate indoor positions.

Stand still filter

The user experience when standing still has been improved. A new filter detects when the user stops walking and locks the blue dot. If the IPS engine receives more accurate positions during this stationary period, the position of the blue dot is slowly updated.

Improved startup

During the startup phase, the IndoorsLocationDataSource (ILDS) response has been improved when a sensor fails to start or when permissions are missing. When the ILDS is running, alert handling from sensors has been enhanced and the ILDS now presents appropriate warnings.

Coordinate systems and transformations

• Available coordinate systems and transformations have been updated to EPSG v12.002.
• The names of EGM vertical coordinate systems have been revised to align with the official EPSG names.
• EGM2008 geoid transformations in the behind-the-scenes processes have been updated to use the official NGA methods.
• ArcGIS Coordinate Systems Data supplement component now includes new geographic transformation grids for Germany and the United Kingdom, as well as new vertical transformation models for Bonaire (Dutch Caribbean), European continent (EVRF systems), Finland, and Slovenia.

Offline Map Areas

The OfflineMapAreasView toolkit component allows users to take web maps offline. Users can download map areas created ahead-of-time by the web map author, or they can create map areas on-demand by specifying an area of interest and level of detail. Map areas are downloaded to the app's Documents directory and can be used even when the app is completely offline. Users can get information about a map area such as its size and the geographic region it covers. They can also delete a downloaded map area to free up storage space on the device. Developers can get a list of web maps that have been downloaded by a user to the device using the OfflineManager.offlineMapInfos property available through OfflineManager.shared instance.

Popup

The charts displayed by the toolkit component now honor the custom colors configured by the web map author. This allows the popup to highlight information in the chart or make it look cohesive by matching the color theme of the app or layer.

3D Basemaps

The Portal class now supports fetching 3D basemaps from ArcGIS Online or ArcGIS Enterprise using the Portal.basemaps3D async property.

There are no breaking API changes with this release.

• GeometryEngine methods GeometryEngine.convexHull(for:), GeometryEngine.convexhull(for:shouldmerge:), and GeometryEngine.geodeticDensify(_:maxSegmentLength:lengthUnit:curveType:) now support true curve input, producing densified curves in the result geometries.

• The IndoorsLocationDataSource constructors that use a FeatureTable are deprecated and will be removed in a future release. Use the constructors that accept a IndoorPositioningDefinition instead.

• Support for iOS/iPadOS 16 is deprecated. The last release to support this version is 200.7. A minimum of iOS/iPadOS 17 will be required at the next release.

• Support for macOS Ventura (version 13) is deprecated. The last release to support this version is 200.7. A minimum of macOS Sonoma (version 14) will be required at the next release.

Issues addressed in this release are listed below.

• BUG-000158647/BUG-000157410 - Layer with access key fails to load. This has been resolved by adding portal item support to WMTSLayer.
• BUG-000174246 - After running for extended periods of time (24+ hours) an application using composite symbols to render graphics will lead to a runtimecore access violation error and crash the program.
• BUG-000170373 - A custom display field displayFieldExpressionInfo is not honored in Native SDKs.
• BUG-000173617 - When related records of a feature that has 0 related records in M:N relationship are queried in ArcGIS Map SDKs, an error is returned com.esri.arcgisruntime.ArcGISRuntimeException: Geodatabase item not found, instead of an empty list.
• BUG-000174741 - The composite locator bundled in a mobile map package fails to load in the application.

• Issue reported on Esri Community: Cancellation token not working during IdentifyLayersAsync operation causes the application to freeze.

• FeatureForm.validationErrors contains errors that are not actionable. It should only contain errors from field form elements that are visible and editable.

There are no known issues or limitations for this release.

New samples

• Configure electronic navigational charts
• Create KML multi-track
• Snap geometry edits with utility network rules

Enhancements

• Simplified Snap geometry edits by removing the use of non-snapping tools.
• Updated Edit features using feature forms to only show the discard edits alert when edits have been made to the form.
• Enhanced the error alert to provide more error information.
• Included additional details on the geodetic buffers' behavior in the Create planar and geodetic buffers README.
• Removed a workaround for a bug that caused viewpoints to jump when a keyboard was presented in landscape orientation.
• Added support for more SwiftLint opt-in rules.

Bug fixes

• Removed use of a deprecated IndoorsLocationDataSource initializer from Show device location using indoor positioning.
• Corrected the Query feature count and extent category category to "Search and Query".