Merge branch 'master' into dev

Author: tschie

display_information/add-graphics-with-renderer/README.md

@@ -1,29 +1,39 @@
-# Add Graphics with Renderer
+# Add graphics with renderer
 
-Specify a graphic's symbol with a renderer.
+A renderer allows you to change the style of all graphics in a graphics overlay by referencing a single symbol style. A renderer will only effect graphics that do not specify their own symbol style.
 
-A renderer allows you to change the style of all graphics in an overlay by only changing one copy of the symbol. A renderer will only effect graphics that do not specify their own symbol.
+![Image of adding graphics with renderer](AddGraphicsWithRenderer.png)
 
-![](AddGraphicsWithRenderer.png)
+## Use case
 
-## How it works
+A renderer allows you to change the style of all graphics in an overlay by only changing one copy of the symbol. For example, a user may wish to display a number of graphics on a map of parkland which represent trees, all sharing a common symbol.
+
+## How to use the sample
 
-To show a `Graphic` in a `GraphicsOverlay` using a renderer:
+Run the sample and view graphics for points, lines, and polygons, which are stylized using renderers.
+
+## How it works
 
-1. Create a `GraphicsOverlay` and add it to the `MapView`
-2. Create a `Graphic`, specifying only its geometry
-3. Create a single `Symbol` such as a `SimpleMarkerSymbol`
-4. Create a renderer with the symbol such as `new SimpleRenderer(symbol)`
-5. Set the renderer on the graphics overlay with `graphicsOverlay.setRenderer(renderer)`
+1. Create a `GraphicsOverlay` and add it to the `MapView`.
+2. Create a `Graphic`, specifying only a `Geometry`.
+3. Create a single `Symbol` such as a `SimpleMarkerSymbol`.
+4. Create a renderer with the symbol, such as `new SimpleRenderer(symbol)`.
+5. Set the renderer on the graphics overlay with `graphicsOverlay.setRenderer(renderer)`.
 
 ## Relevant API
 
-* ArcGISMap
+* Geometry
 * Graphic
 * GraphicsOverlay
-* MapView
-* Point
 * SimpleFillSymbol
 * SimpleLineSymbol
 * SimpleMarkerSymbol
 * SimpleRenderer
+
+## Additional information
+
+To set unique symbols across a number of graphics (e.g. showing graphics of individual landmarks) see "Add graphics with symbols" sample.
+
+## Tags
+
+display, graphics, marker, overlay, renderer, symbol

display_information/add-graphics-with-symbols/README.md

@@ -1,45 +1,38 @@
-# Add Graphics with Symbols
+# Add graphics with symbols
 
-Draw simple graphics with marker, line, polygon, and text symbols.
+Use a symbol style to display a graphic on a graphics overlay.
 
-![](AddGraphicsWithSymbols.png)
+![Image of adding graphics with symbols](AddGraphicsWithSymbols.png)
+
+## Use case
+
+Allows you to customize a graphic by assigning a unique symbol. For example, you may wish to display individual graphics for different landmarks across a region, and to style each one with a unique symbol.  
+
+## How to use the sample
+
+Pan and zoom around the map. Observe the graphics on the map.
 
 ## How it works
 
-To display a `Graphic` using a symbol:
-
-1. Create a `GraphicsOverlay` and add it to the `MapView`, `MapView.getGraphicsOverlay.add()`.
-2. To create a graphic using a `SimpleMarkerSymbol`.
-    * create a `Point` where the graphic will be located
-    * create a simple marker symbol that will display at that point
-    * assign point and symbol to graphic, `Graphic(point, symbol)`
-3. To create a graphic using a `SimpleLineSymbol`.
-    * create a `PointCollection` that will hold all the points that make up the line
-    * create a `Polyline` using the point collection, `Polyline(PointCollection)`
-    * create a simple line symbol that will display over those collected points
-    * assign polyline and symbol to graphic, `Graphic(polyline, symbol)`
-4. To create a graphic using a `SimepleFillSymbol`.
-    * create a point collection that will hold all the points that make up the line
-    * create a `Polygon` using the point collection, `Polygon(PointCollection)`
-    * create a simple line symbol that will display as an outline for points collected
-    * create a simeple fill symbol, using line symbol from above, that will fill the region in between the points collected with a single color
-    * assign polygon and symbol to graphic, `Graphic(polygon, symbol)`
-5. To create a graphic using a `TextSymbol`.
-    * create a point where the graphic will be located
-    * create a text symbol, that will display at that point
-    * assign point and symbol to graphic, `Graphic(point, symbol)`
-6. Add graphic to graphics overlay to display it to the map view.
+1. Create a `GraphicsOverlay` and add it to the `MapView`.
+2. Create a `Symbol` such as `SimpleMarkerSymbol`, `SimpleLineSymbol`, `SimpleFillSymbol` or `TextSymbol`.
+3. Create a `Graphic`, specifying a `Geometry` and a symbol.
+4. Add the graphic to the graphics overlay.
 
 ## Relevant API
 
+* Geometry
 * Graphic
 * GraphicsOverlay
-* MapView
-* Point
-* PointCollection
-* Polygon
-* Polyline
-* SimepleFillSymbol
+* SimpleFillSymbol
 * SimpleLineSymbol
 * SimpleMarkerSymbol
 * TextSymbol
+
+## Additional information
+
+To set a symbol style across a number of graphics (e.g. showing trees as graphics sharing a symbol in a park), see the "Add graphics with renderer" sample. 
+
+## Tags
+
+display, fill, graphics, line, marker, overlay, point, symbol

display_information/control-annotation-sublayer-visibility/README.md

@@ -1,33 +1,40 @@
 # Control annotation sublayer visibility
 
-Change the visibility of annotation sublayers.
+Use annotation sublayers to gain finer control of annotation layer subtypes.
 
-![Control annotation sublayer visibility sample](ControlAnnotationSublayerVisibility.png)
+![Image of control annotation sublayer visibility](ControlAnnotationSublayerVisibility.png)
 
 ## Use case
 
-An annotation layer for water utilities may contain sublayers for water mains, pipes, and valves. One might turn off the visibility of water main and pipe sublayers to make the valves easier to identify.
+Annotation, which differs from labels by having a fixed place and size, is typically only relevant at particular scales. Annotation sublayers allow for finer control of annotation by allowing properties (like visibility in the map and legend) to be set and others to be read (like name) on subtypes of an annotation layer.
+
+An annotation dataset which marks valves as "Opened" or "Closed", might be set to display the "Closed" valves over a broader range of scales than the "Opened" valves, if the "Closed" data is considered more relevant by the map's author. Regardless, the user can be given a manual option to set visibility of annotation sublayers on and off, if required.
 
 ## How to use the sample
 
-Zoom in to change the map's scale. The annotation sublayers were authored so that the "Open" sublayer will be visible for scales 1:500-1:2000 and the "Closed" sublayer is always visible. Use the checkboxes to toggle a sublayer's visibility.
+Start the sample and take note of the visibility of the annotation. Zoom in and out to see the annotation turn on and off based on scale ranges set on the data.
+
+Use the checkboxes to manually set "Open" and "Closed" annotation sublayers visibility to on or off.
 
 ## How it works
 
-1. Load a `MobileMapPackage` containing annotation layers.
-2. Get the `AnnotationSublayer` from the `Annotation Layer` of the mobile map package.
-3. Set the annotation sublayer's visibility as required.
+1. Load a `MobileMapPackage` that contains `AnnotationSublayer`.
+2. Get the sublayers from the map package's layers by calling `Layer.getSubLayerContents.get(i)`.
+3. You can toggle the visibility of each sublayer manually using `.setVisible()`.
+4. To determine if a sublayer is visible at the current scale of the `MapView`, use `sublayer.isVisibleAtScale()`, by passing in the map's current scale.
 
 ## Relevant API
 
 * AnnotationLayer
 * AnnotationSublayer
 * LayerContent
 
-## Additional Information
+## About the data
 
-Annotation, which differs from labels by having a fixed place and size, is typically only relevant at particular scales. Annotation sublayers allow for finer control of annotation by allowing properties (e.g. visibility in the map and legend) to be set and others to be read (e.g. name) on subtypes of an annotation layer.
+ The scale ranges were set by the map's author using ArcGIS Pro:
+* The "Open" annotation sublayer has its maximum scale set to 1:500 and its minimum scale set to 1:2000.
+* The "Closed" annotation sublayer has no minimum or maximum scales set, so will be drawn at all scales.
 
 ## Tags
 
-scale, text, utilities
+annotation, scale, text, utilities, visualization

display_information/dictionary-renderer-graphics-overlay/README.md

@@ -1,27 +1,28 @@
 # Dictionary renderer with graphics overlay
 
-Display mil2525d symbols.
+Create graphics using a local mil2525d style file and an XML file with key/value pairs for each graphic.
 
-![Dictionary Renderer Graphics Overlay Sample](DictionaryRendererGraphicsOverlay.png)
+![Image of dictionary renderer graphics overlay](DictionaryRendererGraphicsOverlay.png)
 
 ## Use case
 
 Use a dictionary renderer on a graphics overlay to display more transient data, such as military messages coming through a local tactical network.
 
 ## How to use the sample
 
-Pan and zoom to see military symbols within the map.
+Run the sample and view the military symbols on the map.
 
 ## How it works
 
-1. Create a new `DictionarySymbolStyle` from a stylx file.
-2. Create a new `DictionaryRenderer` from the dictionary symbol style.
-3. Create a new `GraphicsOverlay` and set the  dictionary renderer to the graphics overlay.
-4. Parse through the local XML file creating a map of key/value pairs for each block of attributes.
-5. Create a `Graphic` for each attribute:
-    1. Use the `_wkid` key to get the geometry's spatial reference.
-    2. Use the `_control_points` key to get the geometry's shape.
-6. Add the graphic to the graphics overlay.
+1. Create a new `SymbolDictionary(specificationType, dictionaryPath)`.
+2. Create a new `DictionaryRenderer(symbolDictionary)`.
+3. Create a new `GraphicsOverlay`
+4. Set the  dictionary renderer to the graphics overlay.
+5. Parse through the local XML file creating a map of key/value pairs for each block of attributes.
+6. Create a `Graphic` for each attribute.
+7. Use the `_wkid` key to get the geometry's spatial reference.
+8. Use the `_control_points` key to get the geometry's shape.
+9. Add the graphic to the graphics overlay.
 
 ## Relevant API
 
@@ -31,4 +32,4 @@ Pan and zoom to see military symbols within the map.
 
 ## Tags
 
-dictionary renderer, dictionary symbol style, military, symbol
+visualization

display_information/display-grid/README.md

@@ -1,22 +1,25 @@
-# Display Grid
+# Display grid
 
-Display a variety of grids on a map.
+Display coordinate system grids including Latitude/Longitude, MGRS, UTM and USNG on a map view. Also, toggle label visibility and change the color of grid lines and grid labels.
 
-![](DisplayGrid.png)
+![Image of display grid](DisplayGrid.png)
+
+## Use case
+
+Grids are often used on printed maps, but can also be helpful on digital maps, to identify locations on a map.
 
 ## How to use the sample
 
-Select the different grid style options and click "Update" to set the grid.
+Use the controls to select the type of grid from `Grid Type` (LatLong, MGRS, UTM and USNG), and to modify its properties like label visibility, grid line color, and grid label color. Click the 'Update' button to see the result.
 
-## How it works
 
-To show and style a grid:
+## How it works
 
 1. Create an instance of one of the `Grid` types.
-2. Grid lines and labels can be styled per grid level with `grid.setLineSymbol(gridLevel, lineSymbol)` and `grid.setTextSymbol(gridLevel, textSymbol)`.
-3. The label position can be set with `grid.setLabelPosition(labelPosition)`.
+2. Grid lines and labels can be styled per grid level with `setLineSymbol(gridLevel, lineSymbol)` and `setTextSymbol(gridLevel, textSymbol)` methods on the grid.
+3. The label position can be set with `setLabelPosition(labelPosition)` method on the grid.
 4. For the `LatitudeLongitudeGrid` type, you can specify a label format of `DECIMAL_DEGREES` or `DEGREES_MINUTES_SECONDS`.
-5. To set the grid, use `mapView.setGrid(grid)`.
+5. To set the grid, use the `setGrid(grid)` method on the map view.
 
 ## Relevant API
 
@@ -29,3 +32,7 @@ To show and style a grid:
 * TextSymbol
 * UsngGrid
 * UtmGrid
+
+## Tags
+
+coordinates, degrees, graticule, grid, latitude, longitude, MGRS, minutes, seconds, USNG, UTM

display_information/format-coordinates/README.md

@@ -1,30 +1,27 @@
-# Format Coordinates
+# Format coordinates
 
-Write coordinates in a variety of common formats.
+Format coordinates in a variety of common notations.
 
-Convert a map location Point in WGS84 to a String in a number of different coordinate notations (and vice versa) including decimal degrees; degrees, minutes, seconds; Universal Transverse Mercator (UTM), and United States National Grid (USNG).
+![Image of format coordinates](FormatCoordinates.png)
 
-![](FormatCoordinates.png)
+## Use case
+
+The coordinate formatter can format a map location in WGS84 in a number of common coordinate notations. Parsing one of these formats to a location is also supported. Formats include decimal degrees; degrees, minutes, seconds; Universal Transverse Mercator (UTM), and United States National Grid (USNG).
 
 ## How to use the sample
 
-Click on the map to see a callout with the clicked location's coordinate formatted in 4 different ways. You can also put a coordinate string in any of these formats in the text field. Hit Enter and the coordinate string will be converted to a map location which the callout will move to.
+Click on the map to see a callout with the clicked location's coordinate formatted in 4 different ways. You can also put a coordinate string in any of these formats in the text field. Hit 'Enter' and the coordinate string will be parsed to a map location which the callout will move to.
 
 ## How it works
 
-To convert between a `Point` and different coordinate formats using the
-`CoordinateFormatter`:
-
 1. Get or create a map `Point` with a spatial reference.
-2. Use one of the static "to" methods on `CoordinateFormatter` such as
-  `CoordinateFormatter.toLatitudeLongitude(point, CoordinateFormatter.LatitudeLongitudeFormat.DECIMAL_DEGREES,4)` to get the formatted string`.
+2. Use one of the static "to" methods on `CoordinateFormatter` such as `CoordinateFormatter.toLatitudeLongitude(point, CoordinateFormatter.LatitudeLongitudeFormat.DECIMAL_DEGREES, 4)` to get the formatted string.
 3. To go from a formatted string to a `Point`, use one of the "from" static methods like `CoordinateFormatter.fromUtm(coordinateString, map.getSpatialReference(), CoordinateFormatter.UtmConversionMode.LATITUDE_BAND_INDICATORS)`.
 
 ## Relevant API
 
-* ArcGISMap
-* ArcGISTiledLayer
-* Basemap
-* Callout
 * CoordinateFormatter
-* MapView
+
+## Tags
+
+convert, coordinate, decimal degrees, degree minutes seconds, format, latitude, longitude, USNG, UTM

display_information/identify-graphics/README.md

@@ -1,27 +1,30 @@
-# Identify Graphics
+# Identify graphics
 
-Determine if a graphic was clicked.
+Identify a graphic to get further information about the object.
 
-## How to use the sample
+![Image of identify graphics](IdentifyGraphics.png)
 
-When you click on a graphic on the map, you should see an alert.
+## Use case
 
-![](IdentifyGraphics.png)
+A user may wish to select a graphic on a map to view relevant information about it.
 
-## How it works
+## How to use the sample
 
-To identify a `Graphic` from the `MapView`.
+Select a graphic to identify it. You will see an alert message displayed.
 
-1. Create a `GraphicsOverlay` and add it to the MapView.
-2. Add Graphic along with a `SimpleFillSymbol`.
-3. Add the graphic to the graphics overlay.
-4. Identify the graphics on the specified location, `MapView.identifyGraphicsOverlayAsync(graphicsOverlay, point, tolerance, max results)` method.
+## How it works
+
+1. Use the `.setOnMouseClicked()` method to listen to clicks on a `MapView`. 
+2. When the map view is clicked, use the event to create a `Point` from the location clicked on the map.
+3. Identify the graphic on the map view with `MapView.identifyGraphicsOverlayAsync(graphicsOverlay, pointClicked, tolerance, max results)`.
 
 ## Relevant API
 
 * Graphic
 * GraphicsOverlay
 * MapView
-* PointCollection
-* Polygon
-* SimpleFillSymbol
+* Point
+
+## Tags
+
+graphics, identify