MapSurface

class MapSurface : MapPluginProviderDelegate, MapControllable

A MapSurface provides an embeddable map interface. You use this class to display map information and to manipulate the map contents from your application. You can center the map on a given coordinate, specify the size of the area you want to display, and style the features of the map to fit your application's use case.

Use of MapSurface requires a Mapbox API access token. Obtain an access token on the Mapbox account page.

Warning: Please note that you are responsible for getting permission to use the map data, and for ensuring your use adheres to the relevant terms of use.

Constructors

MapSurface
Link copied to clipboard
fun MapSurface(context: Context, surface: Surface, mapInitOptions: MapInitOptions = MapInitOptions(context))

Functions

addRendererSetupErrorListener
Link copied to clipboard
open override fun addRendererSetupErrorListener(rendererSetupErrorListener: RendererSetupErrorListener)

Add an instance of RendererSetupErrorListener.

addWidget
Link copied to clipboard
open override fun addWidget(widget: Widget)

Add Widget to the map.

getMapboxMap
Link copied to clipboard
open override fun getMapboxMap(): MapboxMap

Returns a MapboxMap object that can be used to interact with the map.

getPlugin
Link copied to clipboard
open override fun <T : MapPlugin> getPlugin(id: String): T?

Get the plugin instance.

onDestroy
Link copied to clipboard
open override fun onDestroy()

Called to dispose the renderer

onGenericMotionEvent
Link copied to clipboard
open override fun onGenericMotionEvent(event: MotionEvent): Boolean

Called when a motion event has occurred.

onLowMemory
Link copied to clipboard
open override fun onLowMemory()

Called to reduce memory use

onSizeChanged
Link copied to clipboard
open override fun onSizeChanged(w: Int, h: Int)

Called when the size has changed.

onStart
Link copied to clipboard
open override fun onStart()

Called to resume rendering

onStop
Link copied to clipboard
open override fun onStop()

Called to stop rendering

onTouchEvent
Link copied to clipboard
open override fun onTouchEvent(event: MotionEvent): Boolean

Called when a touch event has occurred.

queueEvent
Link copied to clipboard
open override fun queueEvent(event: Runnable, needRender: Boolean)

Queue a runnable to be executed on the map renderer thread. Consecutive events will be called in the order they were queued.

removeRendererSetupErrorListener
Link copied to clipboard
open override fun removeRendererSetupErrorListener(rendererSetupErrorListener: RendererSetupErrorListener)

Remove an instance of RendererSetupErrorListener.

removeWidget
Link copied to clipboard
open override fun removeWidget(widget: Widget): Boolean

Remove Widget from the map.

setMaximumFps
Link copied to clipboard
open override fun setMaximumFps(fps: Int)

Called to limit the maximum fps

setOnFpsChangedListener
Link copied to clipboard
open override fun setOnFpsChangedListener(listener: OnFpsChangedListener)

Set OnFpsChangedListener to get map rendering FPS.

snapshot
Link copied to clipboard
open override fun snapshot(): Bitmap?

Called to capture a snapshot synchronously.

open override fun snapshot(listener: MapView.OnSnapshotReady)

Called to capture a snapshot asynchronously. Consecutive requests will return snapshots in the order they were added.

surfaceChanged
Link copied to clipboard
fun surfaceChanged(width: Int, height: Int)

Must be called when the surface dimensions have changed.

surfaceCreated
Link copied to clipboard
fun surfaceCreated()

Must be called when the surface has been created.

surfaceDestroyed
Link copied to clipboard
fun surfaceDestroyed()

Must be called when the surface is destroyed.

Properties

surface
Link copied to clipboard
val surface: Surface

The surface to be used, set from the constructor.