Merge pull request #109870 from stevemunk/power-bi-conversion

Power BI Conversion

Author: ShannonLeavitt

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

@@ -0,0 +1,39 @@
+---
+title: Convert Map and Filled map visuals to an Azure Maps Visual 
+titleSuffix: Microsoft Azure Maps Power BI visual
+description: This article covers how to convert Map and Filled map visuals to an Azure Maps Visual.
+author: deniseatmicrosoft
+ms.author: limingchen 
+ms.date: 05/23/2023
+ms.topic: how-to
+ms.service: azure-maps
+services: azure-maps
+---
+
+# Convert Map and Filled map visuals to an Azure Maps Visual
+
+The Azure Maps Visual is now Generally Available, providing a streamlined and intuitive experience for working with your data.
+
+## How to convert your existing Map and Filled map visuals
+
+A conversion function is available in Power BI desktop to convert any existing Map and Filled map visuals to the new Azure Maps Visual.
+
+When opening a report with Map and Filled map visuals, you will see the following dialog giving you the option to upgrade to the new Azure Maps Visual:
+
+:::image type="content" source="media/power-bi-visual/introducing-azure-map-visual.png" alt-text="Screenshot showing the option to upgrade maps to the Azure Maps Visual.":::
+
+When selecting the **Upgrade maps** button, all Map and Filled map visuals in the current report are converted. You can also convert a specific Map or Filled Map Visual to an Azure Maps Visual in the Visual gallery.
+
+All settings associated with the original visuals are carried over to the new Azure Maps Visual, ensuring consistency in the migrated report.
+
+:::image type="content" source="media/power-bi-visual/the-new-azure-maps-visual.png" alt-text="Screenshot showing the Bubble chart Description automatically generated.":::
+
+> [!NOTE]
+> Due to differences in supported bubble size ranges between the two platforms, you may notice that some bubbles appear smaller on the converted Azure Maps visual compared to their original size in the Maps visual. This is because the maximum bubble size in Azure Maps is smaller than the maximum bubble size in Bing Maps. Bubble size differences can vary based on the visual dimension and the report's zoom level.
+
+The migration function streamlines the process of converting Map and Filled map visuals to Azure Maps Visuals, providing users with an efficient and easy-to-use solution.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Get started with Azure Maps Power BI visual](power-bi-visual-get-started.md)