Package com.esri.arcgisruntime.location

Class RouteTrackerLocationDataSource

java.lang.Object

com.esri.arcgisruntime.location.LocationDataSource

com.esri.arcgisruntime.location.RouteTrackerLocationDataSource

public final class RouteTrackerLocationDataSource
extends LocationDataSource

A location data source that uses a route tracker and a generic location data source to output locations snapped to a route.

This data source will pass the locations from the LocationDataSource.LocationChangedEvent event to the RouteTracker.trackLocationAsync(Location). The TrackingStatus.getDisplayLocation() will then be returned in this data source's locationChanged event. The output locations will be snapped to the route when "on route".

Since:

100.9.0

Nested Class Summary

Nested classes/interfaces inherited from class com.esri.arcgisruntime.location.LocationDataSource

LocationDataSource.ErrorChangedEvent, LocationDataSource.ErrorChangedListener, LocationDataSource.HeadingChangedEvent, LocationDataSource.HeadingChangedListener, LocationDataSource.Location, LocationDataSource.LocationChangedEvent, LocationDataSource.LocationChangedListener, LocationDataSource.Status, LocationDataSource.StatusChangedEvent, LocationDataSource.StatusChangedListener

Constructor Summary

Constructors

Constructor	Description
RouteTrackerLocationDataSource(android.content.Context context, RouteTracker routeTracker)	Constructs a RouteTrackerLocationDataSource using the the passed RouteTracker and the default platform supported location data source AndroidLocationDataSource.
RouteTrackerLocationDataSource(RouteTracker routeTracker, LocationDataSource locationDataSource)	Constructs a RouteTrackerLocationDataSource using the the passed RouteTracker and the given location data source.

Method Summary

Modifier and Type	Method	Description
protected void	onStart()	Called from LocationDataSource.startAsync().
protected void	onStop()	Called from the LocationDataSource.stopAsync() or LocationDataSource.stop() method, subclasses should perform any necessary clean-up in this method; for example, stop streaming the location data, release resources, and so on.

Methods inherited from class com.esri.arcgisruntime.location.LocationDataSource

addErrorChangedListener, addHeadingChangedListener, addLocationChangedListener, addStartedListener, addStatusChangedListener, getError, getStatus, isStarted, onStartCompleted, removeErrorChangedListener, removeHeadingChangedListener, removeLocationChangedListener, removeStartedListener, removeStatusChangedListener, setLastKnownLocation, startAsync, stop, stopAsync, updateHeading, updateLocation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RouteTrackerLocationDataSource

public RouteTrackerLocationDataSource(android.content.Context context,
                                      RouteTracker routeTracker)

Constructs a RouteTrackerLocationDataSource using the the passed RouteTracker and the default platform supported location data source AndroidLocationDataSource.

Parameters:

context - the Context in which the LocationDataSource is running

routeTracker - a RouteTracker

Throws:

java.lang.IllegalArgumentException - if context or routeTracker is null

Since:

100.9.0

RouteTrackerLocationDataSource

public RouteTrackerLocationDataSource(RouteTracker routeTracker,
                                      LocationDataSource locationDataSource)

Constructs a RouteTrackerLocationDataSource using the the passed RouteTracker and the given location data source.

Parameters:

routeTracker - a RouteTracker

locationDataSource - a LocationDataSource

Throws:

java.lang.IllegalArgumentException - if routeTracker or locationDataSource is null

Since:

100.9.0

Method Detail

onStart

protected void onStart()

Description copied from class: LocationDataSource

Called from LocationDataSource.startAsync(). Subclasses should implement this method to prepare for starting the data source. The LocationDataSource.onStartCompleted(Throwable) method must be called by the subclass once the location data source has finished its starting process.

Specified by:

onStart in class LocationDataSource

onStop

protected void onStop()

Description copied from class: LocationDataSource

Called from the LocationDataSource.stopAsync() or LocationDataSource.stop() method, subclasses should perform any necessary clean-up in this method; for example, stop streaming the location data, release resources, and so on.

Specified by:

onStop in class LocationDataSource