Merge pull request #307243 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-22 17:00 UTC

Author: learn-build-service-prod[bot]

articles/azure-maps/about-azure-maps.md

@@ -32,6 +32,12 @@ The following video explains Azure Maps in depth:
 
 > [!VIDEO https://learn.microsoft.com/Shows/Internet-of-Things-Show/Azure-Maps/player?format=ny]
 
+## Maps in Microsoft Fabric
+
+Maps (preview) in [Microsoft Fabric] is a powerful geospatial visualization tool within Real-Time Intelligence that turns static and real-time spatial data into actionable insights by uncovering patterns and trends often missed in traditional charts. With an intuitive interface, you can create interactive maps featuring multiple layers, and rich customization options. Seamlessly integrated with other Fabric experiences and powered by Azure Maps services, it delivers accurate, scalable, and secure mapping for enterprise scenarios. Whether monitoring IoT devices, tracking assets, or analyzing regional trends, Maps helps you make sense of spatial data in real time. For more information, see [Create a map].
+
+:::image type="content" source="./media/about-azure-maps/intro-fabric-maps.png" lightbox="./media/about-azure-maps/intro-fabric-maps.png" alt-text="A screenshot showing Maps in Microsoft Fabric.":::
+
 ## Map controls
 
 ### Web SDK
@@ -78,7 +84,7 @@ For more information, see [Route] in the Azure Maps REST API documentation.
 
 ### Search service
 
-The Search service helps developers search for addresses, places, business listings by name or category, and other geographic information. Also, services can [reverse geocode] addresses and cross streets based on latitudes and longitudes.
+The Search service helps developers search for addresses, places, business listings by name or category, and other geographic information. Also, services can [reverse geocode] addresses and cross streets based on latitudes and longitudes. [Geocode Autocomplete] (preview) suggests location completions as you type, based on partial input and optional location context.
 
 :::image type="content" source="./media/about-azure-maps/intro_search.png" lightbox="./media/about-azure-maps/intro_search.png"  alt-text="Example of a search on a map.":::
 
@@ -142,7 +148,7 @@ For more information, see [Traffic] in the Azure Maps REST API documentation.
 
 ### Weather service
 
-The Weather service offers API to retrieve weather information for a particular location. This information includes observation date and time, weather conditions, precipitation indicator flags, temperature, and wind speed information. Other details such as RealFeel™ Temperature and UV index are also returned.
+The Weather service offers API to retrieve weather information for a particular location. This information includes observation date and time, weather conditions, precipitation indicator flags, temperature, and wind speed information. Other details such as RealFeel™ Temperature and UV index are also returned.
 
 Developers can use the [Get Weather along route API] to retrieve weather information along a particular route. Also, the service supports the generation of weather notifications for waypoints affected by weather hazards, such as flooding or heavy rain.
 
@@ -200,6 +206,7 @@ Stay up to date on Azure Maps:
 [Quickstart: Create a web app]: quick-demo-map-app.md
 
 <!---------   REST API Links     --------------->
+[Geocode Autocomplete]: /rest/api/maps/search/get-geocode-autocomplete
 [Geolocation]: /rest/api/maps/geolocation
 [Get Map Tile]: /rest/api/maps/render/get-map-tile
 [Get Weather along route API]: /rest/api/maps/weather/getweatheralongroute
@@ -211,8 +218,14 @@ Stay up to date on Azure Maps:
 [TilesetID]: /rest/api/maps/render/get-map-tile#tilesetid
 [Timezone]: /rest/api/maps/timezone
 [Traffic]: /rest/api/maps/traffic
+
 <!---------   JavaScript API Links     --------------->
 [JavaScript map control]: /javascript/api/azure-maps-control
+
+<!---------   Microsoft Fabric Maps Links     --------------->
+[Create a map]: /fabric/real-time-intelligence/map/create-map
+[Microsoft Fabric]: /fabric/fundamentals/microsoft-fabric-overview
+
 <!---------   External Links     --------------->
 [Azure Maps account]: https://azure.microsoft.com/services/azure-maps/
 [Azure Maps blog]: https://azure.microsoft.com/blog/topics/azure-maps/

articles/azure-maps/how-to-search-for-address.md

@@ -234,7 +234,9 @@ The example in this section uses [Get Geocoding] to convert an address into lati
 
 The [Get Geocode Autocomplete] API supports both single-line and free-form address inputs, making it ideal for scenarios where a complete address is unavailable. You can submit either a full or partial address as the query. To enhance the accuracy and relevance of the results, it's recommended to constrain the search by specifying coordinates or a bounding box.
 
-This example demonstrates how to use the Get Geocode Autocomplete API to search the entire North American continent for partial input like "university of w." It then shows how to narrow the search scope to a specific country or region using the `countryRegion` parameter. Finally, it demonstrates how to use the `coordinates` parameter to focus the search to a specific area.
+### Search for a place
+
+This example demonstrates how to use the Get Geocode Autocomplete API to search for a place in the entire North American continent for partial input like "university of w." It then shows how to narrow the search scope to a specific country or region using the `countryRegion` parameter. Finally, it demonstrates how to use the `coordinates` parameter to focus the search to a specific area.
 
 > [!IMPORTANT]
 > To geobias results to the relevant area for your users, always add as many location details as possible. For more information, see [Best Practices for Search].
@@ -306,6 +308,50 @@ Next, focus your search to include more results in a specific area within the de
     > - **University of West Florida** in Escambia County, Florida, USA
     > - **University of Wisconsin-Stout** in Menomonie, Dunn County, Wisconsin, USA
 
+### Search for an address
+
+The examples in this section demonstrate the difference between searching for a place and searching for an address using the `resultTypeGroups` parameter of the [Get Geocode Autocomplete] API, using examples that search for Disneyland in southern California using partial input like "dis" and the `coordinates` parameter to focus the search to a specific area.
+
+> [!IMPORTANT]
+> To geobias results to the relevant area for your users, always add as many location details as possible. For more information, see [Best Practices for Search].
+
+1. Open the [Bruno] application.
+
+1. Select **NEW REQUEST** to create the request. In the **NEW REQUEST** window, set **Type** to **HTTP**. Enter a **Name** for the request.
+
+1. Select the **GET** HTTP method in the **URL** drop-down list, then enter the following URL:
+
+    ```http
+    https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=dis&coordinates=-117.920219,33.809570&subscription-key={Your-Azure-Maps-Subscription-key}
+    ```
+
+1. Select the run button, then review the response body.
+
+    Notice that the response contains *place* values that include:
+
+    | Property name    | Property value                           |
+    |------------------|------------------------------------------|
+    | typeGroup        | Place                                    |
+    | type             | AmusementPark                            |
+    | name             | Disney California Adventure Park         |
+
+    > [!TIP]
+    > The `type` property is most relevant when using `resultTypeGroups=place`. To view available types, refer to the [Autocomplete ResultType Enum]. To define which types to search, use the `resultTypes` [URI parameter]. For implementation details, see the [Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups] example.
+
+1. When no values are provided for the `resultTypeGroups` parameter, queries can return both place and address values. If your only interested in searching for addresses, include `resultTypeGroups=address` in your request:
+
+    ```http
+    https://atlas.microsoft.com/geocode:autocomplete?api-version=2025-06-01-preview&query=dis&coordinates=-117.920219,33.809570&resultTypeGroups=address&subscription-key={Your-Azure-Maps-Subscription-key}
+    ```
+
+    Notice that the response contains *address* values that include:
+
+    | Property name    | Property value                               |
+    |------------------|----------------------------------------------|
+    | typeGroup        | Address                                      |
+    | streetName       | Disneyland                                   |
+    | formattedAddress | Disneyland, Anaheim, CA 92802, United States |
+
 ## Search for a street address using Get Reverse Geocoding
 
 [Get Reverse Geocoding] translates coordinates into human readable street addresses. This API is often used for applications that consume GPS feeds and want to discover addresses at specific coordinate points.
@@ -375,36 +421,39 @@ This example demonstrates how to search for a cross street based on the coordina
 > [!div class="nextstepaction"]
 > [Best practices for Azure Maps Search service]
 
-[Get Geocode Autocomplete]: /rest/api/maps/search/get-geocode-autocomplete
+[Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups]: /rest/api/maps/search/get-geocode-autocomplete?#autocomplete-api-call-to-search-for-'muir-woods',-filtered-by-park-and-populated-place-resulttypes,-place-resulttypegroups
+[Autocomplete ResultType Enum]: /rest/api/maps/search/get-geocode-autocomplete?#autocompleteresulttypeenum
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
+[Azure Maps geocoding coverage]: geocoding-coverage.md
 [Azure Maps Search service]: /rest/api/maps/search?view=rest-maps-1.0&preserve-view=true
 [Best practices for Azure Maps Search service]: how-to-use-best-practices-for-search.md
 [Best Practices for Search]: how-to-use-best-practices-for-search.md#geobiased-search-results
+[bruno]: https://www.usebruno.com/
 [Entity Types]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true#entitytype
 [Fuzzy Search URI Parameters]: /rest/api/maps/search/getsearchfuzzy?view=rest-maps-1.0&preserve-view=true#uri-parameters
 [Fuzzy Search]: /rest/api/maps/search/getsearchfuzzy?view=rest-maps-1.0&preserve-view=true
 [geobias]: glossary.md#geobias
-[Get Geocoding]: /rest/api/maps/search/get-geocoding
+[Get Geocode Autocomplete]: /rest/api/maps/search/get-geocode-autocomplete
 [Get Geocoding Batch]: /rest/api/maps/search/get-geocoding-batch
-[Get Reverse Geocoding]: /rest/api/maps/search/get-reverse-geocoding
-[Get Reverse Geocoding Parameters]: /rest/api/maps/search/get-reverse-geocoding#uri-parameters
+[Get Geocoding]: /rest/api/maps/search/get-geocoding
 [Get Reverse Geocoding Batch]: /rest/api/maps/search/get-reverse-geocoding-batch
+[Get Reverse Geocoding Parameters]: /rest/api/maps/search/get-reverse-geocoding#uri-parameters
+[Get Reverse Geocoding]: /rest/api/maps/search/get-reverse-geocoding
 [Get Search Address Reverse]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true
 [Get Search Address]: /rest/api/maps/search/getsearchaddress?view=rest-maps-1.0&preserve-view=true
 [point of interest]: /rest/api/maps/search/getsearchpoi?view=rest-maps-1.0&preserve-view=true#searchpoiresponse
 [Post Search Address Batch]: /rest/api/maps/search/postsearchaddressbatch
 [Post Search Address Reverse Batch]: /rest/api/maps/search/postsearchaddressreversebatch?view=rest-maps-1.0&preserve-view=true
-[bruno]: https://www.usebruno.com/
 [Reverse Address Search Results]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true#searchaddressreverseresult
 [Reverse Address Search]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true
 [Reverse Search Parameters]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true#uri-parameters
 [Road Use Types]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true#uri-parameters
 [Route]: /rest/api/maps/route
 [Search Address Reverse Cross Street]: /rest/api/maps/search/getsearchaddressreversecrossstreet?view=rest-maps-1.0&preserve-view=true
 [Search Address]: /rest/api/maps/search/getsearchaddress?view=rest-maps-1.0&preserve-view=true
-[Azure Maps geocoding coverage]: geocoding-coverage.md
 [Search Polygon API]: /rest/api/maps/search/getsearchpolygon?view=rest-maps-1.0&preserve-view=true
 [Search]: /rest/api/maps/search?view=rest-maps-1.0&preserve-view=true
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
 [URI Parameter reference]: /rest/api/maps/search/getsearchfuzzy?view=rest-maps-1.0&preserve-view=true#uri-parameters
+[URI parameter]: /rest/api/maps/search/get-geocode-autocomplete?##uri-parameters
 [Weather]: /rest/api/maps/weather

articles/azure-maps/media/about-azure-maps/intro-fabric-maps.png

@@ -1,25 +1,25 @@
 ---
-title: Bicep functions - any
-description: Describes the any function that is available in Bicep to convert types.
+title: Bicep functions - any()
+description: Describes the any() function that's available in Bicep to convert types.
 ms.topic: reference
 ms.custom: devx-track-bicep
-ms.date: 02/12/2025
+ms.date: 10/22/2025
 ---
 
-# Any function for Bicep
+# any() function (Bicep)
 
-Bicep supports a function called `any()` to resolve type errors in the Bicep type system. You use this function when the format of the value you provide doesn't match what the type system expects. For example, if the property requires a number but you need to provide it as a string, like `'0.5'`. Use the `any()` function to suppress the error reported by the type system.
+Bicep supports a function named `any()` that suppresses type check errors. Use the Bicep `any()` function to cast a value to a type that's compatible with any data type. For example, use the `any()` function when a property requires a number but you need to provide a string, like `'0.5'`.
 
-This function doesn't exist in the Azure Resource Manager template runtime. It's only used by Bicep and isn't emitted in the JSON for the built template.
+This function doesn't exist in the Azure Resource Manager template runtime. The Bicep `any()` function only affects compile-time type checking. It doesn't convert values at runtime and isn't emitted into the JSON for an Azure Resource Manager template.
 
 > [!NOTE]
 > To help resolve type errors, let us know when missing or incorrect types required you to use the `any()` function. Add your details to the [missing type validation/inaccuracies](https://github.com/Azure/bicep/issues/784) GitHub issue.
 
-## any
+## Syntax for the Bicep any() function
 
 `any(value)`
 
-Returns a value that is compatible with any data type.
+Returns a value that's compatible with any Bicep data type.
 
 Namespace: [sys](bicep-functions.md#namespaces-for-functions).
 
@@ -31,11 +31,11 @@ Namespace: [sys](bicep-functions.md#namespaces-for-functions).
 
 ### Return value
 
-The value in a form that is compatible with any data type.
+The value in a form that's compatible with any data type in Bicep.
 
 ### Examples
 
-The following example shows how to use the `any()` function to provide numeric values as strings.
+The following example shows how to use the Bicep `any()` function to provide numeric values as strings.
 
 ```bicep
 resource wpAci 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
@@ -60,7 +60,7 @@ resource wpAci 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
 }
 ```
 
-The function works on any assigned value in Bicep. The following example uses `any()` with a ternary expression as an argument.
+The function works on any assigned value in Bicep. The following example uses the Bicep `any()` function with a ternary expression as an argument.
 
 ```bicep
 publicIPAddress: any((pipId == '') ? null : {

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

@@ -27,10 +27,10 @@ To create or edit a Resource Health alert rule, you need:
 
 1. In the Azure portal, navigate to your AVS private cloud resource.  
 1. From the left menu, select **Help** → **Resource Health**.
-   :::image type="content" source="media/resource-health/resource-health-left-nav.png" alt-text="Screenshot showing where to find Resource Health for the AVS private cloud.":::
+   :::image type="content" source="media/resource-health/resource-health-left-nav.png" alt-text="Screenshot showing where to find Resource Health for the AVS private cloud." lightbox="media/resource-health/resource-health-left-nav.png":::
 
 1. Click **Add resource health alert**.
-   :::image type="content" source="media/resource-health/resource-health-create-alert.png" alt-text="Screenshot showing add resource health alert button.":::
+   :::image type="content" source="media/resource-health/resource-health-create-alert.png" alt-text="Screenshot showing add resource health alert button." lightbox="media/resource-health/resource-health-create-alert.png":::
 
 ### Define the alert condition
 
@@ -43,7 +43,7 @@ To create or edit a Resource Health alert rule, you need:
     | **Previous resource status** | (Optional) Select the previous resource status. Values are **Available**, **Degraded**, **Unavailable**, and **Unknown**.|
     | **Reason type**              | Select the causes of the resource health events. Values are **Platform Initiated**, **Unknown**, and **User Initiated**. |
 
-    :::image type="content" source="media/resource-health/resource-health-condition.png" alt-text="Screenshot showing condition tabs while creating alerts using Resource Health for the AVS private cloud.":::
+    :::image type="content" source="media/resource-health/resource-health-condition.png" alt-text="Screenshot showing condition tabs while creating alerts using Resource Health for the AVS private cloud." lightbox="media/resource-health/resource-health-condition.png":::
 
 ### Configure actions
 
@@ -54,7 +54,7 @@ To create or edit a Resource Health alert rule, you need:
 
    - Provide an **Action group name** and **Display name**  
 
-   :::image type="content" source="media/resource-health/resource-health-new-action-group.png" alt-text="Screenshot showing new action group creation wizard with basics tab.":::
+   :::image type="content" source="media/resource-health/resource-health-new-action-group.png" alt-text="Screenshot showing new action group creation wizard with basics tab." lightbox="media/resource-health/resource-health-new-action-group.png":::
 
    - Under **Notification type**, select channels (Email, SMS, Push, Voice) and add stakeholder contacts
    :::image type="content" source="media/resource-health/resource-health-action-group-notifications.png" alt-text="Screenshot showing new action group creation wizard with notifications tab." lightbox="media/resource-health/resource-health-action-group-notifications.png":::
@@ -68,11 +68,11 @@ To create or edit a Resource Health alert rule, you need:
    - Subscription and resource group for the rule
    - Ensure **Enable alert rule upon creation** is checked
 
-   :::image type="content" source="media/resource-health/resource-health-action-group-details.png" alt-text="Screenshot showing new action group creation wizard with details tab.":::
+   :::image type="content" source="media/resource-health/resource-health-action-group-details.png" alt-text="Screenshot showing new action group creation wizard with details tab." lightbox="media/resource-health/resource-health-action-group-details.png":::
 
 1. Click **Review + create**, then **Create**.
 
-   :::image type="content" source="media/resource-health/resource-health-alert-review-create.png" alt-text="Screenshot showing new alert rule creation wizard with review-create tab.":::
+   :::image type="content" source="media/resource-health/resource-health-alert-review-create.png" alt-text="Screenshot showing new alert rule creation wizard with review-create tab." lightbox="media/resource-health/resource-health-alert-review-create.png":::
 
 ## Manage alert rules