Acrolinx

Author: stevemunk

articles/azure-maps/power-bi-visual-geocode.md

@@ -1,10 +1,10 @@
 ---
 title: Geocoding in Azure Maps Power BI visual
 titleSuffix: Microsoft Azure Maps
-description: In this article, you will learn about geocoding in Azure Maps Power BI visual.
+description: In this article, you'll learn about geocoding in Azure Maps Power BI visual.
 author: stevemunk
 ms.author: v-munksteve
-ms.date: 11/29/2021
+ms.date: 03/15/2022
 ms.topic: conceptual
 ms.service: azure-maps
 services: azure-maps
@@ -16,31 +16,31 @@ Azure Maps uses the latitude and longitude coordinate system to locate places on
 
 The Azure Maps Power BI Visual now provides a **Location** field that accepts address values that can be used to pinpoint a location on the map using geocoding.
 
-Geocoding is the process of taking an address and returning the corresponding latitude/longitude coordinate. The address provided determines the granularity it is possible to geocode, such as a city as opposed to a specific street address.
+Geocoding is the process of taking an address and returning the corresponding latitude/longitude coordinate. The address provided determines the granularity it's possible to geocode, such as a city as opposed to a specific street address.
 
 :::image type="content" source="media/power-bi-visual/geocode.png" alt-text="A screenshot showing the Visualizations and fields panes in Power BI desktop with the Azure Maps visual location field highlighted.":::
 
 ## The location field
 
-The **Location** field in the Azure Maps Power BI Visual can accept multiple values, such as country, region, state, city, street address and zip code. By providing multiple sources of location information in the **Location** field you help to guarantee more accurate results and eliminate ambiguity that would prevent a specific location to be determined. For example, there are over twenty different cities in the United States named *Franklin* as well as at least two in Australia and one in Canada.
+The **Location** field in the Azure Maps Power BI Visual can accept multiple values, such as country, region, state, city, street address and zip code. By providing multiple sources of location information in the **Location** field you help to guarantee more accurate results and eliminate ambiguity that would prevent a specific location to be determined. For example, there are over 20 different cities in the United States named *Franklin*.
 
-## Use geo-hierarchies to drill down
+## Use geo-hierarchies to drill-down
 
-When entering multiple values into the **Location** field you create a geo-hierarchy. Geo-hierarchies enable the hierarchical drill down features in the map, allowing you to drill down to different "levels" of location.
+When entering multiple values into the **Location** field, you create a geo-hierarchy. Geo-hierarchies enable the hierarchical drill-down features in the map, allowing you to drill-down to different "levels" of location.
 
-:::image type="content" source="media/power-bi-visual/drill-down.png" alt-text="A screenshot showing the Visualizations and fields panes in Power BI desktop with the Azure Maps visual location field highlighted.":::
+:::image type="content" source="media/power-bi-visual/drill-down-buttons.png" alt-text="A screenshot showing the Visualizations and fields panes in Power BI desktop with the Azure Maps visual location field highlighted.":::
 
 | Button  | Description |
 |:-:|-------------------------------------------------------------------------------------------|
-| 1 | The drill button on the far right, called Drill Mode, allows you to select a map Location and drill down into that specific location one level at a time. For example, if you turn on the drill-down option and select North America, you move down in the hierarchy to the next level -- states in North America. For geocoding, Power BI sends Azure Maps country and state data for North America only. The button on the left goes back up one level. |
-| 2 | The double arrow drills to the next level of the hierarchy for all locations at once. For example, if you are currently looking at countries and then use this option to move to the next level, states, Power BI displays state data for all countries. For geocoding, Power BI sends Azure Maps state data (no country data) for all locations. This option is useful if each level of your hierarchy is unrelated to the level above it. |
-| 3 | This is similar to the drill-down option, except that you don't need to click on the map. It expands down to the next level of the hierarchy remembering the current level's context. For example, if you are currently looking at countries and select this icon, you move down in the hierarchy to the next level -- states. For geocoding, Power BI sends data for each state and its corresponding country to help Azure Maps geocode more accurately. In most maps, you will either use this option or the drill down option on the far right, so you can send Azure as much information as possible to get accurate location information. |
+| 1 | The drill button on the far right, called Drill Mode, allows you to select a map Location and drill-down into that specific location one level at a time. For example, if you turn on the drill-down option and select North America, you move down in the hierarchy to the next level--states in North America. For geocoding, Power BI sends Azure Maps country and state data for North America only. The button on the left goes back up one level. |
+| 2 | The double arrow drills to the next level of the hierarchy for all locations at once. For example, if you're currently looking at countries and then use this option to move to the next level, states, Power BI displays state data for all countries. For geocoding, Power BI sends Azure Maps state data (no country data) for all locations. This option is useful if each level of your hierarchy is unrelated to the level above it. |
+| 3 | This is similar to the drill-down option, except that you don't need to click on the map. It expands down to the next level of the hierarchy remembering the current level's context. For example, if you're currently looking at countries and select this icon, you move down in the hierarchy to the next level--states. For geocoding, Power BI sends data for each state and its corresponding country to help Azure Maps geocode more accurately. In most maps, you'll either use this option or the drill-down option on the far right. This will send Azure as much information as possible and result in more accurate location information. |
 
 ## Categorize geographic fields in Power BI
 
-To ensure fields are correctly geocoded, you can set the Data Category on the data fields in Power BI. In Data view, select the desired column. From the ribbon, select the Modeling tab and then set the Data Category to Address, City, Continent, Country/Region, County, Postal Code, **State, or Province. These data categories help Azure correctly encode the data. To learn more, see Data categorization in Power BI Desktop. If you are live connecting to SQL Server Analysis Services, you will need to set the data categorization outside of Power BI using SQL Server Data Tools (SSDT).
+To ensure fields are correctly geocoded, you can set the Data Category on the data fields in Power BI. In Data view, select the desired column. From the ribbon, select the Modeling tab and then set the Data Category to Address, City, Continent, Country, Region, County, Postal Code, State, or Province. These data categories help Azure correctly encode the data. To learn more, see [Data categorization in Power BI Desktop](/power-bi/transform-model/desktop-data-categorization). If you're live connecting to SQL Server Analysis Services, you'll need to set the data categorization outside of Power BI using [SQL Server Data Tools (SSDT)](/sql/ssdt/download-sql-server-data-tools-ssdt).
 
-:::image type="content" source="media/power-bi-visual/data-category.png" alt-text="A screenshot showing the data category drop down list in Power BI desktop.":::
+:::image type="content" source="media/power-bi-visual/data-category.png" alt-text="A screenshot showing the data category drop-down list in Power BI desktop.":::
 
 ## Next steps