Map events

Implement any action you need to be triggered on one of the following map events:

Panning.
Single press.
Double press.
Long press.

Sample use case: In your app, users invoke one behavior with a single press and another with a long press.

Use the code snippets below in your app to catch map events. In this example, the action is simply to display a toast with latitude and longitude on each map event. Of course, you can implement other cool features instead.

If you want to receive callbacks after a map is clicked, long-clicked or
panned, then you need to define your own TomtomMapCallback listeners:

_

private TomtomMapCallback.OnMapClickListener onMapClickListener =
        latLng -> displayMessage(
                R.string.menu_events_on_map_click,
                latLng.getLatitude(),
                latLng.getLongitude()
        );
private TomtomMapCallback.OnMapLongClickListener onMapLongClickListener =
        latLng -> displayMessage(
                R.string.menu_events_on_map_long_click,
                latLng.getLatitude(),
                latLng.getLongitude()
        );
private TomtomMapCallback.OnMapViewPortChanged onMapViewPortChangedListener =
        (focalLatitude, focalLongitude, zoomLevel, perspectiveRatio, yawDegrees) -> displayMessage(
                R.string.menu_events_on_map_panning,
                focalLatitude,
                focalLongitude
        );

private val showMessageWhenOnMapClick: TomtomMapCallback.OnMapClickListener = object : TomtomMapCallback.OnMapClickListener {
    override fun onMapClick(latLng: LatLng) {
        displayMessage(SINGLE_PRESS_TITLE, latLng)
    }
}

private val showMessageWhenOnMapLongClick: TomtomMapCallback.OnMapLongClickListener = object : TomtomMapCallback.OnMapLongClickListener {
    override fun onMapLongClick(latLng: LatLng) {
        displayMessage(LONG_CLICK_TITLE, latLng)
    }
}

private val showMessageWhenOnMapViewPortChanges: TomtomMapCallback.OnMapViewPortChanged = object : TomtomMapCallback.OnMapViewPortChanged {
    override fun onMapViewPortChanged(lat: Float, lon: Float, zoom: Double, perspectie: Float, yaw: Float) {
        displayMessage(VIEW_PORT_CHANGE_TITLE, LatLng(lat.toDouble(), lon.toDouble()))
    }
}

Then you just have to set them to your TomtomMap instance:

_

tomtomMap.addOnMapClickListener(onMapClickListener);
tomtomMap.addOnMapLongClickListener(onMapLongClickListener);
tomtomMap.addOnMapViewPortChangedListener(onMapViewPortChangedListener);

tomtomMap.addOnMapClickListener(showMessageWhenOnMapClick)
tomtomMap.addOnMapLongClickListener(showMessageWhenOnMapLongClick)
tomtomMap.addOnMapViewPortChangedListener(showMessageWhenOnMapViewPortChanges)

In this example you will see a Toast with latitude and longitude of a
point that was clicked on the map, but you can utilize this information
in your own manner.

Receive callbacks after the map is clicked

Receive callbacks after the map is long clicked

Receive callbacks after the map panning

Enable and disable gestures

You can disable gestures such as zooming, panning and rotating in your application by passing gestures settings object to tomtomMap:
By default all gestures are enabled.

Disable zooming gesture

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .zoomEnabled(false)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .zoomEnabled(false)
                .build())

Disable the rotating gesture

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(false)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(false)
                .build()
)

Disable the tilting gesture

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .tiltEnabled(false)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .tiltEnabled(false)
                .build()
)

Disable the panning gesture

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .panningEnabled(false)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .panningEnabled(false)
                .build()
)

You can turn off more than one gesture by setting up the mask on properties like below:

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(false)
                .panningEnabled(false)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(false)
                .panningEnabled(false)
                .build()
)

If you want to enable gestures, pass the GesturesDetectionSettings object to the tomtomMap object like below:

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(true)
                .panningEnabled(true)
                .zoomEnabled(true)
                .tiltEnabled(true)
                .build()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettingsBuilder.create()
                .rotationEnabled(true)
                .panningEnabled(true)
                .zoomEnabled(true)
                .tiltEnabled(true)
                .build()
)

or even in the simpler way:

_

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettings.createDefault()
);

tomtomMap.updateGesturesDetectionSettings(
        GesturesDetectionSettings.createDefault()
)

Map events

Map events

Enable and disable gestures

You are here