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);