Release notes for 200.1

More code snippets in the documentation

Several topics in the developer guide have been enhanced with additional code snippets that illustrate using ArcGIS Maps SDK for Qt. Look for them in topics such as:

• Maps (2D)
• Scenes (3D)
• Layers
• And many others ...

Support for stream data

With this release, ArcGIS Maps SDKs for Native Apps introduces a new Dynamic Entities API. Use this API to connect to an ArcGIS Stream Service, bring data updates directly into your app, and process them in real time. Once established, a connection to a data stream is maintained and continues to deliver updates until it's closed. Objects created from a stream (known as dynamic entities) can be shown in a new layer, DynamicEntityLayer, that is designed for real-time display. While no other work is required for consuming and displaying data from a stream, the API also exposes notifications that provide more fine-grained control. Handle these events to work directly with data coming from the stream, to get connection status changes, to track updates for a specific dynamic entity, and so on.

See the new Work with dynamic entities guide topic for more information.

Feature tiling enhancements

Version 200.1 introduces a new feature tiling mode, FeatureTilingMode.EnabledWithFullResolutionWhenSupported . This provides an opt-in experience for developers to request high resolution geometries from a service. To opt-in, developers can set the feature tiling mode using the LoadSettings property on the GeoModel or on the individual layer.

This mode requires the service to support edit quantization mode (supportsQuantizationEditMode = true), which returns all vertices of the source geometry in a high resolution. Use this mode for workflows that benefit from precise geometry editing, such as snapping feature geometries without loading the feature.

New GeometryEditor class

A new GeometryEditor class provides a simple way to create or edit geometries interactively in a map view. It supports a wide array of use cases, from creating quick notes on a map to allowing feature geometry editing workflows. The interactive use of GeometryEditor is complemented by its support for programmatic creation and editing methods, providing a powerful way to guide and supplement the built-in UX workflows. The appearance of the edited geometry can be customized using the range of symbology available in the API.

The GeometryEditor is built from the ground up as the successor to SketchEditor. It introduces a new vertex and edge selection methodology, along with finer-grained control over editing. It is the foundation for additional geometry editing capabilities that will roll out in future releases.

Edge rendering

With this release, visualization of edges on 3D Object Scene Layers is available for iOS and Mac Catalyst apps built with ArcGIS Maps SDK for .NET or ArcGIS Maps SDK for Swift. Support for visualization of edges was first introduced in the Native Maps SDKs at version 200.0 but was only available for apps deployed to Android, Linux, macOS, and Windows operating systems.

Edge rendering remains unavailable on iOS when using ArcGIS Maps SDK for Qt. Support for edge rendering with this development and deployment configuration will be introduced in a future release as support is added for Metal-based rendering.

Performance improvements

The performance of the scene view control when there is no user interaction has been improved by approximately 20 percent. This results in lower CPU consumption when the scene view is inactive and a corresponding reduction in battery usage for mobile devices.

The scene layer data loading pattern for desktop platforms has been optimized to prioritize loading content in the foreground while continuing to load coarser levels of detail (LoDs) in the background. This results in a significant reduction in the initial time it takes to render a scene layer.

Expanded support for offline traces

This release includes expanded support for tracing while disconnected from a utility network service. Water and gas utility networks can now use the isolation trace type and subnetwork-based traces (subnetwork, upstream, and downstream traces) on hierarchical networks. Aggregated geometry results are also supported while tracing offline, providing a more efficient way to visualize trace results in a map view or scene view.

Nearest neighbor filter

When tracing while connected to a feature service, the results of a nearest neighbor filter can also be accessed, allowing an app to determine if all of the requested neighbors were found.

More trace configuration options

Three new trace configuration options are supported when tracing in either connected or disconnected environments:

• UtilityTraceConfiguration::isAllowIndeterminateFlow()
• UtilityTraceConfiguration::isIncludeUpToFirstSpatialContainer()
• UtilityTraceConfiguration::isValidateLocatability()

Add trace conditions using categories

A new constructor for the UtilityCategoryComparison class makes it even easier to add trace conditions using utility network categories.

Examine network rules

Version 200.1 supports querying and inspecting utility network rules using the new UtilityNetworkDefinition::rules() method. Rules define what combinations of UtilityAssetTypes and UtilityTerminals can connect to, attach to, or contain other asset types and terminals, increasing the data integrity within the utility network.

Improved support for offline utility networks

The 200.1 release of the ArcGIS Maps SDKs for Native Apps now supports tracing of utility networks taken offline from an ArcGIS Enterprise 11.1 feature service when the recommended patches are installed to the Enterprise server. For more information, see the offline utility networks in ArcGIS Maps SDKs for Native Apps blog article.

Floor awareness map support

According to the ArcGIS Indoors Information Model, floor-aware maps and scenes require a LEVEL_ID for floor information. With this release of ArcGIS Maps SDKs for Native Apps, an IndoorsLocationDataSource outputs a LEVEL_ID value in addition to VERTICAL_ORDER, allowing developers to directly use the IndoorLocationDataSource output as an input to floor aware maps and scenes. To take advantage of this enhancement, the URL of the LEVEL table needs to be provided to the IndoorsLocationDataSource, without which only VERTICAL_ORDER will be output.

See ArcGIS Indoors Information Model in the ArcGIS Pro documentation for more information.

Enhanced path snapping

The path snapping algorithm in the IndoorLocationDataSource is improved in this release. The snapped position is now more accurate and more consistent with less jumping between adjacent pathways.

Labeling properties manual

A new guide topic helps map authors understand how ArcGIS Pro labeling properties are translated into ArcGIS Maps SDKs for Native Apps labeling properties.

Line orientation property for label definitions

A LabelDefinition::lineOrientation() property has been added to allow users to modify the placement of line labels to the Left or Right of the digitized line feature, rather than Above or Below the line feature.

ArcGIS Maps SDK for Local Server 200.1 is an incremental compatibility release that provides support for geoprocessing and map packages created with ArcGIS Pro 3.x

You can use version 200.1 of ArcGIS Maps SDK for Qt with ArcGIS Maps SDK for Local Server 200.1 or ArcGIS Runtime Local Server SDK 100.15.

To use a specific version of Local Server, set the install path for the Local Server using LocalServer::setInstallPath("c:/myLocalServerInstall");. Ensure the Local Server deployment directory is deployed to that location as part of the application installation. See the Deploy Local Server guide topic for more information.

There are no breaking changes in this release.

• GeometryEngine::nearestCoordinateGeodetic() does not support curve geometries. This method may produce incorrect results in previous releases when using geometry with true curves. This behavior is corrected in this release and the method now throws an ArcGISRuntimeException if the geometry parameter contains true curves. This behavior matches other GeometryEngine methods that do not support true curves. Support for using true curves with this method may be added in a future release.
• Read-only feature layers now have feature tiling enabled by default when the service supports it.
• Navigating a route using the route tracker when working with ArcGIS location services is now available with a Lite License. It also requires that you set the API Key with an access token that has the Routing privilege,

• Mouse press and hold events on a GeoView no longer emit a mouseClicked signal. The mouseClicked signal only emits when a mouse is pressed and released in less than 800 ms in the same location.

• Support for rendering 3D scenes on Android with OpenGL ES 3.0 and 3.1 is deprecated. The last release to support these versions is version 200.1. A minimum of OpenGL ES 3.2 will be required at the next release for rendering 3D scenes on Android.

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

• Last release to support Qt 6.2 LTS. 6.5 LTS will be required at the next version.
• Last release to support Ubuntu 20. Ubuntu 22 will be required at the next version.
• Last release to support GCC 9. Next release will require GCC 10.
• Last release to support Xcode 12. Next release will require Xcode 14.2.
• Last release to support Android NDK r22b. Next release will require r25b.

Issues addressed in this release are listed below.

• The 3rd-party Libtiff library has been upgraded to 4.5.0.
• BUG-000153386 Fixed an issue where SubtypeFeatureLayers weren't honoring a map's reference scale.
• BUG-000153429: Label fails to display correctly in a Union multipart feature.
• BUG-000154742: Landscape image service fails to load with parsing error.
• BUG-000154811: Feature link annotation with a vertical display of labels stored in a mobile geodatabase is showing inconsistent behavior in ArcGIS Maps SDK for .NET.
• BUG-000155484 Fixed an issue loading SubtypeFeatureLayers when a feature service has label definitions.
• ENH-000099317/ENH-000099318: WMTS layers with dimensional data are now supported. The default dimension value is used if provided by the service. Otherwise, the first value listed is used.
• Question on Esri Community Offline packages with non-ASCII characters in the path cannot be opened and read.

• BUG-000171919: Creating offline replica with a full utility network incorrectly requires that all layers from the feature service are included.

• BUG-000171920: The OfflineMapTask can fail to create an offline replica when including a utility network.

Known issues or limitations for this release are listed below.

• BUG-000156949: Cannot deploy QML ArcGIS Plugin on iOS with Qt 6.3 or later.
• A utility network that is configured with the "only include simple features" option cannot be loaded from an ahead-of-time offline map. To create a map with a loadable utility network use one of the other two offline utility network options.

• BUG-000126062 Local Server fails to create a local map service with a Mobile Map Package (MPK) file that contains a space character in the name.
• Geoprocessing tool Consolidate Locator (Data Management) is not supported with ArcGIS Maps SDK for Local Server.

New samples

• Add dynamic entity layer

Enhancements

• Ported Display scenes in tabletop AR to 200.1 and Qt 6

• Ported Explore scenes in flyover AR to 200.1 and Qt 6

• Refactored numerous feature layer sample variations into one called Display feature layers

• Refactored numerous samples to use the more modern C++ approach of subclassing QObject instead of QQuickItem:

  • Distance measurement analysis
  • Add graphics with renderer
  • Add features (feature service)
  • Feature layer selection
  • Buffer
  • Display map
  • Display a scene

• Updated usage of deprecated MouseEvent.pos across all samples to MouseEvent.position.