new geocode article - power bi visual

Author: stevemunk

articles/azure-maps/media/power-bi-visual/data-category.png

@@ -0,0 +1,58 @@
+---
+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.
+author: stevemunk
+ms.author: v-munksteve
+ms.date: 11/29/2021
+ms.topic: conceptual
+ms.service: azure-maps
+services: azure-maps
+---
+
+# Geocoding in Azure Maps Power BI Visual
+
+Azure Maps uses the latitude and longitude coordinate system to locate places on the map. The Azure Maps Power BI Visual provides latitude and longitude fields that you can use to pinpoint a specific location on the map, however most data sources use an address to pinpoint a location as opposed to latitude and longitude values.
+
+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.
+
+:::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.
+
+## 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.
+
+:::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.":::
+
+| 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. |
+
+## 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).
+
+:::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
+
+Learn more about the Azure Maps Power BI visual:
+
+> [!div class="nextstepaction"]
+> [Get started with Azure Maps Power BI visual (Preview)](power-bi-visual-get-started.md)
+
+> [!div class="nextstepaction"]
+> [Understanding layers in the Azure Maps Power BI visual](power-bi-visual-understanding-layers.md)
+
+Learn about the Azure Maps Power BI visual Pie Chart layer that uses geocoding:
+
+> [!div class="nextstepaction"]
+> [Add a pie chart layer](power-bi-visual-add-pie-chart-layer.md)