HERE Android SDK Developer's Guide

LocationDataSourceHERE

The class LocationDataSourceHERE is a member of com.here.android.mpa.common .

Class Summary

public abstract class LocationDataSourceHERE

extends com.here.android.mpa.common.LocationDataSource, java.lang.Object

Abstract class that defines the interface for providing positions updates from a HERE hybrid location data source.

[For complete information, see the section Class Details]

Nested Class Summary

Table 1. Nested Classes in LocationDataSourceHERE
Nested Classes

public static final enumeration LocationDataSourceHERE.IndoorPositioningMode

Defines supported indoor positioning modes.

public static final enumeration LocationDataSourceHERE.IndoorPositioningModeSetResult

Defines result codes for indoor positioning mode set call.

Constructor Summary

Table 2. Constructors in LocationDataSourceHERE
Constructors

LocationDataSourceHERE ()

Method Summary

Table 3. Methods in LocationDataSourceHERE
Methods

public abstract IndoorPositioningMode getIndoorPositioningMode ()

Get active indoor positioning mode.

public static LocationDataSourceHERE getInstance ()

Get access to the LocationDataSourceHERE Singleton.

public static LocationDataSourceHERE getInstance (StatusListener statusListener)

Get access to the LocationDataSourceHERE Singleton.

public abstract RadioMapLoader getRadioMapLoader ()

Get instance of positioning radio map loader.

public abstract void setDiagnosticsListener (DiagnosticsListener listener)

Register HERE positioning diagnostics listener instance for receiving positioning related events.

public abstract IndoorPositioningModeSetResult setIndoorPositioningMode (IndoorPositioningMode mode)

Set indoor positioning mode.

Class Details

Abstract class that defines the interface for providing positions updates from a HERE hybrid location data source. Instance of this class can be created with getInstance(StatusListener) call.

Constructor Details

LocationDataSourceHERE ()

Method Details

public abstract IndoorPositioningMode getIndoorPositioningMode ()

Get active indoor positioning mode.

Returns:

Current indoor positioning mode.

See also:

{@link LocationDataSourceHERE.IndoorPositioningMode}

public static LocationDataSourceHERE getInstance ()

Get access to the LocationDataSourceHERE Singleton. MapsEngine has to be successfully initialized before the call.

Returns:

LocationDataSourceHERE instance

Throws:

  • AccessControlException

    if HERE positioning is not licensed.

public static LocationDataSourceHERE getInstance (StatusListener statusListener)

Get access to the LocationDataSourceHERE Singleton. MapsEngine has to be successfully initialized before the call.

Parameters:

  • statusListener

    Status listener instance for retrieving HERE positioning related events.

Returns:

LocationDataSourceHERE instance

Throws:

  • AccessControlException

    if HERE positioning has not been licensed.

public abstract RadioMapLoader getRadioMapLoader ()

Get instance of positioning radio map loader. Radio map loader can be used for downloading positioning radio maps for specified areas.

Returns:

Radio map loader instance.

Throws:

  • AccessControlException

    if positioning radio map downloading API has not been licensed.

public abstract void setDiagnosticsListener (DiagnosticsListener listener)

Register HERE positioning diagnostics listener instance for receiving positioning related events. Only one listener can be registered at a time. To unregister the existing listener, set listener to null .

Parameters:

  • listener

    The Diagnostics listener instance for which HERE positioning related events should be delivered or null if you are no longer interested in diagnostic events.

public abstract IndoorPositioningModeSetResult setIndoorPositioningMode (IndoorPositioningMode mode)

Set indoor positioning mode. Mode defines which radio maps HERE positioning is allowed to use.

Parameters:

  • mode

    New indoor positioning mode.

Returns:

Result for the mode change.

See also:

{@link LocationDataSourceHERE.IndoorPositioningMode}