Merge pull request #102906 from farah-alyasari/report12

Report12

Author: American-Dipper

articles/azure-maps/map-add-shape.md

@@ -13,11 +13,11 @@ ms.custom: codepen
 
 # Add a polygon layer to the map
 
-This article shows you how to render the areas of `Polygon` and `MultiPolygon` feature geometries on the map using a polygon layer. The Azure Maps Web SDK also supports the creation of Circle geometries as defined in the [extended GeoJSON schema](extend-geojson.md#circle). These circles are transformed into polygons when rendered on the map. All feature geometries can also be easily updated if wrapped with the [atlas.Shape](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.shape?view=azure-iot-typescript-latest) class.
+This article shows you how to render the areas of `Polygon` and `MultiPolygon` feature geometries on the map using a polygon layer. The Azure Maps Web SDK also supports the creation of Circle geometries as defined in the [extended GeoJSON schema](extend-geojson.md#circle). These circles are transformed into polygons when rendered on the map. All feature geometries can easily be updated when wrapped with the [atlas.Shape](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.shape?view=azure-iot-typescript-latest) class.
 
 ## Use a polygon layer 
 
-When a polygon layer is connected to a data source and loaded on the map, it renders the area of a `Polygon` and `MultiPolygon` features. The following code shows how to create a polygon, add it to a data source and render it with a polygon layer using the [PolygonLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.polygonlayer?view=azure-iot-typescript-latest) class.
+When a polygon layer is connected to a data source and loaded on the map, it renders the area with `Polygon` and `MultiPolygon` features. To create a polygon, add it to a data source, and render it with a polygon layer using the [PolygonLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.polygonlayer?view=azure-iot-typescript-latest) class.
 
 ```javascript
 //Create a data source and add it to the map.
@@ -42,7 +42,7 @@ map.layers.add(new atlas.layer.PolygonLayer(dataSource, null,{
 }));
 ```
 
-Below is the complete running code sample of the above functionality.
+Below is the complete and running sample of the above code.
 
 <br/>
 
@@ -51,14 +51,14 @@ Below is the complete running code sample of the above functionality.
 
 ## Use a polygon and line layer together
 
-A line layer can be used to render the outline of polygons. The following code sample renders a polygon like the previous example, but now adds a line layer as a second layer connected to the data source.  
+A line layer is used to render the outline of polygons. The following code sample renders a polygon like the previous example, but now adds a line layer. This line layer is a second layer connected to the data source.  
 
 <iframe height='500' scrolling='no' title='Polygon and line layer to add polygon' src='//codepen.io/azuremaps/embed/aRyEPy/?height=500&theme-id=0&default-tab=js,result&embed-version=2&editable=true' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'>See the Pen <a href='https://codepen.io/azuremaps/pen/aRyEPy/'>Polygon and line layer to add polygon</a> by Azure Maps (<a href='https://codepen.io/azuremaps'>@azuremaps</a>) on <a href='https://codepen.io'>CodePen</a>.
 </iframe>
 
 ## Fill a polygon with a pattern
 
-In addition to filling a polygon with a color, an image pattern can also be used. Load an image pattern into the maps image sprite resources and then reference this image with the `fillPattern` property of the polygon layer.
+In addition to filling a polygon with a color, you may use an image pattern to fill the polygon. Load an image pattern into the maps image sprite resources and then reference this image with the `fillPattern` property of the polygon layer.
 
 <br/>
 
@@ -84,7 +84,7 @@ The Polygon layer only has a few styling options. Here is a tool to try them out
 
 ## Add a circle to the map
 
-Azure Maps uses an extended version of the GeoJSON schema that provides a definition for circles as noted [here](extend-geojson.md#circle). A circle can be rendered on the map by creating a `Point` feature that has a `subType` property with a value of `"Circle"` and a `radius` property that has a number that represents the radius in meters. For example:
+Azure Maps uses an extended version of the GeoJSON schema that provides a definition for circles, as noted [here](extend-geojson.md#circle). A circle is rendered on the map by creating a `Point` feature. This `Point` has a `subType` property with a value of `"Circle"` and a `radius` property with a number that represents the radius in meters. 
 
 ```javascript
 {
@@ -100,7 +100,7 @@ Azure Maps uses an extended version of the GeoJSON schema that provides a defini
 }  
 ```
 
-The Azure Maps Web SDK converts these `Point` features into `Polygon` features under the covers and can be rendered on the map using polygon and line layers as shown in the following code sample.
+The Azure Maps Web SDK converts these `Point` features into `Polygon` features. Then, these features are rendered on the map using polygon and line layers as shown in the following code sample.
 
 <br/>
 
@@ -109,7 +109,7 @@ The Azure Maps Web SDK converts these `Point` features into `Polygon` features u
 
 ## Make a geometry easy to update
 
-A `Shape` class wraps a [Geometry](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.data.geometry?view=azure-iot-typescript-latest) or [Feature](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.data.feature?view=azure-iot-typescript-latest) and makes it easy to update and maintain them. A shape can be created by passing in a geometry and a set of properties, or by passing in a feature as shown in the following code.
+A `Shape` class wraps a [Geometry](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.data.geometry?view=azure-iot-typescript-latest) or [Feature](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.data.feature?view=azure-iot-typescript-latest) and makes it easy to update and maintain these features. To instantiate a shape variable, pass a geometry or a set of properties to the shape constructor.
 
 ```javascript
 //Creating a shape by passing in a geometry and a object containing properties.
@@ -119,7 +119,7 @@ var shape1 = new atlas.Shape(new atlas.data.Point[0,0], { myProperty: 1 });
 var shape2 = new atlas.Shape(new atlas.data.Feature(new atlas.data.Point[0,0], { myProperty: 1 });
 ```
 
-The following code sample shows how to wrap a circle GeoJSON object with a shape class and easily update it's radius property using a slider. As the radius value changes in the shape, the rendering of the circle automatically updates on the map.
+The following code sample shows how to wrap a circle GeoJSON object with a shape class. As the value of the radius changes in the shape, the circle renders automatically on the map.
 
 <br/>
 

articles/azure-maps/map-add-tile-layer.md

@@ -13,29 +13,29 @@ ms.custom: codepen
 
 # Add a tile layer to a map
 
-This article shows you how you can overlay a Tile layer on the map. Tile layers allow you to superimpose images on top of Azure Maps base map tiles. More information on Azure Maps tiling system can be found in the [Zoom levels and tile grid](zoom-levels-and-tile-grid.md) documentation.
+This article shows you how to overlay a Tile layer on the map. Tile layers allow you to superimpose images on top of Azure Maps base map tiles. For more information on Azure Maps tiling system, see [Zoom levels and tile grid](zoom-levels-and-tile-grid.md).
 
-A Tile layer loads in tiles from a server. These images can either be pre-rendered and stored like any other image on a server using a naming convention that the tile layer understands, or a dynamic service that generates the images on the fly. There are three different tile service naming conventions supported by Azure Maps [TileLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.tilelayer?view=azure-iot-typescript-latest) class: 
+A Tile layer loads in tiles from a server. These images can either be pre-rendered or dynamically rendered. Pre-rendered images are stored like any other image on a server using a naming convention that the tile layer understands. Dynamically rendered images use a service to load the images close to real time. There are three different tile service naming conventions supported by Azure Maps [TileLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.tilelayer?view=azure-iot-typescript-latest) class: 
 
-* X, Y, Zoom notation - Based on the zoom level, x is the column and y is the row position of the tile in the tile grid.
-* Quadkey notation - Combination x, y, zoom information into a single string value that is a unique identifier for a tile.
-* Bounding Box - Bounding box coordinates can be used to specify an image in the format `{west},{south},{east},{north}` which is commonly used by [Web Mapping Services (WMS)](https://www.opengeospatial.org/standards/wms).
+* X, Y, Zoom notation - X is the column, Y is the row position of the tile in the tile grid, and the Zoom notation a value based on the zoom level.
+* Quadkey notation - Combines x, y, and zoom information into a single string value. This string value becomes a unique identifier for a single tile.
+* Bounding Box -  Specify an image in the Bounding box coordinates format: `{west},{south},{east},{north}`. This format is commonly used by [Web Mapping Services (WMS)](https://www.opengeospatial.org/standards/wms).
 
 > [!TIP]
-> A [TileLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.tilelayer?view=azure-iot-typescript-latest) is a great way to visualize large data sets on the map. Not only can a tile layer be generated from an image, but vector data can also be rendered as a tile layer too. By rendering vector data as a tile layer, the map control only needs to load the tiles which can be much smaller in file size than the vector data they represent. This technique is used by many who need to render millions of rows of data on the map.
+> A [TileLayer](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.layer.tilelayer?view=azure-iot-typescript-latest) is a great way to visualize large data sets on the map. Not only can a tile layer be generated from an image, vector data can also be rendered as a tile layer too. By rendering vector data as a tile layer, map control only needs to load the tiles which are smaller in file size than the vector data they represent. This technique is commonly used to render millions of rows of data on the map.
 
-The tile URL passed into a Tile layer must be an http/https URL to a TileJSON resource or a tile URL template that uses the following parameters: 
+The tile URL passed into a Tile layer must be an http or an https URL to a TileJSON resource or a tile URL template that uses the following parameters: 
 
 * `{x}` - X position of the tile. Also needs `{y}` and `{z}`.
 * `{y}` - Y position of the tile. Also needs `{x}` and `{z}`.
 * `{z}` - Zoom level of the tile. Also needs `{x}` and `{y}`.
 * `{quadkey}` - Tile quadkey identifier based on the Bing Maps tile system naming convention.
 * `{bbox-epsg-3857}` - A bounding box string with the format `{west},{south},{east},{north}` in the EPSG 3857 Spatial Reference System.
-* `{subdomain}` - A placeholder where the subdomain values if specified will be added.
+* `{subdomain}` - A placeholder for the subdomain values, if specified the `subdomain` will be added.
 
 ## Add a tile layer
 
- This sample shows how to create a tile layer that points to a set of tiles that use the x, y, zoom tiling system. The source of this tile layer is a weather radar overlay from the [Iowa Environmental Mesonet of Iowa State University](https://mesonet.agron.iastate.edu/ogc/). When viewing radar data ideally users would be able to clearly see the labels of cities as they navigate the map, which can be done by inserting the tile layer below the `labels` layer.
+ This sample shows how to create a tile layer that points to a set of tiles. This sample uses the x, y, zoom tiling system. The source of this tile layer is a weather radar overlay from the [Iowa Environmental Mesonet of Iowa State University](https://mesonet.agron.iastate.edu/ogc/). When viewing radar data, ideally users would clearly see the labels of cities as they navigate the map. This behavior can be implemented by inserting the tile layer below the `labels` layer.
 
 ```javascript
 //Create a tile layer and add it to the map below the label layer.

articles/azure-maps/map-create.md

@@ -1,6 +1,6 @@
 ---
 title: Create a map with Azure Maps | Microsoft Azure Maps
-description: In this article, you will learn how to render a map on a web page using the Microsoft Azure Maps Web SDK.
+description: In this article, you'll learn how to render a map on a web page using the Microsoft Azure Maps Web SDK.
 author: jingjing-z
 ms.author: jinzh
 ms.date: 07/26/2019
@@ -17,7 +17,7 @@ This article shows you ways to create a map and animate a map.
 
 ## Loading a map
 
-To load a map, create a new instance of the [Map class](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.map?view=azure-iot-typescript-latest). When initializing the map, a DIV element ID to render the map and a set of options to use when loading the map are passed in. If default authentication information isn't specified on the `atlas` namespace, this information will need to be specified in the map options when loading the map. The map loads several resources asynchronously for performance. As such, after creating the map instance, attach a `ready` or `load` event to the map and then add any additional code that interacts with the map in that event handler. The `ready` event fires as soon as the map has enough resources loaded to be interacted with programmatically. The `load` event fires after the initial map view has finished loading completely. 
+To load a map, create a new instance of the [Map class](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.map?view=azure-iot-typescript-latest). When initializing the map, pass a DIV element ID to render the map and pass a set of options to use when loading the map. If default authentication information isn't specified on the `atlas` namespace, this information will need to be specified in the map options when loading the map. The map loads several resources asynchronously for performance. As such, after creating the map instance, attach a `ready` or `load` event to the map and then add any additional code that interacts with the map to the event handler. The `ready` event fires as soon as the map has enough resources loaded to be interacted with programmatically. The `load` event fires after the initial map view has finished loading completely. 
 
 <br/>
 
@@ -27,11 +27,11 @@ To load a map, create a new instance of the [Map class](https://docs.microsoft.c
 </iframe>
 
 > [!TIP]
-> Multiple maps can be loaded on the same page and each one can use the same or different authentication and language settings.
+> You can load multiple maps on the same page. Multiple map on the same page may use the same or different authentication and language settings.
 
 ## Show a single copy of the world
 
-When the map is zoomed out on a wide screen, multiple copies of the world will appear horizontally. This is great for most scenarios, but some for some applications it may be desirable to only see a single copy of the world. This can be done by setting the maps `renderWorldCopies` option to `false`.
+When the map is zoomed out on a wide screen, multiple copies of the world will appear horizontally. This option is great for some scenarios, but for other applications it's desirable to see a single copy of the world. This behavior is implemented by setting the maps `renderWorldCopies` option to `false`.
 
 <br/>
 
@@ -42,13 +42,13 @@ When the map is zoomed out on a wide screen, multiple copies of the world will a
 
 ## Controlling the map camera
 
-There are two ways you can set the displayed area of the map using the camera. You can set camera options such as center, and zoom, when loading the map, or call the `setCamera` option anytime after the map has loaded to programmatically update the map view.  
+There are two ways to set the displayed area of the map using the camera of a map. You can set the camera options when loading the map. Or, you can call the `setCamera` option anytime after the map has loaded to programmatically update the map view.  
 
 <a id="setCameraOptions"></a>
 
 ### Set the camera
 
-In the following code, a [Map object](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.map?view=azure-iot-typescript-latest) is created and the center and zoom options are set. Map properties such as center, and zoom level are part of the [CameraOptions](/javascript/api/azure-maps-control/atlas.cameraoptions).
+In the following code, a [Map object](https://docs.microsoft.com/javascript/api/azure-maps-control/atlas.map?view=azure-iot-typescript-latest) is created and the center and zoom options are set. Map properties, such as center and zoom level, are part of the [CameraOptions](/javascript/api/azure-maps-control/atlas.cameraoptions).
 
 <br/>
 
@@ -68,7 +68,7 @@ In the following code,  a [Map object](https://docs.microsoft.com/javascript/api
 
 ### Animate map view
 
-In the following code, the first code block creates a map and sets the map style, center and zoom values. In the second code block, a click event handler is created for the animate button. When this button is clicked the setCamera function is called with some random values for the [CameraOptions](/javascript/api/azure-maps-control/atlas.cameraoptions), [AnimationOptions](/javascript/api/azure-maps-control/atlas.animationoptions).
+In the following code, the first code block creates a map and sets the enter and zoom map styles. In the second code block, a click event handler is created for the animate button. When this button is clicked, the `setCamera` function is called with some random values for the [CameraOptions](/javascript/api/azure-maps-control/atlas.cameraoptions) and [AnimationOptions](/javascript/api/azure-maps-control/atlas.animationoptions).
 
 <br/>
 
@@ -77,7 +77,7 @@ In the following code, the first code block creates a map and sets the map style
 
 ## Try out the code
 
-Take a look at the sample code above. You can edit the JavaScript code on the **JS tab** on the left and see the map view changes on the **Result tab** on the right. You can also click on the **Edit on CodePen** button and edit the code in CodePen.
+Look at the code samples. You can edit the JavaScript code inside the **JS tab** and see the map view changes on the **Result tab**. You can also click **Edit on CodePen**, in the top-right corner, and modify the code in CodePen.
 
 <a id="relatedReference"></a>
 
@@ -103,4 +103,4 @@ See code examples to add functionality to your app:
 > [Add controls to the map](map-add-controls.md)
 
 > [!div class="nextstepaction"]
-> [Code samples](https://docs.microsoft.com/samples/browse/?products=azure-maps)
+> [Code samples](https://docs.microsoft.com/samples/browse/?products=azure-maps)