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?

onCircleClickListener

var onCircleClickListener: OnCircleClickListener?

onGroundOverlayClickListener

var onGroundOverlayClickListener: OnGroundOverlayClickListener?

onInfoWindowClickListener

var onInfoWindowClickListener: OnInfoWindowClickListener?

onInfoWindowCloseListener

var onInfoWindowCloseListener: OnInfoWindowCloseListener?

onMarkerClickListener

var onMarkerClickListener: OnMarkerClickListener?

onPolygonClickListener

var onPolygonClickListener: OnPolygonClickListener?

onPolylineClickListener

var onPolylineClickListener: OnPolylineClickListener?

Functions

addCircle

fun addCircle(circle: Circle): Circle

Adds a circle to the map.

addGeoJson

fun addGeoJson(geoJsonString: String): GeoJsonResult

Parses GeoJSON and adds all features to the map.

addGroundOverlay

fun addGroundOverlay(groundOverlay: GroundOverlay): GroundOverlay

Adds a ground overlay 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.

addTileOverlay

fun addTileOverlay(tileOverlay: TileOverlay): TileOverlay

Adds a tile overlay to the map.

animateCamera

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

Animates the camera to a new position.

clearCircles

fun clearCircles()

Removes all circles from the map.

clearGroundOverlays

fun clearGroundOverlays()

Removes all ground overlays from the map.

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.

clearTileOverlays

fun clearTileOverlays()

Removes all tile overlays 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.

drawEdgeEffects

fun drawEdgeEffects(canvas: Canvas, width: Int, height: Int)

Draws the custom edge glow effects on the canvas.

getCameraPosition

fun getCameraPosition(): CameraPosition

Returns the current camera position.

getCenter

fun getCenter(): LatLng

Returns the current map center.

getCircles

fun getCircles(): List<Circle>

Returns a copy of all circles on the map.

getGroundOverlays

fun getGroundOverlays(): List<GroundOverlay>

Returns a copy of all ground overlays on the map.

getLatLngBoundsForCameraTarget

fun getLatLngBoundsForCameraTarget(): LatLngBounds?

Returns the current camera target bounds constraint.

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.

getTileOverlays

fun getTileOverlays(): List<TileOverlay>

Returns a copy of all tile overlays on the map.

getTileSource

fun getTileSource(): TileSource?

Gets the current tile source.

getZoom

fun getZoom(): Float

Returns the current zoom level.

handleCircleTouch

fun handleCircleTouch(x: Float, y: Float): Circle?

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

handleGroundOverlayTouch

fun handleGroundOverlayTouch(x: Float, y: Float): GroundOverlay?

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.

hasActiveEdgeEffect

fun hasActiveEdgeEffect(): Boolean

Checks if any edge glow is currently active.

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.

releaseEdgeEffects

fun releaseEdgeEffects()

Releases all edge glows, allowing them to decay naturally.

removeCircle

fun removeCircle(circle: Circle): Boolean

Removes a circle from the map.

removeGroundOverlay

fun removeGroundOverlay(groundOverlay: GroundOverlay): Boolean

Removes a ground overlay from the map.

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.

removeTileOverlay

fun removeTileOverlay(tileOverlay: TileOverlay): Boolean

Removes a tile overlay 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.

setLatLngBoundsForCameraTarget

fun setLatLngBoundsForCameraTarget(bounds: LatLngBounds?)

Sets a LatLngBounds to constrain the camera target.

setMapPadding

fun setMapPadding(left: Int, top: Int, right: Int, bottom: Int)

Sets map padding that affects the logical viewport.

setMapType

fun setMapType(mapType: Int)

Sets the map type with API key handling.

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.

setUiSettings

fun setUiSettings(settings: UiSettings)

Sets the UiSettings instance for controlling UI behavior.

setViewSize

fun setViewSize(width: Int, height: Int)

Sets the view dimensions for rendering calculations.

setZoom

fun setZoom(z: Float)

Sets the zoom level, clamping to valid range.

stopAnimation

fun stopAnimation()

Stops any ongoing camera animation.

triggerEdgeEffect

fun triggerEdgeEffect(edges: Set<Edge>, intensity: Float = 0.8f)

Triggers the edge glow effect on specified edges.

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.