Merge pull request #276056 from stevemunk/BME-updates

Updates/fixes to the BME migration guides

Author: JamesJBarnett

articles/azure-maps/migrate-bing-maps-overview.md

@@ -26,7 +26,7 @@ Covered in this article:
 
 Azure Maps is a set of mapping and geospatial services that enable developers and organizations to build intelligent location-based experiences for applications across many different industries and use cases. Use Azure Maps to bring maps, geocoding, location search, routing, real-time traffic, geolocation, time zone info, weather, and custom indoor maps into your web, mobile and server-side solutions. Azure Maps is an Azure service, so it inherently includes many of the Azure security and compliance promises that are important to enterprise customers. Azure Maps includes many of the same features as Bing Maps for Enterprise, along with more functionality, like:
 
-- Multiple service authentication method options. For more information on security and authentication in Azure Maps, See [Authentication with Microsoft Azure Maps].
+- Multiple service authentication method options. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps].
 - Data residency compliance support. For more information, see [Azure Maps service geographic scope].
 - Azure regulatory compliance standards (GDPR, ISO, FedRAMP, HIPAA, etc.). For more information, see [Microsoft Compliance].
 - Support for programmatically creating and managing Azure Maps accounts (resources). For more information, see [Create your Azure Maps account using an ARM template].
@@ -65,7 +65,7 @@ With Bing Maps for Enterprise, the [Bing Maps Account Center] is where you manag
 
 ### Security and authentication
 
-Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple authentication methods, such as a [Shared Key], [Microsoft Entra ID], or [Shared access signature token authentication]. For more information on security and authentication in Azure Maps, See [Authentication with Microsoft Azure Maps].
+Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple authentication methods, such as a [Shared Key], [Microsoft Entra ID], or [Shared access signature token authentication]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps].
 
 ## Licensing and billing considerations
 
@@ -163,7 +163,7 @@ More Azure Maps resources:
 
 Developers can get migration support through the [Azure Maps Q&A] or through one of the many [Azure support options].
 
-[Authentication with Microsoft Azure Maps]: azure-maps-authentication.md
+[Authentication with Azure Maps]: azure-maps-authentication.md
 [Authentication best practices]: authentication-best-practices.md
 [Autosuggest]: /bingmaps/rest-services/autosuggest
 [Azure Licensing]: https://azure.microsoft.com/pricing/purchase-options/azure-account
@@ -225,7 +225,7 @@ Developers can get migration support through the [Azure Maps Q&A] or through one
 [Search: Fuzzy (typehead)]: /rest/api/maps/search/get-search-fuzzy
 [Search: Fuzzy Search (typeahead)]: /rest/api/maps/search/get-search-fuzzy
 [Search: Fuzzy]: /rest/api/maps/search/get-search-fuzzy
-[Search: POI]:  /rest/api/maps/search/get-search-poi
+[Search: POI]: /rest/api/maps/search/get-search-poi
 [Search: Polygon]: /rest/api/maps/search/get-polygon
 [Search: Reverse Geocoding Batch]: /rest/api/maps/search/get-reverse-geocoding-batch
 [Search: Reverse Geocoding]: /rest/api/maps/search/get-reverse-geocoding

articles/azure-maps/migrate-calculate-route.md

@@ -37,7 +37,7 @@ Bing Maps for Enterprise only supports API key authentication. Azure Maps suppor
 
 The following table lists the Bing Maps _Calculate a Route_ request parameters and the Azure Maps equivalent:
 
-| Bing Maps Request Parameter | Bing Maps Request Parameter Alias  | Azure Maps Request Parameter | Required in Azure Maps  | Azure Maps Data Type  | Description|
+| Bing Maps request parameter | Bing Maps request parameter alias  | Azure Maps request parameter | Required in Azure Maps  | Azure Maps data type  | Description|
 |-----------------------------------|------------------------------------|------------------------------------|-------------------------|-----------------------|------------|
 | avoid       |       | avoid  | False | string   | Here are the Bing Maps Calculate a Route API to Azure Maps Route Directions API avoid equivalents, where supported: <br><br>tolls: tollRoads<br>ferry: ferries<br>borderCrossings: borderCrossings<br>minimizeDrivingSideTurn: Not supported<br><br>minimizeAgainstDrivingSideTurn: Not supported<br>minimizeUTurn: Not supported<br>minimizeTolls: Not supported<br>highways: limitedAccessHighways<br>minimizeHighways: Not supported<br> |
 | dateTime    | dt    | departAt  | False | string   | Azure Maps Route Directions API also supports arriveAt parameter that is used to specify the desired date and time of arrival. It can't be used with departAt.|

articles/azure-maps/migrate-calculate-truck-route.md

@@ -36,7 +36,7 @@ Bing Maps for Enterprise only supports API key authentication. Azure Maps suppor
 
 The following table lists the Bing Maps _Calculate a Truck Route_ request parameters and the Azure Maps equivalent:
 
-| Bing Maps Request Parameter | Bing Maps Request Parameter Alias  | Azure Maps Request Parameter | Required in Azure Maps  | Azure Maps Data Type  | Description|
+| Bing Maps request parameter | Bing Maps request parameter alias  | Azure Maps request parameter | Required in Azure Maps  | Azure Maps data type  | Description|
 |-----------------------------------|------------------------------------|------------------------------------|-------------------------|-----------------------|------------|
 | avoid  | | avoid  | False  | string  | Here are the Bing Maps to Azure Maps Route Directions API _avoid_ equivalents, where supported:<br><br>- tolls: tollRoads<br>- ferry: ferries<br>- borderCrossings: borderCrossings<br>- highways: limitedAccessHighways<br>- minimizeDrivingSideTurn: Not supported<br>- minimizeAgainstDrivingSideTurn: Not supported<br>- minimizeUTurn: Not supported <br>- minimizeTolls: Not supported<br>- minimizeHighways: Not supported  |
 | borderRestriction  | | Not supported  | Not supported  | Not supported  | In Azure Maps Route Directions API, _avoid=borderCrossings_ can be used to restrict routes from crossing country borders however specifying a region list for border restriction isn't supported.  |
@@ -579,6 +579,7 @@ Support
 [Microsoft Q&A Forum]: /answers/tags/209/azure-maps
 [Post Directions Batch]: /rest/api/maps/route/post-directions-batch
 [Route Directions]: /rest/api/maps/route/post-directions
+[RouteOutputOption]: /rest/api/maps/route/post-directions#routeoutputoption
 [Security section]: /rest/api/maps/route/get-route-range?#security
 [Shared Access Signature (SAS) Token]: azure-maps-authentication.md#shared-access-signature-token-authentication
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account

articles/azure-maps/migrate-find-location-address.md

@@ -31,22 +31,21 @@ This article explains how to migrate the Bing Maps [Find a Location by Address]
 
 ## Security and authentication
 
-Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps].
+Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps] and the [Security section] in the Azure Maps Get Geocoding documentation.
 
 ## Request parameters
 
 The following table lists the Bing Maps _Find a Location by Address_ request parameters and the Azure Maps equivalent:
 
-| Bing Maps Request Parameter | Bing Maps Request Parameter Alias  | Azure Maps Request Parameter | Required in Azure Maps  | Azure Maps Data Type  | Description|
+| Bing Maps request parameter | Bing Maps request parameter alias  | Azure Maps request parameter | Required in Azure Maps  | Azure Maps data type  | Description|
 |-----------------------------|------------------------------------|------------------------------|-------------------------|-----------------------|------------|
-| Bing Maps Request Parameter Name  | Bing Maps Request Parameter Alias  | Azure Maps Request Parameter Name  | Required in Azure Maps  | Azure Maps Data Type  | Note  |
+| Bing Maps request parameter  | Bing Maps request parameter alias  | Azure Maps request parameter  | Required in Azure Maps  | Azure Maps data type  | Note  |
 | addressLine   | | addressLine    | False  | string  | In Azure Maps Get Geocoding API, a street address, or street address with locality and `adminDistrict`, is supported input for `addressLine`.  |
 | adminDistrict  | | adminDistrict  | False  | string  | |
 | countryRegion  | | countryRegion  | False  | string  | |
 | locality      | | locality  | False  | string  | |
 | postalCode    | | postalCode     | False  | string  | |
 | culture  | c  | Request Header:  Accept-Language   | False  | string  | As specified in the Azure Maps [request header], `culture` defines the language used in search results when using the Azure Maps Get Geocoding API. For more information, see [Supported Languages]. |
-| | | |     |   | |
 | include  | incl  | Not needed  | Not needed  | Not needed  | In Bing Maps Find a Location by Address API, the ‘include’ input parameter is required in order to get a two-letter ISO country code for the location result in the response (_include=ciso2_). In Azure Maps Get Geocoding API, the two-letter ISO country code is returned by default.  |
 | includeNeighborhood  | inclnb  | Not needed  | Not needed  | Not needed  | In Azure Maps Get Geocoding API, neighborhood info is returned in the response by default, when available.    |
 | maxResults  | maxRes  | top  | False  | Integer (int32)  | In Azure Maps Get Geocoding API, the default number of responses returned is 5. The minimum is 1 and the maximum is 20.  |
@@ -286,9 +285,10 @@ Support
 [Microsoft Q&A Forum]: /answers/tags/209/azure-maps
 [Migrate Bing Maps Find a Location by Query API]: migrate-find-location-query.md
 [request header]: /rest/api/maps/search/get-geocoding?#request-headers
+[Security section]: /rest/api/maps/search/get-geocoding#security
 [Shared Access Signature (SAS) Token]: azure-maps-authentication.md#shared-access-signature-token-authentication
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
 [Supported Languages]: supported-languages.md
 [Supported Views]: supported-languages.md#azure-maps-supported-views
 [Understanding Azure Maps Transactions]: understanding-azure-maps-transactions.md
-[URI Parameters]: /rest/api/maps/search/get-geocoding#uri-parameters
+[URI Parameters]: /rest/api/maps/search/get-geocoding#uri-parameters

articles/azure-maps/migrate-find-location-by-point.md

@@ -30,23 +30,20 @@ This article explains how to migrate the Bing Maps [Find a Location by Point] AP
 
 ## Security and authentication
 
-Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps].
+Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps] and the [Security section] in the Azure Maps Get Geocoding documentation.
 
 ## Request parameters
 
 The following table lists the Bing Maps _Find a Location by Point_ request parameters and the Azure Maps equivalent:
 
-| Bing Maps Request Parameter | Bing Maps Request Parameter Alias | Azure Maps Request Parameter | Required in Azure Maps | Azure Maps Data Type | Description |
+| Bing Maps request parameter | Bing Maps request parameter alias | Azure Maps request parameter | Required in Azure Maps | Azure Maps data type | Description |
 |-----------------------------|-----------------------------------|------------------------------|------------------------|----------------------|-------------|
 | culture | c | Request Header: Accept-Language | False | string | In Azure Maps Get Reverse Geocoding API, this is the language in which search results should be returned. This is specified in the Azure Maps [request header]. Please refer to [Supported Languages] for details. |
-| | | | | | |
 | include | incl | Not needed | Not needed | Not needed | In Bing Maps Find a Location by Point, the ‘include’ input parameter is required to get a two-letter ISO country code for the location result in the response. In Azure Maps Get Reverse Geocoding API, the two-letter ISO country code is returned by default. |
 | includeEntityTypes | | resultTypes | False | query | |
-| | | | | | |
 | includeNeighborhood | inclnb | Not needed | Not needed | Not needed | In Azure Maps Get Reverse Geocoding API, neighborhood info is returned in the response by default, when available. |
 | point | | coordinates | True | number[] | In Bing Maps Find a Location by Point API, the coordinates in the request and the response are in latitude/longitude format, whereas Azure Maps Get Reverse Geocoding API requires the coordinates in the request and the coordinates in the response use longitude/latitude format, as defined by [GeoJSON]. |
-| userRegion | ur | view | False | string | A string that represents an [ISO 3166-1 Alpha-2 region/country code]. This will alter geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to “Auto” even if you haven’t defined it in the request. |
-| | | | | | Please refer to [Supported Views] for details and to see the available Views. |
+| userRegion | ur | view | False | string | A string that represents an [ISO 3166-1 Alpha-2 region/country code]. This will alter geopolitical disputed borders and labels to align with the specified user region. By default, the View parameter is set to “Auto” even if you haven’t defined it in the request.<br><br> Please refer to [Supported Views] for details and to see the available Views. |
 | verboseplacenames | vbpn | Not supported | Not supported | Not supported | Azure Maps Get Reverse Geocoding API only supports returning [adminDistricts] short name (FL instead of Florida). |
 
 For more information about the Azure Maps Get Reverse Geocoding API request parameters, see [URI Parameters].
@@ -69,7 +66,7 @@ http://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=2.3
 
 The following table lists the fields that can appear in the HTTP response when running the Bing Maps _Find a Location by Point_ request and the Azure Maps equivalent:
 
-| Bing Maps Response        | Azure Maps Response    | Description                   |
+| Bing Maps response        | Azure Maps response    | Description                   |
 |---------------------------|------------------------|-------------------------------|
 | address: addressLine (JSON)<br>Address: AddressLine (XML) | address: addressLine | |
 | address: adminDistrict (JSON)<br>Address: AdminDistrict (XML) | address: adminDistricts | |
@@ -255,6 +252,7 @@ Support
 
 - [Microsoft Q&A Forum]
 
+[adminDistricts]: /rest/api/maps/search/get-reverse-geocoding#admindistricts
 [Authentication with Azure Maps]: azure-maps-authentication.md
 [Azure Account]: https://azure.microsoft.com/
 [Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
@@ -268,6 +266,7 @@ Support
 [Microsoft Entra ID]: azure-maps-authentication.md#microsoft-entra-authentication
 [Microsoft Q&A Forum]: /answers/tags/209/azure-maps
 [request header]: /rest/api/maps/search/get-reverse-geocoding?#request-headers
+[Security section]: /rest/api/maps/search/get-reverse-geocoding#security
 [Shared Access Signature (SAS) Token]: azure-maps-authentication.md#shared-access-signature-token-authentication
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
 [Supported Languages]: supported-languages.md

articles/azure-maps/migrate-find-location-query.md

@@ -31,17 +31,16 @@ This article explains how to migrate the Bing Maps [Find a Location by Query] AP
 
 ## Security and authentication
 
-Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps].
+Bing Maps for Enterprise only supports API key authentication. Azure Maps supports multiple ways to authenticate your API calls, such as a [subscription key](azure-maps-authentication.md#shared-key-authentication), [Microsoft Entra ID], and [Shared Access Signature (SAS) Token]. For more information on security and authentication in Azure Maps, See [Authentication with Azure Maps] and the [Security section] in the Azure Maps Get Geocoding documentation.
 
 ## Request parameters
 
 The following table lists the Bing Maps _Find a Location by Query_ request parameters and the Azure Maps equivalent:
 
-| Bing Maps Request Parameter | Bing Maps Request Parameter Alias  | Azure Maps Request Parameter | Required in Azure Maps  | Azure Maps Data Type  | Description|
+| Bing Maps request parameter | Bing Maps request parameter alias  | Azure Maps request parameter | Required in Azure Maps  | Azure Maps data type  | Description|
 |-----------------------------|------------------------------------|------------------------------|-------------------------|-----------------------|------------|
 | culture | c | Request Header:  Accept-Language   | False | string | As specified in the Azure Maps [request header], `culture` defines the language used in search results when using the Azure Maps Get Geocoding API. For more information, see [Supported Languages].|
 | include | incl    | Not needed  | Not needed     | Not needed | In Bing Maps Find a Location by Query API, the `include` input parameter is required to get a two-letter ISO country code for the location result in the response (_include=ciso2_) and to specify that the response shows how the query string was parsed into address values (_include=queryParse_). In Azure Maps Get Geocoding API, the two-letter ISO country code is returned by default and doesn’t support a queryParse equivalent. |
-| || Not supported | Not supported  | Not supported    | |
 | includeNeighborhood  | inclnb  | Not needed  | Not needed     | Not needed | In Azure Maps Get Geocoding API, neighborhood info is returned in the response by default, when available.  |
 | maxResults | maxRes  | top    | False | Integer (int32)  | In Azure Maps Get Geocoding API, the default number of responses returned is 5. The minimum is 1 and the maximum is 20. |
 | query | q | query  | True | string | |
@@ -280,6 +279,7 @@ Support
 [Microsoft Q&A Forum]: /answers/tags/209/azure-maps
 [Migrate Bing Maps Find a Location by Address API]: migrate-find-location-address.md
 [request header]: /rest/api/maps/search/get-geocoding?#request-headers
+[Security section]: /rest/api/maps/search/get-geocoding#security
 [Shared Access Signature (SAS) Token]: azure-maps-authentication.md#shared-access-signature-token-authentication
 [subscription key]: quick-demo-map-app.md#get-the-subscription-key-for-your-account
 [Supported Languages]: supported-languages.md