mapbox-maps-android/com.mapbox.maps/MapSurface

MapSurface

class MapSurface @JvmOverloads() constructor(context: Context, surface: Surface, mapInitOptions: MapInitOptions) : 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.

<strong>Warning:</strong> 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.

Parameters

context

the application context to init the default MapInitOptions

mapInitOptions

the init options to for map

surface

the surface that will display map

Constructors

MapSurface

androidJvm

@JvmOverloads()

fun MapSurface(context: Context, surface: Surface, mapInitOptions: MapInitOptions = MapInitOptions(context))

the application context to init the default MapInitOptions

Functions

addWidget

androidJvm

open override fun addWidget(widget: Widget)

Add Widget to the map.

equals

androidJvm

open operator fun equals(other: Any?): Boolean

getMapboxMap

androidJvm

open override fun getMapboxMap(): MapboxMap

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

getPlugin

androidJvm

open override fun <T : MapPlugin> getPlugin(id: String): T?

Get the plugin instance.

hashCode

androidJvm

open fun hashCode(): Int

onDestroy

androidJvm

open override fun onDestroy()

Called to dispose the renderer

onGenericMotionEvent

androidJvm

open override fun onGenericMotionEvent(event: MotionEvent): Boolean

Called when a motion event has occurred.

onLowMemory

androidJvm

open override fun onLowMemory()

Called to reduce memory use

onSizeChanged

androidJvm

open override fun onSizeChanged(w: Int, h: Int)

Called when the size has changed.

onStart

androidJvm

open override fun onStart()

Called to resume rendering

onStop

androidJvm

open override fun onStop()

Called to stop rendering

onTouchEvent

androidJvm

open override fun onTouchEvent(event: MotionEvent): Boolean

Called when a touch event has occurred.

queueEvent

androidJvm

open override fun queueEvent(event: Runnable, needRender: Boolean)

Queue a runnable to be executed on the map renderer thread.

removeWidget

androidJvm

open override fun removeWidget(widget: Widget): Boolean

Remove Widget from the map.

setMaximumFps

androidJvm

open override fun setMaximumFps(fps: Int)

Called to limit the maximum fps

setOnFpsChangedListener

androidJvm

open override fun setOnFpsChangedListener(listener: OnFpsChangedListener)

Set OnFpsChangedListener to get map rendering FPS.

snapshot

androidJvm

open override fun snapshot(): Bitmap?

Called to capture a snapshot synchronously.

open override fun snapshot(listener: MapView.OnSnapshotReady)

Called to capture a snapshot asynchronously.

surfaceChanged

androidJvm

fun surfaceChanged(width: Int, height: Int)

Called when the surface dimensions have changed.

surfaceCreated

androidJvm

fun surfaceCreated()

Called when the surface has been created.

surfaceDestroyed

androidJvm

fun surfaceDestroyed()

Called when the surface

toString

androidJvm

open fun toString(): String

Properties

surface

androidJvm

val surface: Surface

the surface that will display map