Merge pull request #291154 from stevemunk/visual-bi-ref-layer

JamesJBarnett · web-flow · commit 6d8bd1bb4f9f · 2024-11-27T13:38:27.000-07:00
Fixed capitalization and grammar related issues.
diff --git a/articles/azure-maps/power-bi-visual-add-path-layer.md b/articles/azure-maps/power-bi-visual-add-path-layer.md
@@ -1,30 +1,30 @@
 ---
-title: Path Layer in an Azure Maps Power BI visual
+title: The path layer in 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.date: 11/27/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 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 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:
+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
+## 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].
+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                                |
 |-------------------|--------------------------------------------|
@@ -35,7 +35,7 @@ This section describes how to add data and configure the Path Layer. Before star
 | 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
+### Add data to the path layer
 
 To draw paths, provide data for "Path ID" and "Point Order":
 
@@ -44,38 +44,38 @@ To draw paths, provide data for "Path ID" and "Point Order":
 
     :::image type="content" source="media/power-bi-visual/path-layer.png" alt-text="A screenshot showing the path layer properties.":::
 
-### Configure a Path Layer
+### 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 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.
+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
+### Interact with a path layer
 
-The Path Layer feature offers several interactive options:
+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.
+- **Hover and Select**: Hover over a path to select points; clicking on a path selects the nearest point. The selected point also selects 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
+### 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.
+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
+#### 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:
+Adding a field to the legend field well creates a higher level of grouping. So, 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".
+- **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.
+- **Interaction by Legend**: When interacting with the path layer, selecting a path or point also selects other reports based on legend, path ID, location, and point order. This ensures all related data points are highlighted together.
 
-#### Handle Origin-Destination Data
+#### 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:
+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: 
@@ -96,7 +96,7 @@ To use origin-destination data in the Path Layer, you must first transform it, a
         #"Replaced Values" 
     ```
 
-**Before Transformation**
+**Before transformation**
 
 | origin    | destination   |
 |-----------|---------------|
@@ -106,7 +106,7 @@ To use origin-destination data in the Path Layer, you must first transform it, a
 | Seattle   | Denver        |
 | Boston    | San Francisco |
 
-**After Transformation**
+**After transformation**
 
 | path_id  | point_order  | city          |
 |----------|--------------|---------------|
@@ -124,12 +124,12 @@ To use origin-destination data in the Path Layer, you must first transform it, a
 ## 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.
+- The data-bound reference layer isn't 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.
+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
diff --git a/articles/azure-maps/power-bi-visual-add-reference-layer.md b/articles/azure-maps/power-bi-visual-add-reference-layer.md
@@ -4,7 +4,7 @@ titleSuffix: Microsoft Azure Maps Power BI visual
 description: This article describes how to use the reference layer in Azure Maps Power BI visual.
 author: deniseatmicrosoft
 ms.author: limingchen
-ms.date: 07/10/2024
+ms.date: 11/27/2024
 ms.topic: how-to
 ms.service: azure-maps
 ms.subservice: power-bi-visual
@@ -115,7 +115,7 @@ The _Custom style for reference layer via format pane_ feature in Azure Maps ena
 
 :::image type="content" source="./media/power-bi-visual/custom-style-for-reference-layer-via-format-pane.png" alt-text="A map displaying the custom style for reference layer via format pane feature.":::
 
-### Enabling Custom Styles
+### Enabling custom styles
 
 To use the custom styling options for reference layers, follow these steps:
 
@@ -126,14 +126,14 @@ To use the custom styling options for reference layers, follow these steps:
 > [!NOTE]
 > If your geospatial files (GeoJSON, KML) include predefined style properties, Power BI will utilize those styles rather than the settings configured in the format pane. Make sure your files are styled according to your requirements before uploading if you intend to use custom properties defined within them.
 
-### Style Configuration
+### Style configuration
 
 | Setting name        | Description                                          | Setting values                                                       |
 |---------------------|------------------------------------------------------|----------------------------------------------------------------------|
-| Fill Colors         | Fill color of points and polygons.                   | Set colors for different data category or gradient for numeric data. |
-| Border Color        | The color of the points, lines, and polygons outline.| Color picker                                                         |
-| Border width        | The width of the border in pixels. Default: 3 px     | Width 1-10 pixels                                                    |
-| Border transparency |  The transparency of the borders. Default: 0%        | Transparency 0-100%                                                  |
+| Fill colors         | Fill color of points and polygons.                   | Set colors for different data category or gradient for numeric data. |
+| Border color        | The color of the points, lines, and polygons outline.| Color picker                                                         |
+| Border width        | The width of the border in pixels. Default: 3 px     | Width 1-20 pixels                                                    |
+| Border transparency | The transparency of the borders. Default: 0%         | Transparency 0-100%                                                  |
 
 The **Points** section of the format visual pane:
 
@@ -143,23 +143,23 @@ The **Lines** section of the format visual pane:
 
 :::image type="content" source="./media/power-bi-visual/lines.png" alt-text="A screenshot displaying the lines section of the format visual pane.":::
 
-The **polygons** section of the format visual pane:
+The **Polygons** section of the format visual pane:
 
 :::image type="content" source="./media/power-bi-visual/polygons.png" alt-text="A screenshot displaying the polygons section of the format visual pane.":::
 
-## Data-Bound Reference Layer
+## Data-bound reference layer
 
-The Data-Bound Reference Layer enables the association of data with specific shapes in the reference layer based on common attributes.
+The data-bound reference layer enables the association of data with specific shapes in the reference layer based on common attributes.
 
-To use the Data-Bound Reference layer, drag the column containing unique identifiers (can be location data or not) to the Location field of the Azure Maps Visual.
+To use the data-bound reference layer, drag the column containing unique identifiers (can be location data or not) to the Location field of the Azure Maps visual.
 
 :::image type="content" source="media/power-bi-visual/data-bound-reference-layer/location-field.png" alt-text="A screenshot showing the location field in Power BI desktop.":::
 
 Azure Maps matches these identifiers with the corresponding properties in the uploaded spatial file, automatically linking your data to the shapes on the map.
 
 In scenarios with multiple properties, Azure Maps identifies a common property in each shape and compares its value with the selected data column in the Location field. It then uses the property that has the highest number of matches with the selected data column.
 
-:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer.png"  lightbox="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer.png" alt-text="A screenshot showing the Data-Bound Reference Layer example in Power BI desktop.":::
+:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer.png"  lightbox="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer.png" alt-text="A screenshot showing the data-bound reference layer example in Power BI desktop.":::
 
 If one or more shapes in the reference layer can't be automatically mapped to any data point, you can manage these unmapped objects by following these steps:
 
@@ -170,7 +170,7 @@ If one or more shapes in the reference layer can't be automatically mapped to an
 
 Optionally, select the **Use custom colors** toggle switch to toggle On/Off custom fill and border colors for unmapped objects to make them visually distinct on the map.
 
-:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer-unmapped-objects.png" lightbox="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer-unmapped-objects.png" alt-text="A screenshot showing the Data-Bound Reference Layer example in Power BI desktop with unmapped objects showing in a different color.":::
+:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer-unmapped-objects.png" lightbox="media/power-bi-visual/data-bound-reference-layer/data-bound-reference-layer-unmapped-objects.png" alt-text="A screenshot showing the data-bound reference layer example in Power BI desktop with unmapped objects showing in a different color.":::
 
 <!----------------------------------------------------------------------------
 ### Key matching example
@@ -260,11 +260,11 @@ Note that there is a property “id” also has “Office x” values that is no
 
 ---------------------------------------------------------------------------------------------------------------------------->
 
-## Conditional Formatting
+## Conditional formatting
 
 Conditional formatting can be applied to data to dynamically change the appearance of shapes on a map based on the provided data. For instance, gradient colors can visualize various data values such as population density, sales performance, or other metrics. This is a powerful tool for combining spatial and business data to create interactive and visually compelling reports.
 
-:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/conditional-formatting.png" alt-text="A screenshot showing the Conditional Formatting controls for points, lines, polygons, and unmanaged objects in the reference layer control in Power BI desktop.":::
+:::image type="content" source="media/power-bi-visual/data-bound-reference-layer/conditional-formatting.png" alt-text="A screenshot showing the conditional formatting controls for points, lines, polygons, and unmanaged objects in the reference layer control in Power BI desktop.":::
 
 There are several ways to set colors to the shapes. The following table shows the priorities used:
 
@@ -281,7 +281,7 @@ There are several ways to set colors to the shapes. The following table shows th
 >
 > The Azure Maps Power BI Visual can only perform geocoding on valid location data such as geographical coordinates, addresses, or place names. If no valid location data is uploaded, data layers that depend on geocoded locations, such as heat maps or bubble layers, won’t display on the map.
 >
-> The Data-Bound Reference Layer will appear on the map as long as the data column contains unique identifiers that match properties in the spatial file, but to ensure correct results, your data column must include valid geographic information.
+> The data-bound reference layer will appear on the map as long as the data column contains unique identifiers that match properties in the spatial file, but to ensure correct results, your data column must include valid geographic information.
 
 ## Next steps
 
