Navigate between two points and dynamically recalculate an alternate route when the original route is unavailable.
Use case
While traveling between destinations, field workers use navigation to get live directions based on their locations. In cases where a field worker makes a wrong turn, or if the route suggested is blocked due to a road closure, it is necessary to calculate an alternate route to the original destination.
How to use the sample
Tap "Navigate" to simulate traveling and to receive directions from a preset starting point to a preset destination. Observe how the route is recalculated when the simulation does not follow the suggested route. Tap "Recenter" to reposition the viewpoint. Tap "Reset" to start the simulation from the beginning.
How it works
- Create a
RouteTaskusing local network data. - Generate default
RouteParametersusingRouteTask.createDefaultParametersAsync(). - Set
isReturnRoutes,isReturnStops, andisReturnDirectionson the parameters totrue. - Add
Stops to the parameters' array ofstopsusingRouteParameters.setStops(). - Solve the route using
ARouteTask.solveRouteAsync(routeParameters)to get anRouteResult. - Create an
RouteTrackerusing the route result, and the index of the desired route to take. - Enable rerouting in the route tracker using
RouteTracker.enableReroutingAsync(reroutingParameters). PassRouteTracker.ReroutingStrategy.TO_NEXT_WAYPOINas the value ofstrategyto specify that in the case of a reroute, the new route goes from present location to next waypoint or stop. - Implement
RouteTracker.trackLocationAsync()to track the location of the device and update the route tracking status. - Implement
RouteTracker.TrackingStatusChangedListener()to be notified ofTrackingStatuschanges, and use them to display updated route information.TrackingStatusincludes a variety of information on the route progress, such as the remaining distance, remaining geometry or traversed geometry (represented by anPolyline), or the remaining time (Double), amongst others. - You can also query the tracking status for the current
DirectionManeuverindex by retrieving that maneuver from theRouteand getting its direction text to display in the GUI. - To establish whether the destination has been reached, get the
DestinationStatusfrom the tracking status. If the destination status isDestinationStatus.REACHEDand theDirectionManeuvers.sizeis 1, you have arrived at the destination and can stop routing. If there are several destinations on your route and the remaining destination count is greater than 1, switch the route tracker to the next destination.
Relevant API
- DestinationStatus
- DirectionManeuver
- Location
- LocationDataSource
- ReroutingStrategy
- Route
- RouteParameters
- RouteTask
- RouteTracker
- RouteTrackerLocationDataSource
- SimulatedLocationDataSource
- Stop
- VoiceGuidance
Offline data
- Download the data from ArcGIS Online.
- Extract the contents of the downloaded zip file to disk.
- Open your command prompt and navigate to the folder where you extracted the contents of the data from step 1.
- Execute the following commands:
adb push sandiego.geodatabase /Android/data/com.esri.arcgisruntime.sample.offlinerouting/files/sandiego.geodatabase
| Link | Local Location |
|---|---|
| San Diego Geodatabase | /Android/data/com.esri.arcgisruntime.sample.offlinerouting/files/sandiego.geodatabase |
About the data
The route taken in this sample goes from the San Diego Convention Center, site of the annual Esri User Conference, to the Fleet Science Center, San Diego.
Additional information
The route tracker will start a rerouting calculation automatically as necessary when the device's location indicates that it is off-route. The route tracker also validates that the device is "on" the transportation network. If it is not (e.g. in a parking lot), rerouting will not occur until the device location indicates that it is back "on" the transportation network.
Tags
directions, maneuver, navigation, route, turn-by-turn, voice
Sample Code
MainActivity.kt
/* Copyright 2022 Esri
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package com.esri.arcgisruntime.sample.navigateroutewithrerouting
import android.graphics.Color
import android.os.Bundle
import android.speech.tts.TextToSpeech
import android.util.Log
import android.widget.Button
import android.widget.TextView
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.esri.arcgisruntime.ArcGISRuntimeEnvironment
import com.esri.arcgisruntime.geometry.Geometry
import com.esri.arcgisruntime.geometry.Point
import com.esri.arcgisruntime.geometry.Polyline
import com.esri.arcgisruntime.geometry.SpatialReferences
import com.esri.arcgisruntime.loadable.LoadStatus
import com.esri.arcgisruntime.location.SimulatedLocationDataSource
import com.esri.arcgisruntime.location.SimulationParameters
import com.esri.arcgisruntime.mapping.ArcGISMap
import com.esri.arcgisruntime.mapping.BasemapStyle
import com.esri.arcgisruntime.mapping.view.Graphic
import com.esri.arcgisruntime.mapping.view.GraphicsOverlay
import com.esri.arcgisruntime.mapping.view.LocationDisplay
import com.esri.arcgisruntime.mapping.view.MapView
import com.esri.arcgisruntime.navigation.DestinationStatus
import com.esri.arcgisruntime.navigation.ReroutingParameters
import com.esri.arcgisruntime.navigation.RouteTracker
import com.esri.arcgisruntime.navigation.TrackingStatus
import com.esri.arcgisruntime.sample.navigateroutewithrerouting.databinding.ActivityMainBinding
import com.esri.arcgisruntime.symbology.SimpleLineSymbol
import com.esri.arcgisruntime.symbology.SimpleMarkerSymbol
import com.esri.arcgisruntime.tasks.networkanalysis.Route
import com.esri.arcgisruntime.tasks.networkanalysis.RouteParameters
import com.esri.arcgisruntime.tasks.networkanalysis.RouteResult
import com.esri.arcgisruntime.tasks.networkanalysis.RouteTask
import com.esri.arcgisruntime.tasks.networkanalysis.Stop
import com.esri.arcgisruntime.tasks.networkanalysis.DirectionManeuver
import java.util.Locale
import java.util.Calendar
import kotlin.math.roundToInt
class MainActivity : AppCompatActivity() {
private val TAG = MainActivity::class.java.simpleName
private val activityMainBinding by lazy {
ActivityMainBinding.inflate(layoutInflater)
}
private val mapView: MapView by lazy {
activityMainBinding.mapView
}
private val navigateButton: Button by lazy {
activityMainBinding.navigateButton
}
private val resetButton: Button by lazy {
activityMainBinding.resetButton
}
private val recenterButton: Button by lazy {
activityMainBinding.recenterButton
}
private val statusMessageTV: TextView by lazy {
activityMainBinding.statusMessageTV
}
// a list to keep track of directions solved by the route task
private val directionManeuvers = mutableListOf<DirectionManeuver>()
// the route task to solve the route between stops, using the online routing service
private lateinit var routeTask: RouteTask
// the route tracker for navigation. Use delegate methods to update tracking status
private var routeTracker: RouteTracker? = null
// the calculated route with direction maneuvers and route geometry
private var route: Route? = null
// the route parameters needed to calculate a route from a start and stop point
private var routeParameters: RouteParameters? = null
// the resulted route from the route task using the route parameters
private var routeResult: RouteResult? = null
// the route ahead denoted with a magenta color line
private var routeAheadGraphic: Graphic? = null
// the route traveled denoted with a black color line
private var routeTraveledGraphic: Graphic? = null
private var textToSpeech: TextToSpeech? = null
// the JSON of polylines of the path for the simulated data source
private val polylineJSON =
"{\"paths\":[[[ -117.160386727066026, 32.706608204740171 ], [ -117.160205336548898, 32.706508733108137 ], [ -117.16002394693011, 32.706409261365152 ], [ -117.159842556412997, 32.706309788755419 ], [ -117.159651667110055, 32.706216667017223 ], [ -117.159454444684357, 32.706127778166461 ], [ -117.159257222258688, 32.706038889227095 ], [ -117.159059999833019, 32.705950000199223 ], [ -117.158902856642044, 32.705835713852132 ], [ -117.158739999267553, 32.705720000231665 ], [ -117.158576363053726, 32.705604545733003 ], [ -117.158417272315205, 32.70549090901352 ], [ -117.158256250198832, 32.705376874547866 ], [ -117.158087499876075, 32.70526125028416 ], [ -117.157918750451643, 32.70514562511471 ], [ -117.1577500001289, 32.705029999795485 ], [ -117.157600000341063, 32.704940000101111 ], [ -117.157425000438906, 32.704823332883613 ], [ -117.157250000536706, 32.704706666269544 ], [ -117.15707875020253, 32.70459250003033 ], [ -117.156909999879787, 32.704480000413547 ], [ -117.156741250455326, 32.704367499899007 ], [ -117.156569643489959, 32.704254999998568 ], [ -117.156393750662403, 32.704142500712138 ], [ -117.156217857834818, 32.70403000128394 ], [ -117.156041965007248, 32.703917501713846 ], [ -117.155866072179691, 32.703805002001992 ], [ -117.155690179352078, 32.703692502148236 ], [ -117.155514286524522, 32.703580002152705 ], [ -117.155338393696923, 32.7034675020153 ], [ -117.155162499971055, 32.703355001736114 ], [ -117.154986607143471, 32.703242501315046 ], [ -117.154810714315886, 32.703130000752203 ], [ -117.154635517682649, 32.703016896826178 ], [ -117.154463104030171, 32.702901379868429 ], [ -117.154290690377692, 32.702785862761147 ], [ -117.154118275826903, 32.702670345504323 ], [ -117.153945862174425, 32.702554828097959 ], [ -117.153773448521946, 32.702439310542076 ], [ -117.153599428681744, 32.702323429238 ], [ -117.153423000458261, 32.702207001250933 ], [ -117.153246571336439, 32.702090573867849 ], [ -117.15307014311297, 32.701974145576926 ], [ -117.152893714889458, 32.701857717134175 ], [ -117.152717285767665, 32.701741289295413 ], [ -117.152540857544182, 32.701624860548854 ], [ -117.152364428422359, 32.701508432406285 ], [ -117.152188000198905, 32.701392003355934 ], [ -117.152011571077097, 32.701275574909566 ], [ -117.151835142853614, 32.701159145555422 ], [ -117.15165871463013, 32.701042716049322 ], [ -117.151482285508337, 32.70092628714734 ], [ -117.151305857284839, 32.700809857337454 ], [ -117.151133333139583, 32.700694999722828 ], [ -117.150966666009978, 32.700582500484039 ], [ -117.150799999778684, 32.700470000347529 ], [ -117.150666666434319, 32.700606666276805 ], [ -117.150550000431735, 32.700739999832187 ], [ -117.150413637069931, 32.700887727693875 ], [ -117.150277272809774, 32.701035455311022 ], [ -117.150140909447984, 32.701183182683579 ], [ -117.150004546086151, 32.70133090905572 ], [ -117.149866667266465, 32.701474445066133 ], [ -117.149727777842074, 32.701615186178799 ], [ -117.149588889315993, 32.701755927069449 ], [ -117.149449999891601, 32.701896667738154 ], [ -117.14931111046721, 32.702037408184886 ], [ -117.149171785359911, 32.702179286074646 ], [ -117.149030713927701, 32.702325715147047 ], [ -117.148889642495448, 32.702472143979179 ], [ -117.148748571063251, 32.702618572571104 ], [ -117.148607499631026, 32.702765000922703 ], [ -117.148466428198816, 32.702911428278099 ], [ -117.148324285076455, 32.703055714638857 ], [ -117.148181427793475, 32.703198572087189 ], [ -117.148038571408776, 32.703341429306768 ], [ -117.147895714125781, 32.703484287053563 ], [ -117.147752856842757, 32.703627143815801 ], [ -117.147609999559762, 32.70377000034928 ], [ -117.147775789035336, 32.703888421897091 ], [ -117.147941578510924, 32.704006842531832 ], [ -117.148107367986498, 32.704125263765263 ], [ -117.148270999708757, 32.704241999926992 ], [ -117.148426000417771, 32.704352000065626 ], [ -117.148584000601517, 32.704464000191109 ], [ -117.148754000480821, 32.704584000655537 ], [ -117.148924000360154, 32.704704000958593 ], [ -117.149094000239444, 32.704824001100256 ], [ -117.149264000118777, 32.704944000324637 ], [ -117.149407499697205, 32.705072500228539 ], [ -117.149343333036455, 32.705169047379755 ], [ -117.14912666657645, 32.705166666300379 ], [ -117.14891000011643, 32.705164285976849 ], [ -117.148693333656425, 32.705161904897288 ], [ -117.148478888730111, 32.70516111120412 ], [ -117.148273333531876, 32.705166666300379 ], [ -117.148064000019531, 32.705171999918136 ], [ -117.147848999934354, 32.705177000184506 ], [ -117.147633999849205, 32.705181999694666 ], [ -117.147418999764071, 32.705186999960468 ], [ -117.147200769337161, 32.705185384606324 ], [ -117.146977692499263, 32.705173846577395 ], [ -117.146754615661365, 32.70516230779107 ], [ -117.146708461120397, 32.705286154077442 ], [ -117.146700768846614, 32.705466923690707 ], [ -117.146693076572859, 32.705647692937767 ], [ -117.146683999995219, 32.705830000815943 ], [ -117.146673999949485, 32.706013334065815 ], [ -117.146663999903751, 32.706196666939007 ], [ -117.146664285567994, 32.70638142881964 ], [ -117.146671428072821, 32.706567143490375 ], [ -117.146678571475945, 32.706752857018657 ], [ -117.146740000071702, 32.706929999956024 ], [ -117.146814999516465, 32.707105000372742 ], [ -117.146889999859525, 32.707279999690257 ], [ -117.146924210400499, 32.70746421055955 ], [ -117.146958420941473, 32.707648421804457 ], [ -117.146992631482419, 32.707832631913085 ], [ -117.147028333226785, 32.708011666927277 ], [ -117.14706999978462, 32.708169999740647 ], [ -117.147123125252193, 32.708315313142343 ], [ -117.147188749878651, 32.708491876248765 ], [ -117.147254375403406, 32.70866843900572 ], [ -117.147320000029879, 32.708845002169127 ], [ -117.14738562465628, 32.709021564227307 ], [ -117.147451250181092, 32.709198125936041 ], [ -117.147516874807508, 32.709374687295316 ], [ -117.14752833371729, 32.709551667052253 ], [ -117.147520000046384, 32.709710000156058 ], [ -117.147520000046384, 32.709893333747829 ], [ -117.147520000046384, 32.710076666962848 ], [ -117.147520000046384, 32.71026200054947 ], [ -117.147520000046384, 32.710448667076598 ], [ -117.147520000046384, 32.710635333213204 ], [ -117.147515909118582, 32.710823182620821 ], [ -117.147509090905601, 32.71101181922716 ], [ -117.147502272692577, 32.711200455434678 ], [ -117.147495454479568, 32.711389091999187 ], [ -117.147485142718423, 32.71157742885061 ], [ -117.14746085676471, 32.711764573341057 ], [ -117.147436571709335, 32.711951716683039 ], [ -117.147412285755621, 32.712138859632439 ], [ -117.147387999801936, 32.712326002189215 ], [ -117.147363713848208, 32.712513145109241 ], [ -117.147339428792819, 32.712700286880825 ], [ -117.147316521753055, 32.712886522016262 ], [ -117.147299130369177, 32.713069131040328 ], [ -117.147281738985257, 32.71325173969052 ], [ -117.147264347601379, 32.713434348722721 ], [ -117.147246956217472, 32.713616956625302 ], [ -117.147232058556796, 32.713802941936294 ], [ -117.147218823677719, 32.713991177701793 ], [ -117.147205587900316, 32.714179413825953 ], [ -117.147192353021239, 32.71436764955282 ], [ -117.147179117243851, 32.714555884126625 ], [ -117.147165882364774, 32.714744119059084 ], [ -117.147152647485697, 32.714932352838417 ], [ -117.147153636530803, 32.715120909708922 ], [ -117.147158182006137, 32.715309546296893 ], [ -117.147162727481486, 32.715498182485916 ], [ -117.147167272956835, 32.715686818275991 ], [ -117.147173404856957, 32.715875319889243 ], [ -117.147181915495963, 32.716063619303895 ], [ -117.147190425236644, 32.716251918321021 ], [ -117.14719893587565, 32.716440216940612 ], [ -117.147207446514642, 32.716628515162668 ], [ -117.147215957153648, 32.716816812987197 ], [ -117.147224467792654, 32.717005110414192 ], [ -117.147232978431632, 32.717193407443645 ], [ -117.147241489070623, 32.717381704075564 ], [ -117.147249999709629, 32.717570000309962 ], [ -117.147249999709629, 32.717738750619532 ], [ -117.147332500087032, 32.717837500042386 ], [ -117.147538750581333, 32.717831250407393 ], [ -117.147756000047934, 32.717830000329201 ], [ -117.147976000155978, 32.717833999974772 ], [ -117.148195999365697, 32.717839000287256 ], [ -117.148399999580192, 32.717848889054309 ], [ -117.148599999596726, 32.717859999933836 ], [ -117.148792857108432, 32.717859999933836 ], [ -117.149002857170714, 32.717855714600553 ], [ -117.149221110953832, 32.717848889054309 ], [ -117.149426667050406, 32.717843333236125 ], [ -117.149629999816653, 32.717840000198528 ], [ -117.149834794141881, 32.717839725846488 ], [ -117.150058766600068, 32.717838356353404 ], [ -117.150282739058298, 32.717836986104565 ], [ -117.150506712414838, 32.717835616611495 ], [ -117.150730684873039, 32.717834246362614 ], [ -117.150954657331255, 32.717832876869451 ], [ -117.151178629789484, 32.71783150662052 ], [ -117.151402602247686, 32.717830137127372 ], [ -117.151626575604226, 32.717828766878398 ], [ -117.151850548062413, 32.717827397385207 ], [ -117.152074520520642, 32.717826027136198 ], [ -117.152298492978844, 32.717824657642915 ], [ -117.152522466335384, 32.717823287393841 ], [ -117.152746438793599, 32.717821917900579 ], [ -117.1529704112518, 32.717820547651478 ], [ -117.153186000631806, 32.717819999702947 ], [ -117.153393000321032, 32.717819999702947 ], [ -117.153598000360432, 32.717819999702947 ], [ -117.153680000376198, 32.717931250560419 ], [ -117.153680000376198, 32.718116667591957 ], [ -117.153680000376198, 32.71830208423809 ], [ -117.153680000376198, 32.718487500498668 ], [ -117.153680000376198, 32.71867291637377 ], [ -117.153680000376198, 32.718853999719613 ], [ -117.153691764713159, 32.719040589315924 ], [ -117.153706471032677, 32.719228825364496 ], [ -117.153721176453885, 32.719417061015754 ], [ -117.153735882773404, 32.719605296269705 ], [ -117.153750588194583, 32.719793531126342 ], [ -117.153765294514116, 32.719981765585658 ], [ -117.153779999935324, 32.720169999647716 ], [ -117.153724444524883, 32.720347777996373 ], [ -117.15365916664814, 32.720522916848374 ], [ -117.153554999804427, 32.720687501074849 ], [ -117.153450833859011, 32.720852084241734 ], [ -117.153346667015299, 32.721016667104912 ], [ -117.153242500171572, 32.721181250420067 ], [ -117.153129999656983, 32.721337142933685 ], [ -117.153004999983494, 32.721480000582972 ], [ -117.152880000310034, 32.721622857247624 ], [ -117.152759999761116, 32.72175500006324 ], [ -117.152636666462485, 32.721883333669965 ], [ -117.152503333118148, 32.722016666414483 ], [ -117.152369999773768, 32.722149999715342 ], [ -117.152266296460738, 32.722315741775319 ], [ -117.152162592249397, 32.722481484282923 ], [ -117.152058888936367, 32.722647225726703 ], [ -117.15195518472504, 32.722812966862485 ], [ -117.151851481411995, 32.722978708445886 ], [ -117.151747778098965, 32.723144448965456 ], [ -117.151644073887638, 32.723310189177035 ], [ -117.151540370574594, 32.723475929836226 ], [ -117.151436666363239, 32.723641669431601 ], [ -117.151332963050237, 32.723807408718947 ], [ -117.151234999971862, 32.72397250002998 ], [ -117.151160000527099, 32.724135000367234 ], [ -117.151080000161144, 32.724297500408319 ], [ -117.150996667045533, 32.724460000153258 ], [ -117.150913333929878, 32.724623889395701 ], [ -117.150829999915885, 32.724793333722438 ], [ -117.150746666800273, 32.724962778482904 ], [ -117.150663333684619, 32.725132222165605 ], [ -117.150569142632122, 32.725297714582261 ], [ -117.150467713853416, 32.725460572230027 ], [ -117.150366285972964, 32.725623430335979 ], [ -117.150264857194259, 32.7257862873888 ], [ -117.150163428415524, 32.725949144144138 ], [ -117.150062000535129, 32.726112000602008 ], [ -117.149960571756395, 32.726274857518128 ], [ -117.149810286304302, 32.726402571732081 ], [ -117.149627428838329, 32.726506857771184 ], [ -117.149444571372356, 32.726611143688253 ], [ -117.149261713906355, 32.726715429483335 ], [ -117.149078857338722, 32.726819715156495 ], [ -117.148895999872721, 32.726924000707605 ], [ -117.148713142406748, 32.727028286136743 ], [ -117.148527500163411, 32.727107499935954 ], [ -117.148341999853869, 32.727179999922392 ], [ -117.148156999905936, 32.727254999741994 ], [ -117.147970000308177, 32.727333332937185 ], [ -117.147782499450514, 32.727412499611347 ], [ -117.147604782144612, 32.727511304068443 ], [ -117.147441738818856, 32.727639565155108 ], [ -117.1472786954931, 32.727767826057253 ], [ -117.147115652167315, 32.727896086774876 ], [ -117.146952608841573, 32.728024347307972 ], [ -117.14683238101891, 32.728179524297857 ], [ -117.146722856622844, 32.728341429031481 ], [ -117.14661333312506, 32.728503334226737 ], [ -117.146503809627319, 32.728665238372294 ], [ -117.146433750018303, 32.728838750495896 ], [ -117.146389999369021, 32.729020001365825 ], [ -117.146346249618063, 32.72920125111154 ], [ -117.146302499867119, 32.729382501244444 ], [ -117.146258749217793, 32.729563750253142 ], [ -117.146400000313093, 32.729589999948736 ], [ -117.146600000329613, 32.729668571401881 ], [ -117.146679999797271, 32.729808571287677 ], [ -117.146679999797271, 32.729989523956149 ], [ -117.146679999797271, 32.730170477013012 ], [ -117.146679999797271, 32.730351428946854 ]]],\"spatialReference\":{\"wkid\":4326,\"latestWkid\":4326}}"
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(activityMainBinding.root)
// authentication with an API key or named user
// is required to access basemaps and other location services
ArcGISRuntimeEnvironment.setApiKey(BuildConfig.API_KEY)
// set the basemap style to be displayed in the layout's MapView
// and create the graphic overlay
mapView.apply {
map = ArcGISMap(BasemapStyle.ARCGIS_NAVIGATION)
graphicsOverlays.add(GraphicsOverlay())
}
navigateButton.setOnClickListener {
// start the route navigation on button tap
startNavigation()
}
recenterButton.setOnClickListener {
// change the mapview to use navigation mode on button tap
mapView.locationDisplay.autoPanMode = LocationDisplay.AutoPanMode.NAVIGATION
}
resetButton.setOnClickListener {
mapView.apply {
// stop the location data source
locationDisplay.locationDataSource.stopAsync().addDoneListener {
// on completed, set up map to display the route overview
setUpMapRoute()
}
// clear the map's graphics and create a new one
graphicsOverlays.clear()
graphicsOverlays.add(GraphicsOverlay())
}
// disable the buttons
navigateButton.isEnabled = false
recenterButton.isEnabled = false
}
// calculate the route from the starting location and destination
// and display the route overview
setUpMapRoute()
}
/**
* Calculates the route from San Diego Convention Center to the Fleet Science Center.
* Then sets up the route graphics and displays the route overview.
*/
private fun setUpMapRoute() {
// display the route overview status message
statusMessageTV.text = getString(R.string.route_overview)
// set up Android text to speech engine
textToSpeech = TextToSpeech(this) {
textToSpeech?.language = Locale.ENGLISH
}
// create a route task using the San Diego geodatabase file
routeTask = RouteTask(
this,
getExternalFilesDir(null)?.path + "/sandiego.geodatabase",
"Streets_ND"
)
// load the route task
routeTask.loadAsync()
routeTask.addDoneLoadingListener {
if (routeTask.loadStatus == LoadStatus.LOADED){
// load default route parameters
val routeParametersFuture = routeTask.createDefaultParametersAsync()
routeParametersFuture.addDoneListener {
// get the loaded default route parameters
routeParameters = routeParametersFuture.get().apply {
// explicitly set values for the route parameters
isReturnDirections = true
isReturnStops = true
isReturnRoutes = true
outputSpatialReference = SpatialReferences.getWgs84()
}
// starting location point: San Diego Convention Center
val conventionCenter = Point(-117.160386727, 32.706608, SpatialReferences.getWgs84())
// create starting stop
val startingStop = Stop(conventionCenter).apply {
name = "San Diego Convention Center"
}
// destination location point: Fleet Science Center
val aerospaceMuseum = Point(-117.146679, 32.730351, SpatialReferences.getWgs84())
// create destination stop
val destinationStop = Stop(aerospaceMuseum).apply {
name = "RH Fleet Aerospace Museum"
}
// assign the stops to the route parameters
routeParameters?.setStops(mutableListOf(startingStop, destinationStop))
// get the route results future
val routeResultFuture = routeTask.solveRouteAsync(routeParameters)
routeResultFuture.addDoneListener {
// get the loaded route result
routeResult = routeResultFuture.get()
// keep an instance of the loaded route
route = routeResult?.routes?.get(0)
// set start and stop points to a blue diamond symbol
val stopSymbol =
SimpleMarkerSymbol(SimpleMarkerSymbol.Style.DIAMOND, Color.BLUE, 20F)
// the graphic to represent the route ahead
routeAheadGraphic = Graphic(
route?.routeGeometry,
SimpleLineSymbol(SimpleLineSymbol.Style.SOLID, Color.MAGENTA, 5F)
)
// the graphic to represent the route that's been traveled (initially empty)
routeTraveledGraphic = Graphic().apply {
symbol = SimpleLineSymbol(SimpleLineSymbol.Style.SOLID, Color.BLACK, 3F)
}
// add the graphics to the map view
mapView.graphicsOverlays[0].graphics.addAll(
listOf(
Graphic(conventionCenter, stopSymbol),
Graphic(aerospaceMuseum, stopSymbol),
routeAheadGraphic,
routeTraveledGraphic
)
)
// set the viewpoint of the route overview to the route's geometry
mapView.setViewpointGeometryAsync(route?.routeGeometry, 25.0)
// enable navigation
navigateButton.isEnabled = true
}
}
} else {
val errorMessage = "Failed to load route task: ${routeTask.loadError.message}"
showError(errorMessage)
}
}
}
/**
* Starts the route navigation using a simulated datasource
* and sets up re-routing functionalities.
*/
private fun startNavigation() {
// turn on navigation mode for the map view
mapView.locationDisplay.autoPanMode = LocationDisplay.AutoPanMode.NAVIGATION
// disable the start navigation button
navigateButton.isEnabled = false
// keep a list of all the direction maneuvers
route?.directionManeuvers?.let { directionManeuvers.addAll(it) }
// create a route tracker using the route result
routeTracker = RouteTracker(this, routeResult, 0, true)
// add the voice guidance listener to the route tracker
routeTracker?.addNewVoiceGuidanceListener(speakDirectionListener)
// handle route tracking status changes
routeTracker?.addTrackingStatusChangedListener(trackingStatusListener)
// check if this route task supports rerouting
if (routeTask.routeTaskInfo.isSupportsRerouting) {
// set up the re-routing parameters
val reroutingParameters = ReroutingParameters(routeTask, routeParameters).apply {
strategy = RouteTracker.ReroutingStrategy.TO_NEXT_WAYPOINT
isVisitFirstStopOnStart = false
}
// enable automatic re-routing
routeTracker?.enableReroutingAsync(reroutingParameters)?.addDoneListener {
mapView.locationDisplay.addAutoPanModeChangedListener {
// turn the recenter button on or off when
// the location display changes to or from navigation mode
recenterButton.isEnabled =
it.autoPanMode != LocationDisplay.AutoPanMode.NAVIGATION
}
// create a simulated data source
val simulatedLocationDataSource = SimulatedLocationDataSource()
// create simulation parameters starting at the current time,
// velocity, and horizontal and vertical accuracy.
val simulationParameters = SimulationParameters(
Calendar.getInstance(),
50.0,
0.0,
0.0
)
// set the locations to travel using the JSON polylines
simulatedLocationDataSource.setLocations(
Geometry.fromJson(polylineJSON) as Polyline,
simulationParameters
)
// provide the route tacker with the current location of the simulated datasource
simulatedLocationDataSource.addLocationChangedListener {
routeTracker?.trackLocationAsync(it.location)
}
// add a data source for the location display
mapView.locationDisplay.locationDataSource = simulatedLocationDataSource
// use this instead if you want real location:
//mapView.locationDisplay.locationDataSource = RouteTrackerLocationDataSource(routeTracker, AndroidLocationDataSource(this))
// start the location data source
mapView.locationDisplay.startAsync()
// add re-routing listeners
routeTracker?.addRerouteStartedListener(routeStartedListener)
routeTracker?.addRerouteCompletedListener(routeCompletedListener)
}
}
}
/**
* Removes the current route tracking status listener if new route loading has started.
*/
private val routeStartedListener: RouteTracker.RerouteStartedListener =
RouteTracker.RerouteStartedListener {
// remove current route tracker event listeners when calculating a new route
routeTracker?.removeTrackingStatusChangedListener(trackingStatusListener)
routeTracker?.removeNewVoiceGuidanceListener(speakDirectionListener)
}
/**
* Removes the route tracking status listener if re-route loading has completed,
* sets up new direction maneuvers and adds a new route tracking listener.
*/
private val routeCompletedListener: RouteTracker.RerouteCompletedListener =
RouteTracker.RerouteCompletedListener {
routeTracker?.removeTrackingStatusChangedListener(trackingStatusListener)
// clear current direction maneuvers
directionManeuvers.clear()
// adds new direction maneuvers to the list
directionManeuvers.addAll(it.trackingStatus.routeResult.routes[0].directionManeuvers)
// re-add the event listeners for when new route has been calculated
routeTracker?.addTrackingStatusChangedListener(trackingStatusListener)
routeTracker?.addNewVoiceGuidanceListener(speakDirectionListener)
}
/**
* Calls updateTrackingStatus() on every route tacking status changed.
*/
private val trackingStatusListener: RouteTracker.TrackingStatusChangedListener =
RouteTracker.TrackingStatusChangedListener {
updateTrackingStatus(it.trackingStatus)
}
/**
* Plays the speech guidance on route update
*/
private val speakDirectionListener: RouteTracker.NewVoiceGuidanceListener =
RouteTracker.NewVoiceGuidanceListener {
// stop if TTS is running
textToSpeech?.stop()
// say the direction
textToSpeech?.speak(it.voiceGuidance.text, TextToSpeech.QUEUE_FLUSH, null,it.voiceGuidance.text )
}
/**
* Displays the route status descriptions and update route graphics as the
* the datasource updates on the map.
*/
private fun updateTrackingStatus(status: TrackingStatus) {
val statusMessage: StringBuilder = StringBuilder()
// check if navigation is on route
if (status.isOnRoute && !status.isRouteCalculating) {
// check the destination status if it's still en-route
if (status.destinationStatus == DestinationStatus.NOT_REACHED ||
status.destinationStatus == DestinationStatus.APPROACHING) {
// get the distance remaining in kilometers
statusMessage.appendLine(
"Distance remaining: ${status.routeProgress.remainingDistance.displayText} " +
status.routeProgress.remainingDistance.displayTextUnits.pluralDisplayName.lowercase()
)
// get the time remaining in minutes
statusMessage.appendLine("Time remaining: ${status.routeProgress.remainingTime.roundToInt()} mins")
// if there are additional maneuvers, append next direction maneuvers
if (status.currentManeuverIndex + 1 < directionManeuvers.size) {
statusMessage.appendLine(
"Next direction: " +
directionManeuvers[status.currentManeuverIndex + 1].directionText
)
}
// set geometries for progress and the remaining route
routeAheadGraphic?.geometry = status.routeProgress.remainingGeometry
routeTraveledGraphic?.geometry = status.routeProgress.traversedGeometry
} else if (status.destinationStatus == DestinationStatus.REACHED) {
// update the status message
statusMessage.appendLine("Destination reached")
// set the route geometries to reflect the completed route
routeAheadGraphic?.geometry = null
routeTraveledGraphic?.geometry = status.routeResult.routes[0].routeGeometry
}
} else {
statusMessage.appendLine("Off route, rerouting...")
}
// remove the trailing new line at the end of a message
statusMessage.setLength(statusMessage.length - 1)
// display the status message to the text view
statusMessageTV.text = statusMessage
}
private fun showError(errorMessage: String) {
Log.e(TAG,errorMessage)
Toast.makeText(this, errorMessage, Toast.LENGTH_SHORT).show()
}
override fun onPause() {
mapView.pause()
super.onPause()
}
override fun onResume() {
super.onResume()
mapView.resume()
}
override fun onDestroy() {
// stop the location data source
mapView.locationDisplay.locationDataSource.stopAsync()
mapView.dispose()
super.onDestroy()
}
}