Merge pull request #104068 from farah-alyasari/editpass2

Editpass2

Author: American-Dipper

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

@@ -3,7 +3,7 @@ title: Overview | Microsoft Azure Maps
 description: Learn about services and capabilities in Microsoft Azure Maps and how to use them in your applications.
 author: walsehgal
 ms.author: v-musehg
-ms.date: 01/15/2020
+ms.date: 02/11/2020
 ms.topic: overview
 ms.service: azure-maps
 services: azure-maps
@@ -16,13 +16,13 @@ ms.custom: mvc
 
 Azure Maps is a collection of geospatial services that use fresh mapping data to provide geographic context to web and mobile applications. Azure Maps provides:
 
-* REST APIs for rendering maps in multiple styles and in satellite imagery.
-* Searches for addresses, places, and points of interest around the world.
-* Different types of routing: point-to-point, multipoint, multipoint optimization, isochrone, commercial vehicle, traffic influenced, and matrix routing
-* Traffic flow and incidents view.
-* Mobility services for requesting public transit and alternative modes of transportation (like bike share, scooter share, and car share), and planning routes in real time. 
-* Establishing user location through geolocation, and converting location to time zones. 
-* Services for geofencing and map data storage, with location information hosted in Azure. 
+* REST APIs to render maps in multiple styles and in satellite imagery.
+* Search services to locate addresses, places, and points of interest around the world.
+* Various routing options; such as point-to-point, multipoint, multipoint optimization, isochrone, commercial vehicle, traffic influenced, and matrix routing.
+* Traffic flow view and incidents view, for applications that require traffic information.
+* Mobility service to request public transit logistics, plan routes in real time, and  request information for alternative modes of transportation.
+* Time zone and geolocation services and converting a location to time zones.
+* Geofencing service and mapping data storage, with location information hosted in Azure. 
 * Location intelligence through geospatial analytics. 
 
 Additionally, Azure Maps services are available through the Web SDK or the Android SDK. These tools help developers quickly develop and scale solutions that integrate location information into Azure solutions. 
@@ -39,7 +39,7 @@ The following video explains Azure Maps in depth:
 
 ### Web SDK
 
-The Azure Maps Web SDK lets you customize interactive maps with your own content and imagery for your web or mobile applications. This control makes use of WebGL, so you can render large data sets with high performance. Develop with the SDK by using JavaScript or TypeScript.
+The Azure Maps Web SDK lets you customize interactive maps with your own content and imagery. You can use this interactive map for both your web or mobile applications. The map control makes use of WebGL, so you can render large data sets with high performance. Develop with the SDK by using JavaScript or TypeScript.
 
 ![Example map of population change](media/about-azure-maps/Introduction_WebMapControl.png)
 
@@ -59,23 +59,23 @@ Data is imperative for maps. Use Data Service to upload and store geospatial dat
 
 ### Mobility service
 
-The Azure Maps Mobility service allows real-time trip planning. It returns the best possible route options and provides different kinds of travel modes. For metro (city) areas, these modes can include walking, biking, and public transit. You can request transit itinerary, line geometry, lists of stops, scheduled and real-time arrivals, and service alerts.
+The Azure Maps Mobility service allows real-time trip planning. It returns the best possible route options and provides different kinds of travel modes. For metro (city) areas, these modes can include walking, biking, and public transit. You can request transit itinerary, line geometry, lists of stops, scheduled arrivals, real-time arrivals, and service alerts.
 
-The service also allows searches for specific object types, such as shared bikes, scooters, or cars around a location. Users can request the number of available bikes in the closest dock and search available vehicles for ride-sharing. Also, users can find details like future availability of vehicles and current fuel level.
+The service also allows searches for specific object types around a location. Users can search for shared bikes, scooters, or cars around a location. Users can request the number of available bikes in the closest dock and search available vehicles for ride-sharing. And, users can find details like future availability of vehicles and current fuel level.
 
 To learn more about the service, see the [Mobility API documentation](https://docs.microsoft.com/rest/api/maps/mobility).
 
 ### Render service
 
-The Render service helps developers create web and mobile applications around mapping. The service uses either high-quality raster graphic images, available in 19 zoom levels, or fully customizable vector format map images.
+The Render service helps developers create web and mobile applications with mapping features. The service uses either high-quality raster graphic images, available in 19 zoom levels, or fully customizable vector format map images.
 
 ![Example of a map from the Render service](media/about-azure-maps/Introduction_Map.png)
 
 The Render service now offers preview APIs to allow developers to work with satellite imagery. For more details, read the [Render API documentation](https://docs.microsoft.com/rest/api/maps/render).
 
 ### Route service
 
-The Route service contains robust geometry calculations for real-world infrastructure and directions for multiple transportation modes. The service allows for developers to calculate directions across a number of travel modes such as car, truck, bicycle, or walking. The service can also consider inputs such as traffic conditions, weight restrictions, or hazardous material transport.
+The Route service contains robust geometry calculations for real-world infrastructure and directions for multiple transportation modes. The service allows developers to calculate directions across a number of travel modes such as car, truck, bicycle, or walking. The service also considers inputs such as traffic conditions, weight restrictions, or hazardous material transport.
 
 ![Example of a map from the Route service](media/about-azure-maps/Introduction_Route.png)
 
@@ -104,7 +104,7 @@ APIs for batch and area search are currently in preview. For more details on the
 
 ### Spatial Operations service
 
-The Azure Maps Spatial Operations service takes location information and analyzes it quickly to help inform customers of ongoing events happening in time and space. It enables near real-time analysis and predictive modeling of events. 
+The Azure Maps Spatial Operations service takes location information. It quickly analyzes location information to help inform customers of ongoing events happening in time and space. It enables near real-time analysis and predictive modeling of events. 
 
 The service enables customers to enhance their location intelligence with a library of common geospatial mathematical calculations. Common calculations include closest point, great circle distance, and buffers. To learn more about the service and the various features, read the [Spatial Operations API documentation](https://docs.microsoft.com/rest/api/maps/spatial).
 
@@ -114,7 +114,7 @@ The Time Zone service enables you to query current, historical, and future time
 
 * Converting Microsoft Windows time-zone IDs to IANA time zones.
 * Fetching a time-zone offset to UTC.
-* Getting the current time in a time zone. 
+* Getting the current time in a chosen time zone. 
 
 A typical JSON response for a query to the Time Zone service looks like the following sample:
 
@@ -165,7 +165,7 @@ Also, Azure Maps offers a convenient [JavaScript map control](https://docs.micro
 
 Accessing the Azure Maps services is a matter of going to the [Azure portal](https://portal.azure.com) and creating an Azure Maps account.
 
-Azure Maps uses a key-based authentication scheme. Your account comes with two keys already generated for you. Start integrating these location capabilities in your application, using either keys, and make a request to the Azure Maps service.
+Azure Maps uses a key-based authentication scheme. Your account comes with two keys already generated for you, use either keys. Start integrating these location capabilities in your application and make requests to the Azure Maps services.
 
 ## Supported regions
 

articles/azure-maps/azure-maps-authentication.md

@@ -3,7 +3,7 @@ title: Authentication methods | Microsoft Azure Maps
 description: In this article, you'll learn about Azure Active Directory (Azure AD) and Shared Key authentication. Both are used for Microsoft Azure Maps services. Learn how to get Azure Maps subscription key.
 author: walsehgal
 ms.author: v-musehg
-ms.date: 01/28/2020
+ms.date: 02/11/2020
 ms.topic: conceptual
 ms.service: azure-maps
 services: azure-maps
@@ -13,31 +13,30 @@ ms.custom: mvc
 
 # Authentication with Azure Maps
 
-Azure Maps supports two ways to authenticate requests: Shared Key authentication and Azure Active Directory authentication. This article explains these authentication methods to help guide your implementation.
+Azure Maps supports two ways to authenticate requests: Shared Key authentication and Azure Active Directory authentication. This article explains these authentication methods to help guide your implementation of Azure Maps services.
 
 ## Shared Key authentication
 
-Shared Key authentication passes keys generated by an Azure Maps account with each request to Azure Maps. For each request to Azure Maps services, the *subscription key* needs to be added as a parameter to the URL. Primary and secondary keys are generated after the Azure Maps account is created. We recommend you use the primary key as the subscription key when you call Azure Maps by using shared key authentication. The secondary key can be used in scenarios like rolling key changes.  
+ Primary and secondary keys are generated after the Azure Maps account is created. You're encouraged to use the primary key as the subscription key when calling Azure Maps using shared key authentication. Shared Key authentication passes a key generated by an Azure Maps account to an Azure Maps service. For each request to Azure Maps services, add the *subscription key* as a parameter to the URL. The secondary key can be used in scenarios like rolling key changes.  
 
 For information about viewing your keys in the Azure portal, see [Manage authentication](https://aka.ms/amauthdetails).
 
 > [!Tip]
-> We recommend regenerating your keys regularly. You're provided with two keys, so that you can maintain connections with one key while regenerating the other. When you regenerate your keys, you need to update any applications that access your account with the new keys.
-
-
+> We recommend regenerating your keys regularly. You're provided with two keys, so that you can maintain connections with one key while regenerating the other. When you regenerate your keys, you need to update any applications, that access your account, with the new keys.
 
 ## Authentication with Azure Active Directory (Preview)
 
-Azure Maps now offers requests authentication for Azure Maps services using [Azure Active Directory (Azure AD)](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis). Azure AD provides identity-based authentication, including [role-based access control (RBAC)](https://docs.microsoft.com/azure/role-based-access-control/overview). RBAC is used to grant user-level, group-level, or application-level access to Azure Maps resources. The next sections can help you understand concepts and components of Azure Maps integration with Azure AD.
+Azure Maps now offers requests authentication for Azure Maps services using [Azure Active Directory (Azure AD)](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis). Azure AD provides identity-based authentication, including [role-based access control (RBAC)](https://docs.microsoft.com/azure/role-based-access-control/overview). RBAC is used to grant user-level, group-level, or application-level access to Azure Maps resources. The next sections discuss concepts and components of Azure Maps integration with Azure AD.
+
 ## Authentication with OAuth access tokens
 
-Azure Maps accepts **OAuth 2.0** access tokens for Azure AD tenants associated with an Azure subscription that contains an Azure Maps account. Azure Maps accepts tokens for:
+Azure Maps accepts **OAuth 2.0** access tokens for Azure AD tenants associated with an Azure subscription that contains an Azure Maps account. Azure Maps also accepts tokens for:
 
 * Azure AD users
 * Partner applications that use permissions delegated by users
 * Managed identities for Azure resources
 
-Azure Maps generates a *unique identifier (client ID)* for each Azure Maps account. You can request tokens from Azure AD when you combine this client ID with additional parameters. To request a token, you need to specify the values in the following table based on your Azure Environment.
+Azure Maps generates a *unique identifier (client ID)* for each Azure Maps account. You can request tokens from Azure AD when you combine this client ID with additional parameters. To request a token, specify the values in the following table based on your Azure Environment.
 
 | Azure Environment   | Azure AD token endpoint |
 | --------------------|-------------------------|
@@ -51,7 +50,7 @@ For general information about requesting tokens from Azure AD, see [What is auth
 
 ## Request Azure Map resources with OAuth tokens
 
-After a token is received from Azure AD, a request is sent to Azure Maps with the following set of required request headers:
+After Azure AD receives a token, Azure Maps sends a request with the following set of required request headers:
 
 | Request header    |    Value    |
 |:------------------|:------------|
@@ -74,7 +73,7 @@ For information about viewing your client ID, see [View authentication details](
 
 ## Control access with RBAC
 
-In Azure AD, use RBAC to control access to secured resources. Set up your Azure Maps account and register your Azure Maps Azure AD TENANT. Azure Maps supports read access control for individual Azure AD users, groups, applications, Azure resources, and Azure services via managed identities for Azure resources. On the Azure Maps portal page, you can set up RBAC for your desired roles.
+In Azure AD, use RBAC to control access to secured resources. Set up your Azure Maps account and register your Azure Maps Azure AD Tenant. Azure Maps supports read access control for individual Azure AD users, groups, applications, Azure resources, and Azure services via managed identities for Azure resources. On the Azure Maps portal page, you can set up RBAC for your chosen roles.
 
 ![Azure Maps Data Reader (Preview)](./media/azure-maps-authentication/concept.png)
 

articles/azure-maps/azure-maps-event-grid-integration.md

@@ -13,7 +13,7 @@ ms.custom: mvc
 
 # React to Azure Maps events by using Event Grid 
 
-Azure Maps integrates with Azure Event Grid, so that users can send event notifications to other services and trigger downstream processes. The purpose of this article is to help you configure your business applications to listen to Azure Maps events. This service allows you to react to critical events in a reliable, scalable, and secure manner. For example, users can build an application to update a database, create a ticket, and deliver an email notification, every time a device enters a geofence.
+Azure Maps integrates with Azure Event Grid, so that users can send event notifications to other services and trigger downstream processes. The purpose of this article is to help you configure your business applications to listen to Azure Maps events. This allows users to react to critical events in a reliable, scalable, and secure manner. For example, users can build an application to update a database, create a ticket, and deliver an email notification, every time a device enters a geofence.
 
 Azure Event Grid is a fully managed event routing service, which uses a publish-subscribe model. Event Grid has built-in support for Azure services like [Azure Functions](https://docs.microsoft.com/azure/azure-functions/functions-overview) and [Azure Logic Apps](https://docs.microsoft.com/azure/azure-functions/functions-overview). It can deliver event alerts to non-Azure services using webhooks. For a complete list of the event handlers that Event Grid supports, see [An introduction to Azure Event Grid](https://docs.microsoft.com/azure/event-grid/overview).
 
@@ -27,8 +27,8 @@ Event grid uses [event subscriptions](https://docs.microsoft.com/azure/event-gri
 
 | Event type | Description |
 | ---------- | ----------- |
-| Microsoft.Maps.GeofenceEntered | Raised when coordinates received have moved from outside of a given geofence to within |
-| Microsoft.Maps.GeofenceExited | Raised when coordinates received have moved from within a given geofence to outside |
+| Microsoft.Maps.GeofenceEntered | Raised when received coordinates have moved from outside of a given geofence to within |
+| Microsoft.Maps.GeofenceExited | Raised when received coordinates have moved from within a given geofence to outside |
 | Microsoft.Maps.GeofenceResult | Raised every time a geofencing query returns a result, regardless of the state |
 
 ## Event schema
@@ -75,9 +75,9 @@ The following example shows the schema for GeofenceResult:
 
 Applications that handle Azure Maps geofence events should follow a few recommended practices:
 
-* Multiple subscriptions can be configured to route events to the same event handler. It's important not to assume that events are from a particular source. Always check the message topic to ensure that it comes from the source that you expect.
-* Messages can arrive out of order or after a delay. Use the `X-Correlation-id` field in the response header to understand if your information about objects is up to date.
-* When Get and POST Geofence API is called with mode parameter set to `EnterAndExit`, an Enter or Exit event is generated for each geometry in the geofence for which the status has changed from the previous Geofence API call.
+* Configure multiple subscriptions to route events to the same event handler. It's important not to assume that events are from a particular source. Always check the message topic to ensure that the message came from the source that you expect.
+* Use the `X-Correlation-id` field in the response header to understand if your information about objects is up to date. Messages can arrive out of order or after a delay.
+* When a GET or a POST request in the Geofence API is called with the mode parameter set to `EnterAndExit`, then an Enter or Exit event is generated for each geometry in the geofence for which the status has changed from the previous Geofence API call.
 
 ## Next steps