LocationComponentPlugin

interface LocationComponentPlugin : MapPlugin, MapStyleObserverPlugin, LifecyclePlugin, ContextBinder, LocationComponentSettingsInterface

Define the interfaces for the Location plugin.

Functions

addOnIndicatorBearingChangedListener

abstract fun addOnIndicatorBearingChangedListener(listener: OnIndicatorBearingChangedListener)

Adds a listener that gets invoked when indicator bearing changes.

addOnIndicatorPositionChangedListener

abstract fun addOnIndicatorPositionChangedListener(listener: OnIndicatorPositionChangedListener)

Adds a listener that gets invoked when indicator position changes.

bind

abstract fun bind(context: Context, attrs: AttributeSet?, pixelRatio: Float)

Bind the ViewPlugin with current map context. This will create a View that will be added to the MapView.

cleanup

open fun cleanup()

Called when the map is destroyed. Should be used to cleanup plugin resources for that map.

getLocationProvider

abstract fun getLocationProvider(): LocationProvider?

Get the current LocationProvider under usage with the LocationComponentPlugin.

getSettings

abstract fun getSettings(): LocationComponentSettings

Get current locationcomponent configuration.

initialize

open fun initialize()

Called when the plugin is first added to the map.

isLocatedAt

abstract fun isLocatedAt(point: Point, listener: PuckLocatedAtPointListener)

Check whether the rendered location puck is on the given point.

onDelegateProvider

open fun onDelegateProvider(delegateProvider: MapDelegateProvider)

Provides all map delegate instances.

onStart

open fun onStart()

Called whenever activity's/fragment's lifecycle is entering a "started" state.

onStop

open fun onStop()

Called whenever activity's/fragment's lifecycle is entering a "stopped" state.

onStyleChanged

abstract fun onStyleChanged(styleDelegate: StyleInterface)

Called when a new Style is loaded.

removeOnIndicatorBearingChangedListener

abstract fun removeOnIndicatorBearingChangedListener(listener: OnIndicatorBearingChangedListener)

Removes a listener that gets invoked when indicator bearing changes.

removeOnIndicatorPositionChangedListener

abstract fun removeOnIndicatorPositionChangedListener(listener: OnIndicatorPositionChangedListener)

Removes a listener that gets invoked when indicator position changes.

setLocationProvider

abstract fun setLocationProvider(locationProvider: LocationProvider)

Set the LocationProvider, it will replace the default location provider provided by the LocationComponentPlugin.

updateSettings

abstract fun updateSettings(block: LocationComponentSettings.() -> Unit)

Update locationcomponent configuration, the update will be applied to the plugin automatically.

Properties

enabled

abstract var enabled: Boolean

Whether the user location is visible on the map.

layerAbove

abstract var layerAbove: String?

Sets the id of the layer that's added above to when placing the component on the map.

layerBelow

abstract var layerBelow: String?

Sets the id of the layer that's added below to when placing the component on the map.

locationPuck

abstract var locationPuck: LocationPuck

Defines what the customised look of the location puck. Note that direct changes to the puck variables won't have any effect, a new puck needs to be set every time.

pulsingColor

abstract var pulsingColor: Int

The color of the pulsing circle. Works for 2D location puck only.

pulsingEnabled

abstract var pulsingEnabled: Boolean

Whether the location puck is pulsing on the map. Works for 2D location puck only.

pulsingMaxRadius

abstract var pulsingMaxRadius: Float

The maximum radius of the pulsing circle. Works for 2D location puck only. Note: Setting pulsingMaxRadius to LocationComponentConstants.PULSING_MAX_RADIUS_FOLLOW_ACCURACY will set the pulsing circle's maximum radius to follow location accuracy circle.

Inheritors

LocationComponentPlugin2

Extensions

createDefault2DPuck

fun LocationComponentPlugin.createDefault2DPuck(context: Context, withBearing: Boolean = false): LocationPuck2D

Create a LocationPuck2D instance with or without an arrow bearing image.