Merge pull request #218318 from stevemunk/SM-AzureMaps-Visuals-ShowLabels

Azure maps visuals show labels

Author: jborsecnik

articles/azure-maps/media/power-bi-visual/show-labels-off.png

@@ -1,7 +1,7 @@
 ---
 title: Get started with Azure Maps Power BI visual
 titleSuffix: Microsoft Azure Maps
-description: In this article, you will learn how to use Azure Maps Power BI visual.
+description: In this article, you'll learn how to use Azure Maps Power BI visual.
 author: stevemunk
 ms.author: v-munksteve
 ms.date: 11/29/2021
@@ -19,9 +19,9 @@ This article shows how to use the Microsoft Azure Maps Power BI visual.
 > [!NOTE]
 > This visual can be created and viewed in both Power BI Desktop and the Power BI service. The steps and illustrations in this article are from Power BI Desktop.
 
-The Azure Maps Power BI visual provides a rich set of data visualizations for spatial data on top of a map. It is estimated that over 80% of business data has a location context. The Azure Maps Power BI visual can be used to gain insights into how this location context relates to and influences your business data.
+The Azure Maps Power BI visual provides a rich set of data visualizations for spatial data on top of a map. It's estimated that over 80% of business data has a location context. The Azure Maps Power BI visual can be used to gain insights into how this location context relates to and influences your business data.
 
-![Power BI desktop with the Azure Maps Power BI visual displaying business data](media/power-bi-visual/azure-maps-visual-hero.png)
+:::image type="content" source="media/power-bi-visual/azure-maps-visual-hero.png" alt-text="A screenshot of Power BI desktop with the Azure Maps Power BI visual displaying business data." lightbox="media/power-bi-visual/azure-maps-visual-hero.png":::
 
 ## What is sent to Azure?
 
@@ -43,39 +43,45 @@ To learn more, about privacy and terms of use related to the Azure Maps Power BI
 
 There are a few considerations and requirements for the Azure Maps Power BI visual:
 
-- The Azure Maps Power BI visual must be enabled in Power BI Desktop. To enable Azure Maps Power BI visual, select **File** > **Options and Settings** > **Options** > **Preview features**, then select the **Azure Maps Visual** checkbox. If the Azure Maps visual is not available after enabling this setting, it's likely that a tenant admin switch in the Admin Portal needs to be enabled.
+- The Azure Maps Power BI visual must be enabled in Power BI Desktop. To enable Azure Maps Power BI visual, select **File** > **Options and Settings** > **Options** > **Preview features**, then select the **Azure Maps Visual** checkbox. If the Azure Maps visual isn't available after enabling this setting, it's likely that a tenant admin switch in the Admin Portal needs to be enabled.
 - The data set must have fields that contain **latitude** and **longitude** information.
 
 ## Use the Azure Maps Power BI visual
 
 Once the Azure Maps Power BI visual is enabled, select the **Azure Maps** icon from the **Visualizations** pane.
 
-:::image type="content" source="media/power-bi-visual/azure-maps-in-visualizations-pane.png" alt-text="Azure Maps visual button on the Visualizations pane.":::
+:::image type="content" source="media/power-bi-visual/azure-maps-in-visualizations-pane.png" alt-text="A screenshot the Azure Maps visual button on the Visualizations pane in of Power BI.":::
 
 Power BI creates an empty Azure Maps visual design canvas. While in preview, another disclaimer is displayed.
 
-:::image type="content" source="media/power-bi-visual/visual-initial-load.png" alt-text="Power BI desktop with the Azure Maps visual loaded in its initial state.":::
+:::image type="content" source="media/power-bi-visual/visual-initial-load.png" alt-text="A screenshot of Power BI desktop with the Azure Maps visual loaded in its initial state." lightbox="media/power-bi-visual/visual-initial-load.png":::
 
 Take the following steps to load the Azure Maps visual:
 
 1. In the **Fields** pane, drag data fields that contain latitude and longitude coordinate information into the **Latitude** and/or **Longitude** buckets. This is the minimal data needed to load the Azure Maps visual.
 
-    :::image type="content" source="media/power-bi-visual/bubble-layer.png" alt-text="Azure Maps visual displaying points as bubbles on the map after latitude and longitude fields provided.":::
+    :::image type="content" source="media/power-bi-visual/bubble-layer.png" alt-text="A screenshot of the Azure Maps visual displaying points as bubbles on the map after latitude and longitude fields are provided." lightbox="media/power-bi-visual/bubble-layer.png":::
 
 2. To color the data based on categorization, drag a categorical field into the **Legend** bucket of the **Fields** pane. In this example, we're using the **AdminDistrict** column (also known as state or province).  
 
-    :::image type="content" source="media/power-bi-visual/bubble-layer-with-legend-color.png" alt-text="Azure Maps visual displaying points as colored bubbles on the map after legend field provided.":::
+    :::image type="content" source="media/power-bi-visual/bubble-layer-with-legend-color.png" alt-text="A screenshot of the Azure Maps visual displaying points as colored bubbles on the map after legend field is provided." lightbox="media/power-bi-visual/bubble-layer-with-legend-color.png":::
 
     > [!NOTE]
     > The built-in legend control for Power BI does not currently appear in this preview.
 
 3. To scale the data relatively, drag a measure into the **Size** bucket of the **Fields** pane. In this example, we're using **Sales** column.  
 
-    :::image type="content" source="media/power-bi-visual/bubble-layer-with-legend-color-and-size.png" alt-text="Azure Maps visual displaying points as colored and scaled bubbles on the map after size field provided.":::
+    :::image type="content" source="media/power-bi-visual/bubble-layer-with-legend-color-and-size.png" alt-text="A screenshot of the Azure Maps visual displaying points as colored and scaled bubbles on the map demonstrating the size field." lightbox="media/power-bi-visual/bubble-layer-with-legend-color-and-size.png":::
 
 4. Use the options in the **Format** pane to customize how data is rendered. The following image is the same map as above, but with the bubble layers fill transparency option set to 50% and the high-contrast outline option enabled.  
 
-    :::image type="content" source="media/power-bi-visual/bubble-layer-styled.png" alt-text="Azure Maps visual displaying points as bubbles on the map with a custom style.":::
+    :::image type="content" source="media/power-bi-visual/bubble-layer-styled.png" alt-text="A screenshot of the Azure Maps visual displaying points as bubbles on the map with a custom style." lightbox="media/power-bi-visual/bubble-layer-styled.png":::
+
+5. You can also show or hide labels in the **Format** pane. The following two images show maps with the **Show labels** setting turned on and off:  
+
+    :::image type="content" source="media/power-bi-visual/show-labels-on.png" alt-text="A screenshot of the Azure Maps visual displaying a map with the show labels setting turned on in the style section of the format pane in Power BI." lightbox="media/power-bi-visual/show-labels-on.png":::
+
+    :::image type="content" source="media/power-bi-visual/show-labels-off.png" alt-text="A screenshot of the Azure Maps visual displaying a map with the show labels setting turned off in the style section of the format pane in Power BI." lightbox="media/power-bi-visual/show-labels-off.png":::
 
 ## Fields pane buckets
 
@@ -91,29 +97,44 @@ The following data buckets are available in the **Fields** pane of the Azure Map
 
 ## Map settings
 
-The **Map settings** section of the Format pane provide options for customizing how the map is displayed and reacts to updates.
+The **Map settings** section of the **Format** pane provide options for customizing how the map is displayed and reacts to updates.
+
+The **Map settings** section is divided into three subsections: [style](#style), [view](#view) and [controls](#controls).
+
+### Style
 
-| Setting             | Description  |
-|---------------------|--------------|
-| Auto zoom           | Automatically zooms the map into the data loaded through the **Fields** pane of the visual. As the data changes, the map will update its position accordingly. When the slider is in the **Off** position, more map view settings are displayed for the default map view. |
-| World wrap          | Allows the user to pan the map horizontally infinitely. |
-| Style picker        | Adds a button to the map that allows the report readers to change the style of the map. |
-| Navigation controls | Adds buttons to the map as another method to allow the report readers to zoom, rotate, and change the pitch of the map. See this document on [Navigating the map](map-accessibility.md#navigating-the-map) for details on all the different ways users can navigate the map. |
-| Map style           | The style of the map. See the [supported map styles](supported-map-styles.md) document for more information. |
-| Selection control   | Adds a button that allows the user to choose between different modes to select data on the map; circle, rectangle, polygon (lasso), or travel time or distance. When drawing a polygon, to complete the drawing; click on the first point, or double-click the map on the last point, or press the `c` key. |
+The following settings are available in the **Style** section:
 
-### Map view settings
+| Setting     | Description  |
+|-------------|--------------|
+| Style       | The style of the map. The dropdown list contains [greyscale light][gs-light], [greyscale dark][gs-dark], [night][night], [road shaded relief][RSR], [satellite][satellite] and [satellite road labels][satellite RL]. |
+| Show labels | A toggle switch that enables you to either show or hide map labels. For more information, see list item number five in the previous section. |
 
-If the **Auto zoom** slider is in the **Off** position, the following settings are displayed and allow the user to specify the default map view information.
+### View
+
+The following settings available in the **View** section enable the user to specify the default map view information when the **Auto zoom** setting is set to **Off**.
 
 | Setting          | Description   |
 |------------------|---------------|
+| Auto zoom        | Automatically zooms the map into the data loaded through the **Fields** pane of the visual. As the data changes, the map will update its position accordingly. When **Auto zoom** is set to **Off**, the remaining settings in this section become active that enable to user to define the default map view. |
 | Zoom             | The default zoom level of the map. Can be a number between 0 and 22. |
-| Center latitude  | The default latitude at the center of the map. |
-| Center longitude | The default longitude at the center of the map. |
+| Center latitude  | The default latitude of the center of the map. |
+| Center longitude | The default longitude of the center of the map. |
 | Heading          | The default orientation of the map in degrees, where 0 is north, 90 is east, 180 is south, and 270 is west. Can be any number between 0 and 360. |
 | Pitch            | The default tilt of the map in degrees between 0 and 60, where 0 is looking straight down at the map. |
 
+### Controls
+
+The following settings are available in the **Controls** section:
+
+| Setting      | Description  |
+|--------------|--------------|
+| World wrap   | Allows the user to pan the map horizontally infinitely. |
+| Style picker | Adds a button to the map that allows the report readers to change the style of the map. |
+| Navigation   | Adds buttons to the map as another method to allow the report readers to zoom, rotate, and change the pitch of the map. See this document on [Navigating the map](map-accessibility.md#navigating-the-map) for details on all the different ways users can navigate the map. |
+| Selection    | Adds a button that allows the user to choose between different modes to select data on the map; circle, rectangle, polygon (lasso), or travel time or distance. To complete drawing a polygon; select the first point, or double-click on the last point on the map, or press the `c` key. |
+| Geocoding culture | The default, **Auto**, refers to the Western Address System. The only other option, **JA**, refers to the Japanese address system. In the western address system, you begin with the address details and then proceed to the larger categories such as city, state and postal code. In the Japanese address system, the larger categories are listed first and finish with the address details. |
+
 ## Considerations and Limitations
 
 The Azure Maps Power BI visual is available in the following services and applications:
@@ -129,7 +150,7 @@ The Azure Maps Power BI visual is available in the following services and applic
 
 **Where is Azure Maps available?**
 
-At this time, Azure Maps is currently available in all countries and regions except the following:
+At this time, Azure Maps is currently available in all countries and regions except:
 
 - China
 - South Korea
@@ -166,3 +187,10 @@ Customize the visual:
 
 > [!div class="nextstepaction"]
 > [Customize visualization titles, backgrounds, and legends](/power-bi/visuals/power-bi-visualization-customize-title-background-and-legend)
+
+[gs-light]: supported-map-styles.md#grayscale_light
+[gs-dark]: supported-map-styles.md#grayscale_dark
+[night]:supported-map-styles.md#night
+[RSR]: supported-map-styles.md#road_shaded_relief
+[satellite]: supported-map-styles.md#satellite
+[satellite RL]: supported-map-styles.md#satellite_road_labels