Camera

open class Camera

Represents a composite class comprised of tilt, orientation, zoom level and center point for a Map.

Types

CameraModel

abstract class CameraModel : Camera.PositionChangedListener, Camera.ModeChangedListener

ModeChangedListener

interface ModeChangedListener : Camera.CameraListener

MovementMode

@Retention(value = RetentionPolicy.CLASS)

annotation class MovementMode

Available camera movement modes.

PositionChangedListener

interface PositionChangedListener : Camera.CameraListener

RotationMode

@Retention(value = RetentionPolicy.CLASS)

annotation class RotationMode

Available camera rotation modes.

Functions

calculateFromMapRectangle

@NonNull

open fun calculateFromMapRectangle(@NonNull mapRectangle: MapRectangle, @NonNull mapCenter: MapCenter, @FloatRange(from = "-180.0", to = 180.0) rotation: Float, tilt: Float, @FloatRange(from = 0.0, to = Float.MAX_VALUE) maxZoomLevel: Float): CameraState.PositionOrientation

Calculates CameraState.

drag

open fun drag(xFrom: Float, yFrom: Float, xTo: Float, yTo: Float, animation: MapAnimation)

dragBy

open fun dragBy(x: Float, y: Float, animation: MapAnimation)

getCameraMovementMode

open fun getCameraMovementMode(): Int

Returns mode how camera should move when the vehicle is moving - if it is following the vehicle or not.

getCameraRotationMode

open fun getCameraRotationMode(): Int

Returns mode how the camera rotation should behave when the vehicle is moving.

getLocalRotation

open fun getLocalRotation(): Point3F

getLocalTranslation

open fun getLocalTranslation(): Point3F

getMapCenter

open fun getMapCenter(): MapCenter

Return the point of map on the screen which will be recognized as map center for rotation and vehicle position

getMapCenterSettings

open fun getMapCenterSettings(): MapCenterSettings

Return the point of map on the screen which will be recognized as map center for rotation and vehicle position

getMapPadding

open fun getMapPadding(): RectF

Return current map padding

getMapRectangle

open fun getMapRectangle(): GeoBoundingBox

getMinMaxZoomLevel

@NonNull

open fun getMinMaxZoomLevel(): Pair<Float, Float>

Returns the minimum a maximum value of zoom levels

getPosition

open fun getPosition(): GeoCoordinates

Return camera GeoCoordinates on the map.

getRotation

@FloatRange(from = "-180.0", to = 180.0)

open fun getRotation(): Float

Return the rotation of map in degrees.

getTilt

open fun getTilt(): Float

Returns the tilt of map in degrees.

getZoomLevel

@FloatRange(from = 0.0, to = Float.MAX_VALUE)

open fun getZoomLevel(): Float

Returns the zoom value from range (0 - 20.0) with an animation.

isValid

open fun isValid(): Boolean

Check if the camera object is valid.

rotateBy

open fun rotateBy(angle: Float, @NonNull focus: PointF, @NonNull animation: MapAnimation)

setCameraMovementMode

open fun setCameraMovementMode(mode: Int)

Sets how camera should move when the vehicle is moving - ff is following vehicle or not.

setCameraRotationMode

open fun setCameraRotationMode(mode: Int)

Sets how the camera rotation should behave when the vehicle is moving.

setLocalRotation

open fun setLocalRotation(@NonNull point: Point3F, @NonNull anim: MapAnimation)

setLocalTranslation

open fun setLocalTranslation(@NonNull point: Point3F, @NonNull anim: MapAnimation)

setMapCenterSettings

open fun setMapCenterSettings(@NonNull settings: MapCenterSettings, @NonNull initialAnim: MapAnimation)

Sets the map center (point for rotation axis and vehicle position) for locked and unlocked map state.

setMapPadding

open fun setMapPadding(@NonNull padding: RectF, @NonNull anim: MapAnimation)

Sets the padding of the map from left, top, right and bottom.

setMapRectangle

open fun setMapRectangle(@NonNull rectangle: MapRectangle)

open fun setMapRectangle(@NonNull rectangle: MapRectangle, @NonNull animation: MapAnimation)

Sets the position to rectangle on map specified by MapRectangle rectangle with margin.

setPosition

open fun setPosition(@NonNull position: GeoCoordinates, @NonNull animation: MapAnimation)

Move camera to given position GeoCoordinates on the map with an animation.

setRotation

open fun setRotation(@FloatRange(from = "-180.0", to = 180.0) rotation: Float, @NonNull animation: MapAnimation)

Sets the rotation of map in degrees.

setTilt

open fun setTilt(tilt: Float, @NonNull animation: MapAnimation)

Sets the tilt of map in degrees with an animation.

setZoomLevel

open fun setZoomLevel(@FloatRange(from = 0.0, to = Float.MAX_VALUE) zoomLevel: Float, @NonNull animation: MapAnimation)

Sets the zoom value from range (0 - 20.0).

tiltBy

open fun tiltBy(angle: Float, animation: MapAnimation)

zoomBy

open fun zoomBy(scale: Float, @NonNull focus: PointF, @NonNull animation: MapAnimation)