Map Events ¶

The SDK provides event listeners that let you monitor and respond to various map interactions and state changes, such as camera movements, marker clicks, or gesture inputs.

Map Click Event ¶

This event fires whenever the user performs a tap or click on the map surface, allowing you to respond to user interactions.

Kotlin¶

val callback = object: MapplsMap.OnMapClickListener {
    override fun onMapClick(p0: LatLng): Boolean {
        return false
    }
}
// To add Listener
mapplsMap.addOnMapClickListener(callback)

//To remove Listener
mapplsMap.removeOnMapClickListener(callback)

Java¶

MapplsMap.OnMapClickListener callback = new MapplsMap.OnMapClickListener() {
    @Override
    public boolean onMapClick(@NonNull LatLng latLng) {
        return false; 
    }
}
// To add Listener
mapplsMap.addOnMapClickListener(callback);

//To remove Listener
mapplsMap.removeOnMapClickListener(callback);

Map Long Click Event ¶

This event is fired when the user long-presses on the map surface, enabling custom actions or interactions based on long-click input.

Kotlin¶

val callback = object: MapplsMap.OnMapLongClickListener {
    override fun onMapLongClick(p0: LatLng): Boolean {
        return false
    }
}
// To add Listener
mapplsMap.addOnMapLongClickListener(callback)

//To remove Listener
mapplsMap.removeOnMapLongClickListener(callback)

Java¶

MapplsMap.OnMapLongClickListener callback = new MapplsMap.OnMapLongClickListener() {
    @Override
    public boolean onMapLongClick(@NonNull LatLng latLng) {
        return false; 
    }
}
// To add Listener
mapplsMap.addOnMapLongClickListener(callback);

//To remove Listener
mapplsMap.removeOnMapLongClickListener(callback);

Camera Events ¶

The SDK provides several camera events, including:

Camera Movement Ended ¶

Triggered when the camera movement completes, this callback indicates that all animations or user-driven camera changes have finished.

Kotlin¶

val callback = object: MapplsMap.OnCameraIdleListener {
    override fun onCameraIdle() {

    }
}
// To add Listener
mapplsMap.addOnCameraIdleListener(callback)

//To remove Listener
mapplsMap.removeOnCameraIdleListener(callback)

Java¶

MapplsMap.OnCameraIdleListener callback = new MapplsMap.OnCameraIdleListener() {
    @Override
    public void onCameraIdle() {

    }
};
// To add Listener
mapplsMap.addOnCameraIdleListener(callback);

//To remove Listener
mapplsMap.removeOnCameraIdleListener(callback);

Camera Movement Canceled ¶

Triggered when a camera movement is cancelled, this callback lets you respond to aborted or interrupted map camera animations or gestures.

Kotlin¶

val callback = object: MapplsMap.OnCameraMoveCanceledListener {
    override fun onCameraMoveCanceled() {

    }
}
// To add Listener
mapplsMap.addOnCameraMoveCancelListener(callback)

//To remove Listener
mapplsMap.removeOnCameraMoveCancelListener(callback)

Java¶

MapplsMap.OnCameraMoveCanceledListener callback = new MapplsMap.OnCameraMoveCanceledListener() {
    @Override
    public void onCameraMoveCanceled() {
    }
};
// To add Listener
mapplsMap.addOnCameraMoveCancelListener(callback);

//To remove Listener
mapplsMap.removeOnCameraMoveCancelListener(callback);

Camera Movement Started ¶

Triggered when camera movement starts, this callback helps identify the initiation of a map transition, whether due to gestures, animations, or code-driven changes.

Kotlin¶

val callback = object : MapplsMap.OnCameraMoveStartedListener {
    override fun onCameraMoveStarted(reason: Int) {
    }
}
// To add Listener
mapplsMap.addOnCameraMoveStartedListener(callback)

//To remove Listener
mapplsMap.removeOnCameraMoveStartedListener(callback)

Java¶

MapplsMap.OnCameraMoveStartedListener callback = new MapplsMap.OnCameraMoveStartedListener() {
    @Override
    public void onCameraMoveStarted(int reason) {

    }
};
// To add Listener
mapplsMap.addOnCameraMoveStartedListener(callback);

//To remove Listener
mapplsMap.removeOnCameraMoveStartedListener(callback);

Values of reason parameter: - REASON_API_GESTURE - REASON_DEVELOPER_ANIMATION - REASON_API_ANIMATION

Camera Movement Changes ¶

Invoked when there is a change in camera movement, this callback allows you to monitor transitions such as pan, zoom, tilt, or bearing updates on the map.

Kotlin¶

val callback = object : MapplsMap.OnCameraMoveListener {
    override fun onCameraMove() {

    }
}
// To add Listener
mapplsMap.addOnCameraMoveListener(callback)

//To remove Listener
mapplsMap.removeOnCameraMoveListener(callback)

Java¶

MapplsMap.OnCameraMoveListener callback = new MapplsMap.OnCameraMoveListener() {
    @Override
    public void onCameraMove() {

    }
};
// To add Listener
mapplsMap.addOnCameraMoveListener(callback);

//To remove Listener
mapplsMap.removeOnCameraMoveListener(callback);

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support
Need support? contact us!