Merge pull request #284569 from stevemunk/postman-to-bruno-best-practices-for-routing-and-search

Update to reference bruno.

Author: prmerger-automator[bot]

articles/azure-maps/how-to-use-best-practices-for-routing.md

@@ -30,7 +30,7 @@ The Route Directions and Route Matrix APIs in Azure Maps [Route service] can be
 
 For more information about the coverage of the Route service, see [Routing Coverage].
 
-This article uses the [Postman] application to build REST calls, but you can choose any API development environment.
+You can use any API development environment such as [Postman] or [bruno] to run the HTTP request samples shown in this article or to build REST calls.
 
 ## Choose between Route Directions and Matrix Routing
 
@@ -47,7 +47,7 @@ Consider calling Matrix Routing API if your scenario is to:
 
 * Calculate the travel time or distance between a set of origins and destinations. For example, you have 12 drivers and you need to find the closest available driver to pick up the food delivery from the restaurant.
 * Sort potential routes by their actual travel distance or time. The Matrix API returns only travel times and distances for each origin and destination combination.
-* Cluster data based on travel time or distances. For example, your company has 50 employees, find all employees that live within 20 minute Drive Time from your office.
+* Cluster data based on travel time or distances. For example, your company has 50 employees, find all employees that live within 20 minute drive time from your office.
 
 Here's a comparison to show some capabilities of the Route Directions and Matrix APIs:
 
@@ -289,6 +289,7 @@ To learn more, please see:
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
 [Azure Maps npm Package]: https://www.npmjs.com/package/azure-maps-rest
 [Azure Maps Route service]: /rest/api/maps/route
+[bruno]: https://www.usebruno.com/
 [How to use the Service module]: how-to-use-services-module.md
 [Point of Interest]: /rest/api/maps/search/getsearchpoi?view=rest-maps-1.0&preserve-view=true
 [Post Route Directions API documentation]: /rest/api/maps/route/postroutedirections#supportingpoints

articles/azure-maps/how-to-use-best-practices-for-search.md

@@ -27,7 +27,7 @@ This article explains how to apply sound practices when you call data from Azure
 * An [Azure Maps account]
 * A [subscription key]
 
-This article uses the [Postman] application to build REST calls, but you can choose any API development environment.
+You can use any API development environment such as [Postman] or [bruno] to run the HTTP request samples shown in this article or to build REST calls.
 
 ## Best practices to geocode addresses
 
@@ -126,7 +126,6 @@ Use the `language` parameter to set the language for the returned search results
 
 For more information, see [Azure Maps supported languages].
 
-
 ### Use predictive mode (automatic suggestions)
 
 To find more matches for partial queries, set the `typeahead` parameter to `true`. This query is interpreted as a partial input, and the search enters predictive mode. If you don't set the `typeahead` parameter to `true`, then the service assumes that all relevant information has been passed in.
@@ -396,8 +395,7 @@ https://atlas.microsoft.com/search/address/json?subscription-key={Your-Azure-Map
 }
 ```
 
-
-### Encode a URI to handle special characters 
+### Encode a URI to handle special characters
 
 To find cross street addresses, you must encode the URI to handle special characters in the address. Consider this address example: *1st Avenue & Union Street, Seattle*. Here, encode the ampersand character (`&`) before you send the request.
 
@@ -738,7 +736,6 @@ https://atlas.microsoft.com/search/poi/json?subscription-key={Your-Azure-Maps-Su
 }
 ```
 
-
 ### Airport search
 
 By using the Search POI API, you can look for airports by using their official code. For example, you can use *SEA* to find the Seattle-Tacoma International Airport:
@@ -973,19 +970,19 @@ To learn more, please see:
 > [!div class="nextstepaction"]
 > [Search service API documentation](/rest/api/maps/search?view=rest-maps-1.0&preserve-view=true)
 
-[Search service]: /rest/api/maps/search?view=rest-maps-1.0&preserve-view=true
-[Search Fuzzy]: /rest/api/maps/search/getsearchfuzzy?view=rest-maps-1.0&preserve-view=true
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
-[subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
-[Postman]: https://www.postman.com/downloads/
+[Azure Maps supported languages]: supported-languages.md
+[bruno]: https://www.usebruno.com/
 [Geocoding coverage]: geocoding-coverage.md
-[Search Address Reverse]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true
-[POI category search]: /rest/api/maps/search/getsearchpoicategory?view=rest-maps-1.0&preserve-view=true
-[Search Nearby]: /rest/api/maps/search/getsearchnearby?view=rest-maps-1.0&preserve-view=true
 [Get Search Address]: /rest/api/maps/search/getsearchaddress?view=rest-maps-1.0&preserve-view=true
-
-[Azure Maps supported languages]: supported-languages.md
+[POI category search]: /rest/api/maps/search/getsearchpoicategory?view=rest-maps-1.0&preserve-view=true
+[Postman]: https://www.postman.com/downloads/
+[Search Address Reverse]: /rest/api/maps/search/getsearchaddressreverse?view=rest-maps-1.0&preserve-view=true
 [Search Address]: /rest/api/maps/search/getsearchaddress?view=rest-maps-1.0&preserve-view=true
+[Search Fuzzy]: /rest/api/maps/search/getsearchfuzzy?view=rest-maps-1.0&preserve-view=true
+[Search Nearby]: /rest/api/maps/search/getsearchnearby?view=rest-maps-1.0&preserve-view=true
+[Search POIs inside the geometry]: /rest/api/maps/search/postsearchinsidegeometry?view=rest-maps-1.0&preserve-view=true
 [Search Polygon service]: /rest/api/maps/search/getsearchpolygon?view=rest-maps-1.0&preserve-view=true
+[Search service]: /rest/api/maps/search?view=rest-maps-1.0&preserve-view=true
 [Set up a geofence]: tutorial-geofence.md
-[Search POIs inside the geometry]: /rest/api/maps/search/postsearchinsidegeometry?view=rest-maps-1.0&preserve-view=true
+[subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account

articles/azure-maps/tutorial-iot-hub-maps.md

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Azure Maps
 description: Tutorial on how to Integrate IoT Hub with Microsoft Azure Maps service APIs
 author: farazgis
 ms.author: fsiddiqui
-ms.date: 09/14/2023
+ms.date: 08/14/2024
 ms.topic: tutorial
 ms.service: azure-maps
 ms.subservice: spatial
@@ -36,11 +36,11 @@ If you don't have an Azure subscription, create a [free account] before you begi
 * The [rentalCarSimulation] C# project
 
 > [!TIP]
-> You can download the entire [rentalCarSimulation] C# project from GitHub as a single ZIP file by going to [the root of the sample] and selecting the green **<> Code** button, then **Download ZIP**.
+> You can download the entire [rentalCarSimulation] C# project from GitHub as a single ZIP file by going to [the root of the sample] and selecting the green **Code** button, then **Download ZIP**.
 
-This tutorial uses the [Postman] application, but you can choose a different API development environment.
+This tutorial uses the [bruno] application, but you can choose a different API development environment.
 
->[!IMPORTANT]
+> [!IMPORTANT]
 > In the URL examples, replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key.
 
 ## Use case: rental car tracking
@@ -150,7 +150,7 @@ Now, set up your Azure function.
 
 1. After the app is created, you add a function to it. Go to the function app. Select the **Create in Azure Portal** button.
 
-     >[!IMPORTANT]
+    > [!IMPORTANT]
     > The **Azure Event ***Hub*** Trigger** and the **Azure Event ***Grid*** Trigger** templates have similar names. Make sure you select the **Azure Event ***Grid*** Trigger** template.
 
     :::image type="content" source="./media/tutorial-iot-hub-maps/function-create.png" alt-text="Screenshot of create a function in Azure Portal.":::
@@ -196,7 +196,7 @@ In your example scenario, you only want to receive messages when the rental car
 
 :::image type="content" source="./media/tutorial-iot-hub-maps/hub-filter.png" alt-text="Screenshot of filter routing messages.":::
 
->[!TIP]
+> [!TIP]
 >There are various ways to query IoT device-to-cloud messages. To learn more about message routing syntax, see [IoT Hub message routing].
 
 ## Send telemetry data to IoT Hub
@@ -264,6 +264,7 @@ To learn more about how to send device-to-cloud telemetry, and the other way aro
 [Azure Functions]: ../azure-functions/functions-overview.md
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
 [Azure Maps REST APIs]: /rest/api/maps/spatial/getgeofence
+[bruno]: https://www.usebruno.com/
 [C# script]: https://github.com/Azure-Samples/iothub-to-azure-maps-geofencing/blob/master/src/Azure%20Function/run.csx
 [create a storage account]: ../storage/common/storage-account-create.md?tabs=azure-portal
 [Create an Azure storage account]: #create-an-azure-storage-account
@@ -278,7 +279,6 @@ To learn more about how to send device-to-cloud telemetry, and the other way aro
 [IoT Plug and Play]: ../iot/overview-iot-plug-and-play.md
 [geofence JSON data file]: https://raw.githubusercontent.com/Azure-Samples/iothub-to-azure-maps-geofencing/master/src/Data/geofence.json?token=AKD25BYJYKDJBJ55PT62N4C5LRNN4
 [Plug and Play schema for geospatial data]: https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v1-preview/schemas/geospatial.md
-[Postman]: https://www.postman.com/
 [register a new device in the IoT hub]: ../iot-hub/create-connect-device.md
 [rentalCarSimulation]: https://github.com/Azure-Samples/iothub-to-azure-maps-geofencing/tree/master/src/rentalCarSimulation
 [resource group]: ../azure-resource-manager/management/manage-resource-groups-portal.md#create-resource-groups