Merge pull request #82 from Esri/PaulAllanSturm/showDeviceLocation

"Show device location" sample

Author: PaulAllanSturm

assets/generated_samples_list.json

@@ -894,11 +894,31 @@
     "category": "Maps",
     "description": "Display your current position on the map, as well as switch between different types of auto pan modes.",
     "ignore": false,
-    "images": [],
-    "keywords": [],
+    "images": [
+      "show_device_location.png"
+    ],
+    "keywords": [
+      "GPS",
+      "compass",
+      "location",
+      "map",
+      "mobile",
+      "navigation",
+      "ArcGISMap",
+      "ArcGISMapView",
+      "LocationDisplay",
+      "LocationDisplay.autoPanMode"
+    ],
     "redirect_from": [],
-    "relevant_apis": [],
-    "snippets": [],
+    "relevant_apis": [
+      "ArcGISMap",
+      "ArcGISMapView",
+      "LocationDisplay",
+      "LocationDisplay.autoPanMode"
+    ],
+    "snippets": [
+      "show_device_location_sample.dart"
+    ],
     "title": "Show device location",
     "key": "show_device_location"
   },

lib/samples/densify_and_generalize_geometry/densify_and_generalize_geometry_sample.dart

@@ -14,6 +14,7 @@
 // limitations under the License.
 //
 
+import 'dart:math';
 import 'package:arcgis_maps/arcgis_maps.dart';
 import 'package:flutter/material.dart';
 
@@ -104,7 +105,11 @@ class _DensifyAndGeneralizeGeometrySampleState
         20.0,
         0.0,
         20.0,
-        View.of(context).viewPadding.bottom / View.of(context).devicePixelRatio,
+        max(
+          20.0,
+          View.of(context).viewPadding.bottom /
+              View.of(context).devicePixelRatio,
+        ),
       ),
       child: Column(
         mainAxisSize: MainAxisSize.min,
@@ -286,10 +291,10 @@ class _DensifyAndGeneralizeGeometrySampleState
 
     // Create a map with a basemap style and an initial viewpoint to show the extent of the polyline.
     final map = ArcGISMap.withBasemapStyle(BasemapStyle.arcGISStreetsNight)
-    ..initialViewpoint = Viewpoint.fromCenter(
-      _originalPolyline.extent.center,
-      scale: 65907,
-    );
+      ..initialViewpoint = Viewpoint.fromCenter(
+        _originalPolyline.extent.center,
+        scale: 65907,
+      );
     _mapViewController.arcGISMap = map;
 
     // Set the ready state variable to true to enable the sample UI.

lib/samples/show_device_location/README.md

@@ -0,0 +1,39 @@
+# Show device location
+
+Display your current position on the map, as well as switch between different types of auto pan modes.
+
+![Image of show device location](show_device_location.png)
+
+## Use case
+
+When using a map within a GIS, it may be helpful for a user to know their own location within a map, whether that's to aid the user's navigation or to provide an easy means of identifying/collecting geospatial information at their location.
+
+## How to use the sample
+
+Tap the "Location Settings" button to open the settings. Toggle "Show Location" to turn on or off the location display. The "Auto-Pan Mode" menu has the following options to control how the viewpoint changes as the location changes:
+
+* Off - Turns off `autoPanMode`.
+* Re-Center - Sets the `autoPanMode` to `recenter`.
+* Navigation - Sets the `autoPanMode` to `navigation`.
+* Compass - Sets the `autoPanMode` to `compassNavigation`.
+
+## How it works
+
+1. Create an `ArcGISMapViewController`.
+2. Get the `LocationDisplay` object from the `locationDisplay` property on the controller.
+3. Use `start()` and `stop()` on the `LocationDisplay` object as necessary.
+
+## Relevant API
+
+* ArcGISMap
+* ArcGISMapViewController
+* LocationDisplay
+* LocationDisplay.autoPanMode
+
+## Additional information
+
+Location permissions are required for this sample.
+
+## Tags
+
+compass, GPS, location, map, mobile, navigation

lib/samples/show_device_location/README.metadata.json

@@ -2,10 +2,30 @@
     "category": "Maps",
     "description": "Display your current position on the map, as well as switch between different types of auto pan modes.",
     "ignore": false,
-    "images": [],
-    "keywords": [],
+    "images": [
+        "show_device_location.png"
+    ],
+    "keywords": [
+        "GPS",
+        "compass",
+        "location",
+        "map",
+        "mobile",
+        "navigation",
+        "ArcGISMap",
+        "ArcGISMapView",
+        "LocationDisplay",
+        "LocationDisplay.autoPanMode"
+    ],
     "redirect_from": [],
-    "relevant_apis": [],
-    "snippets": [],
+    "relevant_apis": [
+        "ArcGISMap",
+        "ArcGISMapView",
+        "LocationDisplay",
+        "LocationDisplay.autoPanMode"
+    ],
+    "snippets": [
+        "show_device_location_sample.dart"
+    ],
     "title": "Show device location"
 }