added readme and sc

Author: shubham7109

find-route/README.md

@@ -1 +1,35 @@
-# Find route
+# Find route
+
+Display directions for a route between two points.
+
+![Image of find route](find-route.png)
+
+## Use case
+
+Find routes with driving directions between any number of locations. You might use the ArcGIS platform to create a custom network for routing on a private roads.
+
+## How to use the sample
+
+For simplicity, the sample comes loaded with a start and end stop. You can tap on the floating action button to display a route between these stops. Once the route is generated, turn-by-turn directions are shown in an expandable bottom sheet. Tap on a direction to zoom to that portion of the route.
+
+## How it works
+
+1. Create a `RouteTask` using a URL to an online route service.
+2. Generate default `RouteParameters` using `routeTask.createDefaultParameters()`.
+3. Set `returnDirections` on the parameters to true.
+4. Add `Stop`s to the parameters `stops` collection for each destination.
+5. Solve the route using `routeTask.solveRoute(routeParameters)` to get a `RouteResult`.
+6. Iterate through the result's `Route`s. To display the route, create a graphic using the geometry from `route.routeGeometry`. To display directions, use `route.directionManeuvers`, and for each `DirectionManeuver`, display `DirectionManeuver.directionText`.
+
+## Relevant API
+
+* DirectionManeuver
+* Route
+* RouteParameters
+* RouteResult
+* RouteTask
+* Stop
+
+## Tags
+
+directions, driving, navigation, network, network analysis, route, routing, shortest path, turn-by-turn

find-route/README.metadata.json

@@ -1,2 +1,42 @@
 {
-}
+    "category": "Routing and Logistics",
+    "description": "Display directions for a route between two points.",
+    "formal_name": "FindRoute",
+    "ignore": false,
+    "images": [
+        "find-route.png"
+    ],
+    "keywords": [
+        "directions",
+        "driving",
+        "navigation",
+        "network",
+        "network analysis",
+        "route",
+        "routing",
+        "shortest path",
+        "turn-by-turn",
+        "DirectionManeuver",
+        "Route",
+        "RouteParameters",
+        "RouteResult",
+        "RouteTask",
+        "Stop"
+    ],
+    "language": "kotlin",
+    "redirect_from": [
+        "/android/latest/sample-code/find-route.htm"
+    ],
+    "relevant_apis": [
+        "DirectionManeuver",
+        "Route",
+        "RouteParameters",
+        "RouteResult",
+        "RouteTask",
+        "Stop"
+    ],
+    "snippets": [
+        "src/main/java/com/esri/arcgismaps/sample/findroute/MainActivity.kt"
+    ],
+    "title": "Find route"
+}

find-route/find-route.png

@@ -47,8 +47,6 @@ import com.arcgismaps.mapping.view.Graphic
 import com.arcgismaps.mapping.view.GraphicsOverlay
 import com.arcgismaps.mapping.view.MapView
 import com.arcgismaps.tasks.networkanalysis.DirectionManeuver
-import com.arcgismaps.tasks.networkanalysis.Route
-import com.arcgismaps.tasks.networkanalysis.RouteParameters
 import com.arcgismaps.tasks.networkanalysis.RouteResult
 import com.arcgismaps.tasks.networkanalysis.RouteTask
 import com.arcgismaps.tasks.networkanalysis.Stop
@@ -133,6 +131,8 @@ class MainActivity : AppCompatActivity() {
      * and displays a graphic of the route on the map.
      */
     private suspend fun solveRoute() {
+        // set the applicationContext as it is required with RouteTask
+        ArcGISEnvironment.applicationContext = this@MainActivity
         // create a route task instance
         val routeTask =
             RouteTask(
@@ -143,7 +143,7 @@ class MainActivity : AppCompatActivity() {
         mainProgressBar.visibility = View.VISIBLE
         routeTask.createDefaultParameters().onSuccess { routeParams ->
             // create stops
-            val stops = arrayListOf(
+            val stops = listOf(
                 Stop(Point(-117.1508, 32.7411, SpatialReference.wgs84())),
                 Stop(Point(-117.1555, 32.7033, SpatialReference.wgs84()))
             )