com.hypertrack.sdk.views.maps

Class HyperTrackMap

java.lang.Object

com.hypertrack.sdk.views.maps.HyperTrackMap

public class HyperTrackMap
extends Object

Class provides interface for binding HyperTrack data and real-time updates to map view. You can request location updates and subscribe for views sdk updates. In same time you can use it offline via bind(LocationProvider) GpsLocationProvider

Field Summary

Fields

Modifier and Type	Field and Description
static String	GPS_LOCATION_PROVIDER
static int	LOCATION_MAP_OBJECT_TYPE
static int	TRIP_MAP_OBJECT_TYPE
static String	VIEWS_LOCATION_PROVIDER

Method Summary

Modifier and Type	Method and Description
MapAdapter	adapter() Getter for HyperTrackMap adapter.
HyperTrackMap	bind(HyperTrackViews hyperTrackViews, String deviceId) Binds HyperTrackViews instance with device to HyperTrackMap.
HyperTrackMap	bind(LocationProvider locationProvider) Binds LocationProvider implementation to HyperTrackMap.
void	destroy() Destroys the HyperTrackMap and all inner data.
static HyperTrackMap	getInstance(android.content.Context context, MapAdapter mapAdapter) Creates new instance of HyperTrackMap from Context and MapAdapter.
void	moveToLocation(double latitude, double longitude) Moves the camera from the current position to the position of coordinates.
void	moveToMyLocation() Moves the camera from the current position to the last known position.
void	moveToTrip(Trip trip) Moves the camera from the current position to object's coordinates defined in the trip, by combining trip objects that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level.
void	setLocationUpdatesListener(android.location.LocationListener locationListener) Register a callback for location updates.
void	setMyLocationEnabled(boolean enabled) Enables and disables displaying and updating of my location.
TripSubscription	subscribeTrip(String tripId) Subscribes real-time trip updates to map.
HyperTrackMap	unbindHyperTrackViews() Unbinds HyperTrackViews instance from HyperTrackMap.

Methods inherited from class java.lang.Object

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

Field Detail

GPS_LOCATION_PROVIDER

public static final String GPS_LOCATION_PROVIDER

See Also:

Constant Field Values

VIEWS_LOCATION_PROVIDER

public static final String VIEWS_LOCATION_PROVIDER

See Also:

Constant Field Values

LOCATION_MAP_OBJECT_TYPE

public static final int LOCATION_MAP_OBJECT_TYPE

See Also:

Constant Field Values

TRIP_MAP_OBJECT_TYPE

public static final int TRIP_MAP_OBJECT_TYPE

See Also:

Constant Field Values

Method Detail

getInstance

public static HyperTrackMap getInstance(android.content.Context context,
                                        MapAdapter mapAdapter)

Creates new instance of HyperTrackMap from Context and MapAdapter.

Parameters:

context - reference to Context

mapAdapter - MapAdapter implementation.

adapter

public MapAdapter adapter()

Getter for HyperTrackMap adapter.

Returns:

HyperTrackMap adapter reference.

bind

public HyperTrackMap bind(HyperTrackViews hyperTrackViews,
                          String deviceId)

Binds HyperTrackViews instance with device to HyperTrackMap. After that you will receive location and trips updates from HyperTrack which will be displays in real-time on the map.

Parameters:

hyperTrackViews - HyperTrackViews instance.

deviceId - HyperTrack device id (HyperTrack.getInstance(context, "HYPER_TRACK_PUB_KEY").getDeviceID())

Returns:

current HyperTrackMap instance.

unbindHyperTrackViews

public HyperTrackMap unbindHyperTrackViews()

Unbinds HyperTrackViews instance from HyperTrackMap. After that you will receive location from the device which will be displays in real-time on the map.

Returns:

current HyperTrackMap instance.

bind

public HyperTrackMap bind(LocationProvider locationProvider)

Binds LocationProvider implementation to HyperTrackMap.

Parameters:

locationProvider - location provider that updates my location on map.

Returns:

current HyperTrackMap instance.

setLocationUpdatesListener

public void setLocationUpdatesListener(android.location.LocationListener locationListener)

Register a callback for location updates.

Parameters:

locationListener - a LocationListener whose LocationListener.onLocationChanged(android.location.Location) method will be called for each location update. This value may be null.

setMyLocationEnabled

public void setMyLocationEnabled(boolean enabled)

Enables and disables displaying and updating of my location.

Parameters:

enabled - true if should be enabled, false otherwise.

moveToMyLocation

public void moveToMyLocation()

Moves the camera from the current position to the last known position.

moveToLocation

public void moveToLocation(double latitude,
                           double longitude)

Moves the camera from the current position to the position of coordinates.

Parameters:

latitude - coordinate of new camera position.

longitude - coordinate of new camera position.

moveToTrip

public void moveToTrip(Trip trip)

Moves the camera from the current position to object's coordinates defined in the trip, by combining trip objects that transforms the camera such that the specified latitude/longitude bounds are centered on screen at the greatest possible zoom level.

Parameters:

trip - data that includes trip objects with coordinates.

subscribeTrip

public TripSubscription subscribeTrip(String tripId)

Subscribes real-time trip updates to map.

Parameters:

tripId - that should be subscribed.

Returns:

instance of TripSubscription with which you can unsubscribe.

destroy

public void destroy()

Destroys the HyperTrackMap and all inner data.