OpenMapView/de.afarber.openmapview/MapController

MapController

class MapController(context: Context)(source)

Core controller managing map state, rendering, and interactions.

Handles map positioning (zoom, center), tile management, marker rendering, shape drawing, camera animations, and touch event processing.

This class is used internally by OpenMapView and is not part of the public API.

Constructors

MapController

constructor(context: Context)

Types

Companion

object Companion

Properties

onCameraIdleListener

var onCameraIdleListener: OnCameraIdleListener?

onCameraMoveCanceledListener

var onCameraMoveCanceledListener: OnCameraMoveCanceledListener?

onCameraMoveListener

var onCameraMoveListener: OnCameraMoveListener?

onCameraMoveStartedListener

var onCameraMoveStartedListener: OnCameraMoveStartedListener?

onInfoWindowClickListener

var onInfoWindowClickListener: OnInfoWindowClickListener?

onMarkerClickListener

var onMarkerClickListener: (Marker) -> Boolean?

onPolygonClickListener

var onPolygonClickListener: OnPolygonClickListener?

onPolylineClickListener

var onPolylineClickListener: OnPolylineClickListener?

Functions

addGeoJson

fun addGeoJson(geoJsonString: String): GeoJsonResult

Parses GeoJSON and adds all features to the map.

addMarker

fun addMarker(marker: Marker): Marker

Adds a marker to the map.

addPolygon

fun addPolygon(polygon: Polygon): Polygon

Adds a polygon to the map.

addPolyline

fun addPolyline(polyline: Polyline): Polyline

Adds a polyline to the map.

animateCamera

fun animateCamera(cameraUpdate: CameraUpdate, durationMs: Int = 250, listener: OnCameraAnimationListener? = null)

Animates the camera to a new position.

clearMarkers

fun clearMarkers()

Removes all markers from the map.

clearPolygons

fun clearPolygons()

Removes all polygons from the map.

clearPolylines

fun clearPolylines()

Removes all polylines from the map.

commitPan

fun commitPan()

Commits accumulated pan offsets to the map center.

createProjection

fun createProjection(): Projection

Creates a Projection instance for coordinate conversions.

draw

fun draw(canvas: Canvas)

Renders the map to the provided canvas.

getCameraPosition

fun getCameraPosition(): CameraPosition

Returns the current camera position.

getCenter

fun getCenter(): LatLng

Returns the current map center.

getMarkers

fun getMarkers(): List<Marker>

Returns a copy of all markers on the map.

getMaxZoomLevel

fun getMaxZoomLevel(): Float

Returns the current maximum zoom level preference.

getMinZoomLevel

fun getMinZoomLevel(): Float

Returns the current minimum zoom level preference.

getPolygons

fun getPolygons(): List<Polygon>

Returns a copy of all polygons on the map.

getPolylines

fun getPolylines(): List<Polyline>

Returns a copy of all polylines on the map.

getZoom

fun getZoom(): Double

Returns the current zoom level.

handleInfoWindowTouch

fun handleInfoWindowTouch(x: Float, y: Float): Marker?

Finds the info window at the specified screen coordinates.

handleMarkerTouch

fun handleMarkerTouch(x: Float, y: Float): Marker?

Finds the topmost marker at the specified screen coordinates.

handlePolygonTouch

fun handlePolygonTouch(x: Float, y: Float): Polygon?

Checks if a touch at screen coordinates hits a clickable polygon.

handlePolylineTouch

fun handlePolylineTouch(x: Float, y: Float): Polyline?

Checks if a touch at screen coordinates hits a clickable polyline.

moveCamera

fun moveCamera(cameraUpdate: CameraUpdate)

Moves the camera instantly to a new position.

onDestroy

fun onDestroy()

Cleans up resources to prevent memory leaks.

onPause

fun onPause()

Called when the app goes to the background.

onResume

fun onResume()

Called when the app comes to the foreground.

removeMarker

fun removeMarker(marker: Marker): Boolean

Removes a marker from the map.

removePolygon

fun removePolygon(polygon: Polygon): Boolean

Removes a polygon from the map.

removePolyline

fun removePolyline(polyline: Polyline): Boolean

Removes a polyline from the map.

resetMinMaxZoomPreference

fun resetMinMaxZoomPreference()

Resets the min/max zoom preferences to their defaults (2.0 - 19.0).

screenToLatLng

fun screenToLatLng(screenX: Float, screenY: Float): LatLng

Converts screen coordinates to geographic coordinates.

setCenter

fun setCenter(latLng: LatLng)

Sets the map center to the specified location.

setMaxZoomPreference

fun setMaxZoomPreference(maxZoom: Float)

Sets the maximum zoom level preference.

setMinZoomPreference

fun setMinZoomPreference(minZoom: Float)

Sets the minimum zoom level preference.

setOnTileLoadedCallback

fun setOnTileLoadedCallback(callback: () -> Unit)

Sets a callback to be invoked when tiles finish loading.

setViewSize

fun setViewSize(width: Int, height: Int)

Sets the view dimensions for rendering calculations.

setZoom

fun setZoom(z: Double)

Sets the zoom level, clamping to valid range.

stopAnimation

fun stopAnimation()

Stops any ongoing camera animation.

updatePanOffset

fun updatePanOffset(dx: Float, dy: Float)

Updates the temporary pan offset during a drag gesture.

zoom

fun zoom(scaleFactor: Float, focusX: Float, focusY: Float)

Applies a zoom gesture centered on a specific screen point.