Merge pull request #98720 from rbrundritt/master

Minor updates

Author: megvanhuygen

articles/azure-maps/drawing-tools-events.md

@@ -24,6 +24,8 @@ When using drawing tools on a map, it is often useful to react to certain events
 
 The following code shows how the events in the Drawing Tools module work. Draw shapes on the map and watch as the events fire.
 
+<br/>
+
 <iframe height="500" style="width: 100%;" scrolling="no" title="Drawing tools events" src="https://codepen.io/azuremaps/embed/dyPMRWo?height=500&theme-id=default&default-tab=js,result" frameborder="no" allowtransparency="true" allowfullscreen="true">
   See the Pen <a href='https://codepen.io/azuremaps/pen/dyPMRWo'>Drawing tools events</a> by Azure Maps
   (<a href='https://codepen.io/azuremaps'>@azuremaps</a>) on <a href='https://codepen.io'>CodePen</a>.
@@ -39,6 +41,8 @@ The following are examples of some common scenarios that use the drawing tools e
 
 The following code shows how to monitor the drawing of shapes that represent polygon areas (polygons, rectangles, and circles), and determine which data points on the map are within the drawn area. The `drawingcomplete` event is used to trigger the select logic. In the select logic, all data points on the map are looped through and tested for intersection with the polygon area of the drawn shape. This example makes use of the open-source [Turf.js](http://turfjs.org/) library to perform a spatial intersection calculation.
 
+<br/>
+
 <iframe height="500" style="width: 100%;" scrolling="no" title="Select data in drawn polygon area" src="https://codepen.io/azuremaps/embed/XWJdeja?height=500&theme-id=default&default-tab=result" frameborder="no" allowtransparency="true" allowfullscreen="true">
   See the Pen <a href='https://codepen.io/azuremaps/pen/XWJdeja'>Select data in drawn polygon area</a> by Azure Maps
   (<a href='https://codepen.io/azuremaps'>@azuremaps</a>) on <a href='https://codepen.io'>CodePen</a>.
@@ -50,6 +54,8 @@ The following code shows how to monitor the drawing of shapes that represent pol
 
 The following code shows how to perform a search for points of interests inside a shape area after the user has finished drawing the shape. The `drawingcomplete` event is used to trigger the search logic. If the user draws a rectangle or polygon, a search inside geometry is performed. If a circle is drawn, the radius and center position is used to perform a point of interest search. The `drawingmodechanged` event is used to determine when the user is switching into a drawing mode, and clears the drawing canvas.
 
+<br/>
+
 <iframe height="500" style="width: 100%;" scrolling="no" title="Draw and search in polygon area" src="https://codepen.io/azuremaps/embed/eYmZGNv?height=500&theme-id=default&default-tab=js,result" frameborder="no" allowtransparency="true" allowfullscreen="true">
   See the Pen <a href='https://codepen.io/azuremaps/pen/eYmZGNv'>Draw and search in polygon area</a> by Azure Maps
   (<a href='https://codepen.io/azuremaps'>@azuremaps</a>) on <a href='https://codepen.io'>CodePen</a>.
@@ -61,6 +67,8 @@ The following code shows how to perform a search for points of interests inside
 
 The following code shows how the drawing events can be used to create a measuring tool. The `drawingchanging` is used to monitor the shape as it is being drawn. As the user moves the mouse, the dimensions of the shape are calculated. The `drawingcomplete` event is used to do a final calculation on the shape after it has been drawn. The `drawingmodechanged` event is used to determine when the user is switching into a drawing mode, and clears the drawing canvas and old measurement information.
 
+<br/>
+
 <iframe height="500" style="width: 100%;" scrolling="no" title="Measuring tool" src="https://codepen.io/azuremaps/embed/RwNaZXe?height=500&theme-id=default&default-tab=js,result" frameborder="no" allowtransparency="true" allowfullscreen="true">
   See the Pen <a href='https://codepen.io/azuremaps/pen/RwNaZXe'>Measuring tool</a> by Azure Maps
   (<a href='https://codepen.io/azuremaps'>@azuremaps</a>) on <a href='https://codepen.io'>CodePen</a>.
@@ -70,6 +78,14 @@ The following code shows how the drawing events can be used to create a measurin
 
 ## Next steps
 
+Learn how to use additional features of the drawing tools module:
+
+> [!div class="nextstepaction"]
+> [Get shape data](map-get-shape-data.md)
+
+> [!div class="nextstepaction"]
+> [Interaction types and keyboard shortcuts](drawing-tools-interactions-keyboard-shortcuts.md)
+
 Learn more about the Services module:
 
 > [!div class="nextstepaction"]

articles/azure-maps/glossary.md

@@ -1,6 +1,6 @@
 ---
 title: Azure Maps Glossary | Microsoft Docs 
-description: A glossary of commonly used terms associated with Azure Maps, Location Based Services and GIS. 
+description: A glossary of commonly used terms associated with Azure Maps, Location Based Services, and GIS. 
 author: rbrundritt
 ms.author: richbrun
 ms.date: 09/18/2018
@@ -34,21 +34,23 @@ The following is a list of common words used with Azure Maps.
 
 <a name="application-programming-interface-api"></a> **Application Programming Interface (API)**: A specification that allows developers to create applications.
 
-<a name="api-key"></a> **API key**: See Azure Maps Key.
+<a name="api-key"></a> **API key**: See [Shared key authentication](#shared-key-authentication).
 
 <a name="area-of-interest-aoi"></a> **Area of Interest (AOI)**: The extent used to define a focus area for either a map or database production.
 
 <a name="asset-tracking"></a> **Asset tracking**: The process of tracking the location of an asset such as a person, vehicle, or some other object.
 
-<a name="asynchronous-request"></a> **Asynchronous request**: An HTTP request that opens a connection and makes a request to the server which returns an identifier for the asynchronous request, then closes the connection. The server continues to process the request and the user can check the status using the identifier. When the request is finished processing, the user can then download the response. This type of request is usually used for long running processes.
+<a name="asynchronous-request"></a> **Asynchronous request**: An HTTP request that opens a connection and makes a request to the server that returns an identifier for the asynchronous request, then closes the connection. The server continues to process the request and the user can check the status using the identifier. When the request is finished processing, the user can then download the response. This type of request is used for long running processes.
 
 <a name="autocomplete"></a> **Autocomplete**: A feature in an application predicts the rest of a word a user is typing. 
 
 <a name="autosuggest"></a> **Autosuggest**: A feature in an application the predicts logical possibilities for what the user is typing.
 
 <a name="azure-location-based-services-lbs"></a> **Azure Location Based Services (LBS)**: The former name of Azure Maps when it was in preview.
 
-<a name="azure-maps-key"></a> **Azure Maps key**: An Azure Maps Key is a unique string that is used to authenticate a user’s Azure Maps application or service request. 
+<a name="azure-active-directory"></a> **Azure Active Directory (Azure AD)**: Azure AD is Microsoft’s cloud-based identity and access management service. Azure Maps Azure AD integration is currently available in preview for all Azure Maps APIs. Azure AD supports role-based access control (RBAC) to allow fine-grained access to Azure Maps resources. To learn more about Azure Maps Azure AD integration, see [Azure Maps and Azure AD](azure-maps-authentication.md) and [Manage authentication in Azure Maps](how-to-manage-authentication.md).
+
+<a name="azure-maps-key"></a> **Azure Maps key**: See [Shared key authentication](#shared-key-authentication).
 
 ## B
 
@@ -156,7 +158,7 @@ The following is a list of common words used with Azure Maps.
 
 <a name="geodesic-path"></a> **Geodesic path**: The shortest path between two points on a curved surface. When rendered on Azure Maps this path appears as a curved line due to the Mercator projection.
 
-<a name="geofence"></a> **Geofence**: A defined geographical region which can be used to trigger events when a device enters or exists the region.
+<a name="geofence"></a> **Geofence**: A defined geographical region that can be used to trigger events when a device enters or exists the region.
 
 <a name="geojson"></a> **GeoJSON**: Is a common JSON-based file format used for storing geographical vector data such as points, lines, and polygons. **Note**: Azure Maps uses an extended version of GeoJSON as [documented here](extend-geojson.md).
 
@@ -210,7 +212,7 @@ The following is a list of common words used with Azure Maps.
 
 ## L
 
-<a name="landsat"></a> **Landsat**: Multispectral, earth-orbiting satellites developed by NASA that gather imagery of land which is used in many industries such as agriculture, forestry, and cartography.
+<a name="landsat"></a> **Landsat**: Multispectral, earth-orbiting satellites developed by NASA that gather imagery of land that is used in many industries such as agriculture, forestry, and cartography.
 
 <a name="latitude"></a> **Latitude**: The angular distance measured in degrees from equator in a north or south direction.
 
@@ -280,6 +282,8 @@ The following is a list of common words used with Azure Maps.
 
 <a name="postal-code"></a> **Postal code**: A series of letters or numbers, or both, in a specific format, used by the postal service of a country/region to divide geographic areas into zones in order to simplify delivery of mail.
 
+<a name="primary-key"></a> **Primary key**: The first of two subscriptions keys provided for Azure Maps shared key authentication. See [Shared key authentication](#shared-key-authentication).
+
 <a name="prime-meridian"></a> **Prime meridian**: A line of longitude that represents 0-degrees longitude. Generally, longitude values decrease when traveling in a westerly direction until 180-degrees and increase when traveling in easterly directions to -180-degrees. 
 
 <a name="prj"></a> **PRJ**: A text file that often accompanies a Shapefile file that contains information about the projected coordinate system the data set is in.
@@ -324,10 +328,14 @@ The following is a list of common words used with Azure Maps.
 
 <a name="satellite-imagery"></a> **Satellite imagery**: Imagery that has been captured by planes and satellites pointing straight down.
 
-<a name="software-development-kit-sdk"></a> **Software development kit (SDK)**: A collection of documentation, sample code, and sample apps to help a developer use an API to build apps.
+<a name="secondary-key"></a> **Secondary key**: The second of two subscriptions keys provided for Azure Maps shared key authentication. See [Shared key authentication](#shared-key-authentication).
 
 <a name="shapefile-shp"></a> **Shapefile (SHP)**: Also known as an ESRI Shapefile, is a vector data storage format for storing the location, shape, and attributes of geographic features. A shapefile is stored in a set of related files.
 
+<a name="shared-key-authentication"></a> **Shared key authentication**: Shared Key authentication relies on passing Azure Maps account generated keys with each request to Azure Maps. These keys are often referred to as subscription keys. It is recommend that keys are regularly regenerated for security. Two keys are provided so that you can maintain connections using one key while regenerating the other. When you regenerate your keys, you must update any applications that access this account to use the new keys. To learn more about Azure Maps authentication, see [Azure Maps and Azure AD](azure-maps-authentication.md) and [Manage authentication in Azure Maps](how-to-manage-authentication.md).
+
+<a name="software-development-kit-sdk"></a> **Software development kit (SDK)**: A collection of documentation, sample code, and sample apps to help a developer use an API to build apps.
+
 <a name="spherical-mercator-projection"></a> **Spherical Mercator projection**: See [Web Mercator](#web-mercator). 
 
 <a name="spatial-query"></a> **Spatial query**: A request made to a service that performs a spatial operation. Such as a radial search, or along a route search.
@@ -336,6 +344,8 @@ The following is a list of common words used with Azure Maps.
 
 <a name="sql-spatial"></a> **SQL spatial**: Refers to the spatial functionality built into SQL Azure and SQL Server 2008 and above. This spatial functionality is also available as a .NET library that can be used independently of SQL Server. For more information, see the [Spatial Data (SQL Server) documentation](https://docs.microsoft.com/sql/relational-databases/spatial/spatial-data-sql-server) for more information.
 
+<a name="subscription-key"></a> **Subscription key**: See [Shared key authentication](#shared-key-authentication).
+
 <a name="synchronous-request"></a> **Synchronous request**: An HTTP request opens a connection and waits for a response. Browsers limit the number of concurrent HTTP requests that can be made from a page. If multiple long running synchronous requests are made at the same time, this limit can be reached and requests delayed until one of the other requests has completed.
 
 ## T
@@ -348,7 +358,7 @@ The following is a list of common words used with Azure Maps.
 
 <a name="thematic-maps"></a> **Thematic maps**: A thematic map is a simple map made to reflect a theme about a geographic area. A common scenario for this type of map is to color the administrative regions such as countries/regions based on some metric of data.
 
-<a name="tile-layer"></a> **Tile layer**: A layer displayed by assembling map tiles (rectangular sections) into a continuous layer. The tiles are either raster image tiles or vector tiles. Raster tile layers are typically rendered ahead of time and stored as images on a server. This can take up a lot of storage space. Vector tile layers are rendered on the fly within the client application, thus the server side storage requirements are smaller.
+<a name="tile-layer"></a> **Tile layer**: A layer displayed by assembling map tiles (rectangular sections) into a continuous layer. The tiles are either raster image tiles or vector tiles. Raster tile layers are typically rendered ahead of time and stored as images on a server. This can take up a lot of storage space. Vector tile layers are rendered on the fly within the client application, thus the server-side storage requirements are smaller.
 
 <a name="time-zone"></a> **Time zone**: A region of the globe that observes a uniform standard time for legal, commercial, and social purposes. Time zones tend to follow the boundaries of countries/regions and their subdivisions.
 
@@ -383,7 +393,7 @@ The following is a list of common words used with Azure Maps.
 
 <a name="web-map-service-wms"></a> **Web Map Service (WMS)**: WMS is an Open Geographic Consortium (OGC) standard that defines image-based map services. WMS services provide map images for specific areas within a map on demand. Images include pre-rendered symbology and may be rendered in one of several named styles if defined by the service.
 
-<a name="web-mercator"></a> **Web Mercator**: Also known as Spherical Mercator Projection is a slight variant of the Mercator projection, one used primarily in Web-based mapping programs. It uses the same formulas as the standard Mercator projection as used for small-scale maps. However, the Web Mercator uses the spherical formulas at all scales whereas large-scale Mercator maps normally use the ellipsoidal form of the projection. The discrepancy is imperceptible at the global scale but causes maps of local areas to deviate slightly from true ellipsoidal Mercator maps at the same scale.
+<a name="web-mercator"></a> **Web Mercator**: Also known as Spherical Mercator projection is a slight variant of the Mercator projection, one used primarily in Web-based mapping programs. It uses the same formulas as the standard Mercator projection as used for small-scale maps. However, the Web Mercator uses the spherical formulas at all scales whereas large-scale Mercator maps normally use the ellipsoidal form of the projection. The discrepancy is imperceptible at the global scale but causes maps of local areas to deviate slightly from true ellipsoidal Mercator maps at the same scale.
 
 <a name="wgs84"></a> **WGS84**: A set of constants used to relate spatial coordinates to locations on the surface of the map. The WGS84 datum is the standard one used by most online mapping providers and GPS devices. Azure Maps uses the [EPSG:3857](https://epsg.io/3857) coordinate reference system variant of WGS84.
 

articles/azure-maps/how-to-use-map-control.md

@@ -206,6 +206,26 @@ Here is an example of Azure Maps with the language set to "fr-FR" and the region
 
 A complete list of supported languages and regional views is documented [here](supported-languages.md).
 
+## Azure Government cloud support
+
+The Azure Maps Web SDK supports the Azure Government cloud. All JavaScript and CSS URLs used to access the Azure Maps Web SDK remain the same, however the following tasks will need to be done to connect to the Azure Government cloud version of the Azure Maps platform.
+
+When using the interactive map control, add the following line of code before creating an instance of the `Map` class. 
+
+```javascript
+atlas.setDomain('atlas.azure.us');
+```
+
+Be sure to use an Azure Maps authentication details from the Azure Government cloud platform when authenticating the map and services.
+
+When using the services module, the domain for the services needs to be set when creating an instance of an API URL endpoint. For example, the following code creates an instance of the `SearchURL` class and points the domain to the Azure Government cloud.
+
+```javascript
+var searchURL = new atlas.service.SearchURL(pipeline, 'atlas.azure.us');
+```
+
+If directly accessing the Azure Maps REST services, change the URL domain to `atlas.azure.us`. For example, if using the search API service, change the URL domain from `https://atlas.microsoft.com/search/` to `https://atlas.azure.us/search/`.
+
 ## Next steps
 
 Learn how to create and interact with a map: