Merge branch 'main' into release-aio-ga-resolve-conflict

Author: dominicbetts

articles/azure-maps/media/power-bi-visual/path-layer-configuration.png

@@ -0,0 +1,135 @@
+---
+title: Path Layer in an Azure Maps Power BI visual
+titleSuffix: Microsoft Azure Maps Power BI visual
+description: This article describes the path layer in an Azure Maps Power BI visual.
+author: deniseatmicrosoft
+ms.author: limingchen
+ms.date: 11/11/2024
+ms.topic: how-to
+ms.service: azure-maps
+ms.subservice: power-bi-visual
+---
+
+# The Path Layer in Azure Maps Power BI visual 
+
+The Path Layer feature in the Azure Maps Power BI Visual enables the visualization of connections between multiple geographic points.
+
+The Path Layer feature can be used in multiple scenarios, such as:
+
+- **Route Visualization**: Showing vehicle, ship, or flight paths between locations.
+- **Network Analysis**: Examines connections between nodes in a network, like supply chain routes or communication networks.
+- **Movement Tracking**: Monitoring assets or individuals over time and space.
+
+This guide explains how to use this feature effectively.
+
+## Add a Path Layer
+
+This section describes how to add data and configure the Path Layer. Before starting, you need to open your Azure Maps Visual in Power BI. For more information on adding an Azure Maps Visual to your Power BI report, see [Use the Azure Maps Power BI visual].
+
+| Setting           | Description                                |
+|-------------------|--------------------------------------------|
+| Apply Settings to | Path you want the settings to apply to     |
+| Color             | The color of the line                      |
+| Transparency      | The transparency of the line               |
+| Width             | The width of the line                      |
+| Maximum Zoom      | Maximum zoom level the layer is visible at |
+| Minimum Zoom      | Minimum zoom level the layer is visible at |
+
+### Add Data to the Path Layer
+
+To draw paths, provide data for "Path ID" and "Point Order":
+
+1. Add the column that best identifies each path to the **Path ID** field. The Path ID is used to identify which line each geospatial data point belongs to. If there are multiple paths, each path requires a unique Path ID.
+1. Add the column that specifies the order of points along the path to the **Point Order** field. The Point Order dictates the sequence of points to form a path.
+
+    :::image type="content" source="media/power-bi-visual/path-layer.png" alt-text="A screenshot showing the path layer properties.":::
+
+### Configure a Path Layer
+
+After adding your data, you can adjust the Path Layer's color, line width, and opacity. Apply settings by legend or path ID, coloring paths, and locations with the same legend identically.
+
+After adding your data, you can configure the Path Layer according to your requirements. The style of the paths can be customized by adjusting the line color, width, and opacity. These settings can be applied based on legend or path ID. If a legend is provided, paths and locations associated with the same legend share the same color.
+
+:::image type="content" source="media/power-bi-visual/path-layer-configuration.png" alt-text="A screenshot showing the path layer configuration properties, including line color, transparency, and width as well as minimum and maximum zoom.":::
+
+### Interact with a Path Layer
+
+The Path Layer feature offers several interactive options:
+
+- **Hover and Select**: Hover over a path to select points; clicking on a path selects the nearest point. The selected point will also select other reports by legend, path ID, location, and point order.
+- **Tooltips**: Tooltips show information for the nearest point when hovering over a line.
+
+    :::image type="content" source="media/power-bi-visual/path-layer-map.png" alt-text="A screenshot showing a map using the path layer.":::
+
+### Explore and customize a Path Layer
+
+Examine the connections and insights revealed by the Path Layer visualization. Further customize the settings to suit your specific requirements and derive more profound insights from your geospatial data.
+
+#### Legends in a Path Layer
+
+Adding a field to the legend field well creates a higher level of grouping. Consequently, paths and locations associated with the same legend are colored identically. Here's the process:
+
+- **Grouping by Legend**: When a legend is provided, the paths and locations are grouped based on the legend. For instance, if visualizing flight paths with the airline as the legend, all paths and locations associated with the same airline share the same color. Moreover, if there are two rows, one with legend "Contoso" and path ID "A123", and another with legend "MSAirline" and path ID "A123", the Path Layer interprets these as two distinct paths: "Contoso-A123" and "MSAirline-A123".
+- **Styling by Legend**: Configure the style (color, line width, opacity) using the legend to visually differentiate path groups.
+- **Interaction by Legend**: When interacting with the Path Layer, selecting a path or point will also select other reports based on legend, path ID, location, and point order. This ensures all related data points are highlighted together.
+
+#### Handle Origin-Destination Data
+
+To use origin-destination data in the Path Layer, you must first transform it, as Azure Maps Visual doesn't directly support such data. Use the [Unpivot function in Power Query] to do this. Here’s how:
+
+1. **Import Data**: Import your origin-destination data into Power BI.
+1. **Apply Unpivot Function**: Use the following Power Query to transform the data: 
+
+    ```C#
+    let 
+        // Importing the source. 
+        Source = … 
+        // Create "path_id" to set in the "Path ID" field well later in the visual. 
+        // Since each row represents a line here, we can simply use the row index as path ID 
+        #"Added Index" = Table.AddIndexColumn(Source, "path_id", 0, 1, Int64.Type), 
+        // This is the key point of the transformation. 
+        // We transform the original rows into two: one for the origin and one for the destination.  
+        #"Unpivoted Other Columns" = Table.UnpivotOtherColumns(#"Added Index", {"path_id"}, "point_order", "city"), 
+        // We only support timestamp and number for the point order. So, convert the "origin" as 0 and "destination" as 1 
+        #"Replaced Values" = Table.ReplaceValue(Table.ReplaceValue(#"Unpivoted Other Columns", "origin", "0", Replacer.ReplaceText, {"point_order"}), "destination", "1", Replacer.ReplaceText, {"point_order"}) 
+    in 
+        #"Replaced Values" 
+    ```
+
+**Before Transformation**
+
+| origin    | destination   |
+|-----------|---------------|
+| New York  | Los Angeles   |
+| Chicago   | Houston       |
+| Miami     | Atlanta       |
+| Seattle   | Denver        |
+| Boston    | San Francisco |
+
+**After Transformation**
+
+| path_id  | point_order  | city          |
+|----------|--------------|---------------|
+| 0        | 0            | New York      |
+| 0        | 1            | Los Angeles   |
+| 1        | 0            | Chicago       |
+| 1        | 1            | Houston       |
+| 2        | 0            | Miami         |
+| 2        | 1            | Atlanta       |
+| 3        | 0            | Seattle       |
+| 3        | 1            | Denver        |
+| 4        | 0            | Boston        |
+| 4        | 1            | San Francisco |
+
+## Current limitations
+
+- The path layer is only compatible with specific map data layers, including the Bubble, Reference, Traffic, and Tile layers.
+- The data-bound reference layer is not available when the path layer is enabled.
+- Location hierarchy (drill down) is disabled when a Path ID is provided.
+
+## Conclusion
+
+The Path Layer feature in Azure Maps Visual is a tool for visualizing and analyzing spatial connections. This new capability can be utilized to enhance reports.
+
+[Use the Azure Maps Power BI visual]: power-bi-visual-get-started.md#use-the-azure-maps-power-bi-visual
+[Unpivot function in Power Query]: /power-query/unpivot-column

articles/azure-maps/media/power-bi-visual/path-layer-map.png

@@ -14,21 +14,27 @@ ms.subservice: web-sdk
 
 This document contains information about new features and other changes to the Azure Maps Drawing Tools Module.
 
+## [1.0.5] (CDN: November 4, 2024, npm: TBA)
+
+### Bug fixes
+
+- Fix an issue where DrawingManager would create an empty layer when source options were provided.
+
 ## [1.0.4] (Aug 8, 2024)
 
-### Bug fixes (1.0.4)
+### Bug fixes
 
 - Fix source not synced in DrawingManager after a style change.
 
 ## [1.0.3]
 
-### Other changes (1.0.3)
+### Other changes
 
 - Updated CDN links in the readme.
 
 ## [1.0.2]
 
-### Bug fixes (1.0.2)
+### Bug fixes
 
 - Resolved various errors in the type declaration file.
 

articles/azure-maps/media/power-bi-visual/path-layer.png

@@ -16,6 +16,14 @@ This document contains information about new features and other changes to the M
 
 ## v3 (latest)
 
+### [3.5.0] (CDN: November 4, 2024, npm: TBA)
+
+#### New features
+- Add support for fullscreen control.
+
+#### Bug fixes
+- Expose new type on `PolygonExtrusionLayerOptions.fillPattern` to support `DataDrivenPropertyValueSpecification<string>`.
+
 ### [3.4.0] (CDN: September 30, 2024, npm: October 2)
 
 #### New features

articles/azure-maps/power-bi-visual-add-path-layer.md

@@ -415,6 +415,8 @@ items:
       href: power-bi-visual-add-reference-layer.md
     - name: Add a tile layer
       href: power-bi-visual-add-tile-layer.md
+    - name: Add a path layer
+      href: power-bi-visual-add-path-layer.md
     - name: Add a filled map
       href: power-bi-visual-filled-map.md
     - name: On-object interaction

articles/azure-maps/release-notes-drawing-tools-module.md

@@ -5,7 +5,7 @@ services: azure-netapp-files
 author: b-hchen
 ms.service: azure-netapp-files
 ms.topic: how-to
-ms.date: 10/24/2024
+ms.date: 11/01/2024
 ms.custom: references_regions
 ms.author: anfdocs
 ---
@@ -81,7 +81,7 @@ You can edit the network features option of existing volumes from *Basic* to *St
 
 * You should only use the edit network features option for an [application volume group for SAP HANA](application-volume-group-introduction.md) if you have enrolled in the [extension one preview](application-volume-group-introduction.md#extension-1-features), which adds support for Standard network features. 
 * If you enabled both the `ANFStdToBasicNetworkFeaturesRevert` and `ANFBasicToStdNetworkFeaturesUpgrade` AFECs and are using 1 or 2-TiB capacity pools, see [Resize a capacity pool or a volume](azure-netapp-files-resize-capacity-pools-or-volumes.md) for information about sizing your capacity pools. 
-* <a name="no-downtime"></a> Azure NetApp Files supports a non-disruptive upgrade to Standard network features and a revert to Basic network features. This operation is expected to take at least 25 minutes. You can't create a regular or data protection volume or application volume group while the edit network feature operation is underway. This feature is currently in **preview** in the Australia East, Central India, North Central US, and Switzerland North regions. In all other regions, updating network features can cause a network disruption on the volumes for up to 5 minutes. 
+* <a name="no-downtime"></a> Azure NetApp Files supports a non-disruptive upgrade to Standard network features and a revert to Basic network features. This operation is expected to take at least 25 minutes. You can't create a regular or data protection volume or application volume group while the edit network feature operation is underway. This feature is currently in **preview** in the Australia East, Central India, East Asia, North Central US, and Switzerland North regions. In all other regions, updating network features can cause a network disruption on the volumes for up to 5 minutes. 
 
 > [!NOTE]
 > You need to submit a waitlist request for accessing the feature through the **[Azure NetApp Files standard networking features (edit volumes) Request Form](https://aka.ms/anfeditnetworkfeaturespreview)**. The feature can take approximately one week to be enabled after you submit the waitlist request. You can check the status of feature registration by using the following command: 

articles/azure-maps/release-notes-map-control.md

@@ -20,7 +20,7 @@ Azure NetApp Files is updated regularly. This article provides a summary about t
 
     Azure NetApp Files now supports the ability to edit network features (that is, upgrade from Basic to Standard network features) with no downtime for Azure NetApp Files volumes. Standard Network Features provide you with an enhanced virtual networking experience for a seamless and consistent experience along with security posture for Azure NetApp Files. 
 
-    This feature is currently in preview in the Australia East, Central India, North Central US, and Switzerland North regions. 
+    This feature is currently in preview in the Australia East, Central India, East Asia, North Central US, and Switzerland North regions. 
 
 ## September 2024 
 

articles/azure-maps/toc.yml

@@ -100,7 +100,7 @@ Also, as part of the backup and restore operations, the following roles are assi
 | Reader                         | Backup vault       | Snapshot resource group | Allows the Backup vault to perform _List_ and _Read_ operations on snapshot resource group. |
 | Contributor                    | AKS cluster        | Snapshot resource group | Allows AKS cluster to store persistent volume snapshots in the resource group.              |
 | Storage Blob Data Contributor    | Extension Identity | Storage account         | Allows Backup Extension to store cluster resource backups in the blob container.            |
-| Data Operator for Managed Disk | Backup vault       | Snapshot Resource Group | Allows Backup Vault service to move incremental snapshot data to the Vault.                  |
+| Data Operator for Managed Disks | Backup vault       | Snapshot Resource Group | Allows Backup Vault service to move incremental snapshot data to the Vault.                  |
 | Disk Snapshot Contributor      | Backup vault       | Snapshot Resource Group | Allows Backup Vault to access Disks snapshots and perform Vaulting operation.                |
 | Storage Blob Data Reader       | Backup vault       | Storage Account         | Allow Backup Vault to access Blob Container with backup data stored to move to Vault.        |
 | Contributor                    | Backup vault       | Staging Resource Group  | Allows Backup Vault to hydrate backups as Disks stored in Vault Tier.                        |