Merge pull request #107498 from farah-alyasari/newguide

Newguide

Author: megvanhuygen

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

@@ -9,7 +9,7 @@ ms.service: azure-maps
 services: azure-maps
 manager: timlt
 ms.custom: mvc
-#Customer intent: As an Azure enterprise customer, I want to know what capabilities Azure Maps has so that I can take advantage of mapping in my applications. 
+#Customer intent: As an Azure enterprise customer, I want to know what capabilities Azure Maps has, so that I can take advantage of mapping in my applications. 
 ---
 
 # What is Azure Maps?

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

@@ -1,6 +1,6 @@
 ---
-title: Search efficiently by using Azure Maps Search Service  | Microsoft Azure Maps 
-description: Learn how to apply best practices for Search Service by using Microsoft Azure Maps.
+title: Best practices for Azure Maps Search Service | Microsoft Azure Maps 
+description: Learn how to apply the best practices when using the Search Service from Microsoft Azure Maps.
 author: farah-alyasari
 ms.author: v-faalya
 ms.date: 01/23/2020
@@ -64,12 +64,12 @@ We recommend that you use the Azure Maps [Search Fuzzy API](https://docs.microso
 
 * Use the `idxSet` parameter to prioritize the exact set of result types. To prioritize an exact set of results, you can submit a comma-separated list of indexes. In your list, the item order doesn't matter. Azure Maps supports the following indexes:
 
-    * `Addr` - **Address ranges**: Address points that are interpolated from the beginning and end of the street. These points are represented as address ranges.
-    * `Geo` - **Geographies**: Administrative divisions of land. A geography can be a country, state, or city, for example.
-    * `PAD` - **Point addresses**: Addresses that include a street name and number. Point addresses can be found in an index. An example is *Soquel Dr 2501*. A point address provides the highest level of accuracy available for addresses.  
-    * `POI` - **Points of interest**: Points on a map that are considered to be worth attention or that might be interesting. The [Search Address API](https://docs.microsoft.com/rest/api/maps/search/getsearchaddress) doesn't return POIs.  
-    * `Str` - **Streets**: Streets on the map.
-    * `XStr` - **Cross streets or intersections**: Junctions or places where two streets intersect.
+* `Addr` - **Address ranges**: Address points that are interpolated from the beginning and end of the street. These points are represented as address ranges.
+* `Geo` - **Geographies**: Administrative divisions of land. A geography can be a country, state, or city, for example.
+* `PAD` - **Point addresses**: Addresses that include a street name and number. Point addresses can be found in an index. An example is *Soquel Dr 2501*. A point address provides the highest level of accuracy available for addresses.  
+* `POI` - **Points of interest**: Points on a map that are considered to be worth attention or that might be interesting. The [Search Address API](https://docs.microsoft.com/rest/api/maps/search/getsearchaddress) doesn't return POIs.  
+* `Str` - **Streets**: Streets on the map.
+* `XStr` - **Cross streets or intersections**: Junctions or places where two streets intersect.
 
 
 #### Usage examples
@@ -485,7 +485,6 @@ In a request, you can submit a comma-separated list of brand names. Use the list
 
 To explore brand searching, let's make a [POI category search](https://docs.microsoft.com/rest/api/maps/search/getsearchpoicategory) request. In the following example, we look for gas stations near the Microsoft campus in Redmond, Washington. The response shows brand information for each POI that was returned.
 
-
 #### Sample query
 
 ```HTTP
@@ -963,5 +962,10 @@ Responses for the [Search Address](https://docs.microsoft.com/rest/api/maps/sear
 
 ## Next steps
 
-* Learn [how to build Azure Maps Search Service requests](https://docs.microsoft.com/azure/azure-maps/how-to-search-for-address).
-* Explore the Azure Maps [Search Service API documentation](https://docs.microsoft.com/rest/api/maps/search). 
+To learn more, please see :
+
+> [!div class="nextstepaction"]
+> [How to build Azure Maps Search Service requests](https://docs.microsoft.com/azure/azure-maps/how-to-search-for-address)
+
+> [!div class="nextstepaction"]
+> [Search Service API documentation](https://docs.microsoft.com/rest/api/maps/search)

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

@@ -131,8 +131,10 @@ landingContent:
         links:
           - text: Search for an address (geocoding)
             url: how-to-search-for-address.md
-          - text: Best practices for search
+          - text: Best Practices using Search Service
             url: how-to-use-best-practices-for-search.md
+          - text: Best Practices using Rout Service
+            url: how-to-use-best-practices-for-routing.md
           - text: Render custom data on static map
             url: how-to-render-custom-data.md
       - linkListType: reference