CameraManager

open class CameraManager : StyleManager, CameraManagerInterface

Interface for managing camera.

Functions

addPersistentStyleCustomLayer

open fun addPersistentStyleCustomLayer(@NonNull layerId: String, @NonNull layerHost: CustomLayerHost, @Nullable layerPosition: LayerPosition): Expected<String, None>

Adds a new [style custom layer](https://docs.mapbox.com/mapbox-gl-js/style-spec/#layers).

addPersistentStyleLayer

@NonNull

open fun addPersistentStyleLayer(@NonNull properties: Value, @Nullable layerPosition: LayerPosition): Expected<String, None>

Adds a new [style layer](https://docs.mapbox.com/mapbox-gl-js/style-spec/#layers).

addStyleCustomGeometrySource

@NonNull

open fun addStyleCustomGeometrySource(@NonNull sourceId: String, @NonNull options: CustomGeometrySourceOptions): Expected<String, None>

Adds a custom geometry to be used in the style.

addStyleCustomLayer

@NonNull

open fun addStyleCustomLayer(@NonNull layerId: String, @NonNull layerHost: CustomLayerHost, @Nullable layerPosition: LayerPosition): Expected<String, None>

Adds a new [style custom layer](https://docs.mapbox.com/mapbox-gl-js/style-spec/#layers).

addStyleImage

@NonNull

open fun addStyleImage(@NonNull imageId: String, scale: Float, @NonNull image: Image, sdf: Boolean, @NonNull stretchX: List<ImageStretches>, @NonNull stretchY: List<ImageStretches>, @Nullable content: ImageContent): Expected<String, None>

Adds an image to be used in the style.

addStyleLayer

@NonNull

open fun addStyleLayer(@NonNull properties: Value, @Nullable layerPosition: LayerPosition): Expected<String, None>

Adds a new [style layer](https://docs.mapbox.com/mapbox-gl-js/style-spec/#layers).

addStyleModel

@NonNull

open fun addStyleModel(@NonNull modelId: String, @NonNull modelUri: String): Expected<String, None>

Adds a model to be used in the style.

addStyleSource

@NonNull

open fun addStyleSource(@NonNull sourceId: String, @NonNull properties: Value): Expected<String, None>

Adds a new [style source](https://docs.mapbox.com/mapbox-gl-js/style-spec/#sources).

cameraForCoordinateBounds

@NonNull

open fun cameraForCoordinateBounds(@NonNull bounds: CoordinateBounds, @NonNull padding: EdgeInsets, @Nullable bearing: Double, @Nullable pitch: Double): CameraOptions

Convenience method that returns the `camera options` object for given parameters.

cameraForCoordinates

@NonNull

open fun cameraForCoordinates(@NonNull coordinates: List<Point>, @NonNull camera: CameraOptions, @NonNull box: ScreenBox): CameraOptions

Convenience method that adjusts the provided `camera options` object for given parameters.

@NonNull

open fun cameraForCoordinates(@NonNull coordinates: List<Point>, @NonNull padding: EdgeInsets, @Nullable bearing: Double, @Nullable pitch: Double): CameraOptions

Convenience method that returns the `camera options` object for given parameters.

cameraForGeometry

@NonNull

open fun cameraForGeometry(@NonNull geometry: Geometry, @NonNull padding: EdgeInsets, @Nullable bearing: Double, @Nullable pitch: Double): CameraOptions

Convenience method that returns the `camera options` object for given parameters.

coordinateBoundsForCamera

@NonNull

open fun coordinateBoundsForCamera(@NonNull camera: CameraOptions): CoordinateBounds

Returns the `coordinate bounds` for a given camera.

coordinateBoundsForCameraUnwrapped

@NonNull

open fun coordinateBoundsForCameraUnwrapped(@NonNull camera: CameraOptions): CoordinateBounds

Returns the `coordinate bounds` for a given camera.

coordinateBoundsZoomForCamera

@NonNull

open fun coordinateBoundsZoomForCamera(@NonNull camera: CameraOptions): CoordinateBoundsZoom

Returns the `coordinate bounds` and the `zoom` for a given `camera`.

coordinateBoundsZoomForCameraUnwrapped

@NonNull

open fun coordinateBoundsZoomForCameraUnwrapped(@NonNull camera: CameraOptions): CoordinateBoundsZoom

Returns the unwrapped `coordinate bounds` and `zoom` for a given `camera`.

coordinateForPixel

@NonNull

open fun coordinateForPixel(@NonNull pixel: ScreenCoordinate): Point

Calculates a geographical `coordinate` (i.e., longitude-latitude pair) that corresponds to a `screen coordinate`.

coordinatesForPixels

@NonNull

open fun coordinatesForPixels(@NonNull pixels: List<ScreenCoordinate>): List<Point>

Calculates geographical `coordinates` (i.e., longitude-latitude pairs) that correspond to `screen coordinates`.

dragEnd

open fun dragEnd()

Ends the ongoing drag gesture.

dragStart

open fun dragStart(@NonNull point: ScreenCoordinate)

Prepares the drag gesture to use the provided screen coordinate as a pivot `point`.

getBounds

@NonNull

open fun getBounds(): CameraBounds

Returns the `camera bounds` of the map.

getCameraState

@NonNull

open fun getCameraState(): CameraState

Returns the current `camera state`.

getDragCameraOptions

@NonNull

open fun getDragCameraOptions(@NonNull fromPoint: ScreenCoordinate, @NonNull toPoint: ScreenCoordinate): CameraOptions

Calculates target point where camera should move after drag.

getFreeCameraOptions

@NonNull

open fun getFreeCameraOptions(): FreeCameraOptions

Gets the map's current free camera options.

getRenderWorldCopies

open fun getRenderWorldCopies(): Boolean

Returns whether multiple copies of the world are being rendered side by side beyond -180 and 180 degrees longitude.

getStyleAtmosphereProperty

@NonNull

open fun getStyleAtmosphereProperty(@NonNull property: String): StylePropertyValue

Gets the value of a style atmosphere property.

getStyleDefaultCamera

@NonNull

open fun getStyleDefaultCamera(): CameraOptions

Returns the map style's default camera, if any, or a default camera otherwise.

getStyleImage

@Nullable

open fun getStyleImage(@NonNull imageId: String): Image

Get an `image` from the style.

getStyleJSON

@NonNull

open fun getStyleJSON(): String

Get the JSON serialization string of the current style in use.

getStyleLayerProperties

@NonNull

open fun getStyleLayerProperties(@NonNull layerId: String): Expected<String, Value>

Gets style layer properties.

getStyleLayerProperty

@NonNull

open fun getStyleLayerProperty(@NonNull layerId: String, @NonNull property: String): StylePropertyValue

Gets the value of style layer property.

getStyleLayerPropertyDefaultValue

@NonNull

open fun getStyleLayerPropertyDefaultValue(@NonNull layerType: String, @NonNull property: String): StylePropertyValue

Gets the default value of style layer property

getStyleLayers

@NonNull

open fun getStyleLayers(): List<StyleObjectInfo>

Returns the existing style layers.

getStyleLightProperty

@NonNull

open fun getStyleLightProperty(@NonNull property: String): StylePropertyValue

Gets the value of a style light property.

getStyleProjectionProperty

@NonNull

open fun getStyleProjectionProperty(@NonNull property: String): StylePropertyValue

Gets the value of a style projection property.

getStyleSourceProperties

@NonNull

open fun getStyleSourceProperties(@NonNull sourceId: String): Expected<String, Value>

Gets style source properties.

getStyleSourceProperty

@NonNull

open fun getStyleSourceProperty(@NonNull sourceId: String, @NonNull property: String): StylePropertyValue

Gets the value of style source property.

getStyleSourcePropertyDefaultValue

@NonNull

open fun getStyleSourcePropertyDefaultValue(@NonNull sourceType: String, @NonNull property: String): StylePropertyValue

Gets the default value of style source property.

getStyleSources

@NonNull

open fun getStyleSources(): List<StyleObjectInfo>

Returns the existing style sources.

getStyleTerrainProperty

@NonNull

open fun getStyleTerrainProperty(@NonNull property: String): StylePropertyValue

Gets the value of a style terrain property.

getStyleTransition

@NonNull

open fun getStyleTransition(): TransitionOptions

Returns the map style's transition options.

getStyleURI

@NonNull

open fun getStyleURI(): String

Get the URI of the current style in use.

hasStyleImage

open fun hasStyleImage(@NonNull imageId: String): Boolean

Checks whether an image exists.

hasStyleModel

open fun hasStyleModel(@NonNull modelId: String): Boolean

Checks whether a model exists.

invalidateStyleCustomGeometrySourceRegion

@NonNull

open fun invalidateStyleCustomGeometrySourceRegion(@NonNull sourceId: String, @NonNull bounds: CoordinateBounds): Expected<String, None>

Invalidate region for provided custom geometry source.

invalidateStyleCustomGeometrySourceTile

@NonNull

open fun invalidateStyleCustomGeometrySourceTile(@NonNull sourceId: String, @NonNull tileId: CanonicalTileID): Expected<String, None>

Invalidate tile for provided custom geometry source.

isStyleLayerPersistent

@NonNull

open fun isStyleLayerPersistent(@NonNull layerId: String): Expected<String, Boolean>

Checks if a style layer is persistent.

isStyleLoaded

open fun isStyleLoaded(): Boolean

Check if the style is completely loaded.

moveStyleLayer

@NonNull

open fun moveStyleLayer(@NonNull layerId: String, @Nullable layerPosition: LayerPosition): Expected<String, None>

Moves an existing style layer

pixelForCoordinate

@NonNull

open fun pixelForCoordinate(@NonNull coordinate: Point): ScreenCoordinate

Calculates a `screen coordinate` that corresponds to a geographical coordinate (i.e., longitude-latitude pair).

pixelsForCoordinates

@NonNull

open fun pixelsForCoordinates(@NonNull coordinates: List<Point>): List<ScreenCoordinate>

Calculates `screen coordinates` that correspond to geographical `coordinates` (i.e., longitude-latitude pairs).

removeStyleImage

@NonNull

open fun removeStyleImage(@NonNull imageId: String): Expected<String, None>

Removes an image from the style.

removeStyleLayer

@NonNull

open fun removeStyleLayer(@NonNull layerId: String): Expected<String, None>

Removes an existing style layer.

removeStyleModel

@NonNull

open fun removeStyleModel(@NonNull modelId: String): Expected<String, None>

Removes a model from the style.

removeStyleSource

@NonNull

open fun removeStyleSource(@NonNull sourceId: String): Expected<String, None>

Removes an existing style source.

setBounds

@NonNull

open fun setBounds(@NonNull options: CameraBoundsOptions): Expected<String, None>

Sets the `camera bounds options` of the map.

setCamera

open fun setCamera(@NonNull cameraOptions: CameraOptions)

Changes the map view by any combination of center, zoom, bearing, and pitch, without an animated transition.

open fun setCamera(@NonNull freeCameraOptions: FreeCameraOptions)

Sets the map view with the free camera options.

setRenderWorldCopies

open fun setRenderWorldCopies(renderWorldCopies: Boolean)

Sets whether multiple copies of the world will be rendered side by side beyond -180 and 180 degrees longitude.

setStyleAtmosphere

@NonNull

open fun setStyleAtmosphere(@NonNull properties: Value): Expected<String, None>

Sets the style global [atmosphere](https://docs.mapbox.com/mapbox-gl-js/style-spec/#fog) properties.

setStyleAtmosphereProperty

@NonNull

open fun setStyleAtmosphereProperty(@NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to the the style atmosphere property.

setStyleCustomGeometrySourceTileData

@NonNull

open fun setStyleCustomGeometrySourceTileData(@NonNull sourceId: String, @NonNull tileId: CanonicalTileID, @NonNull featureCollection: List<Feature>): Expected<String, None>

Set tile data of a custom geometry.

setStyleGeoJSONSourceData

@NonNull

open fun setStyleGeoJSONSourceData(@NonNull sourceId: String, @NonNull data: GeoJSONSourceData): Expected<String, None>

setStyleJSON

open fun setStyleJSON(@NonNull json: String)

Load the style from a provided JSON string.

setStyleLayerProperties

@NonNull

open fun setStyleLayerProperties(@NonNull layerId: String, @NonNull properties: Value): Expected<String, None>

Sets style layer properties.

setStyleLayerProperty

@NonNull

open fun setStyleLayerProperty(@NonNull layerId: String, @NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to a style layer property.

setStyleLight

@NonNull

open fun setStyleLight(@NonNull properties: Value): Expected<String, None>

Sets the style global [light](https://docs.mapbox.com/mapbox-gl-js/style-spec/#light) properties.

setStyleLightProperty

@NonNull

open fun setStyleLightProperty(@NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to the the style light property.

setStyleProjection

@NonNull

open fun setStyleProjection(@NonNull properties: Value): Expected<String, None>

Sets the map's [projection](https://docs.mapbox.com/mapbox-gl-js/style-spec/projection/).

setStyleProjectionProperty

@NonNull

open fun setStyleProjectionProperty(@NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to the the style projection property.

setStyleSourceProperties

@NonNull

open fun setStyleSourceProperties(@NonNull sourceId: String, @NonNull properties: Value): Expected<String, None>

Sets style source properties.

setStyleSourceProperty

@NonNull

open fun setStyleSourceProperty(@NonNull sourceId: String, @NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to a style source property.

setStyleTerrain

@NonNull

open fun setStyleTerrain(@NonNull properties: Value): Expected<String, None>

Sets the style global [terrain](https://docs.mapbox.com/mapbox-gl-js/style-spec/#terrain) properties.

setStyleTerrainProperty

@NonNull

open fun setStyleTerrainProperty(@NonNull property: String, @NonNull value: Value): Expected<String, None>

Sets a value to the the style terrain property.

setStyleTransition

open fun setStyleTransition(@NonNull transitionOptions: TransitionOptions)

Overrides the map style's transition options with user-provided options.

setStyleURI

open fun setStyleURI(@NonNull uri: String)

Load style from provided URI.

styleLayerExists

open fun styleLayerExists(@NonNull layerId: String): Boolean

Checks whether a given style layer exists.

styleSourceExists

open fun styleSourceExists(@NonNull sourceId: String): Boolean

Checks whether a given style source exists.

open fun subscribe(@NonNull observer: Observer, @NonNull events: List<String>)

Subscribes an `observer` to a provided array of event types.

unsubscribe

open fun unsubscribe(@NonNull observer: Observer)

Unsubscribes an `observer` from all events.

open fun unsubscribe(@NonNull observer: Observer, @NonNull events: List<String>)

Unsubscribes an `observer` from a provided array of event types.

updateStyleImageSourceImage

@NonNull

open fun updateStyleImageSourceImage(@NonNull sourceId: String, @NonNull image: Image): Expected<String, None>

Updates the image of an [image style source](https://docs.mapbox.com/mapbox-gl-js/style-spec/#sources-image).