Map events

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

Panning
Single click
Double click
Long click
Map rotate
Camera movement

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

Use the following code snippets 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, double-clicked or panned, then you need to define your own TomtomMapCallback listeners:

1TomtomMapCallback.OnMapClickListener onMapClickListener =
2        latLng -> displayMessage(R.string.menu_events_on_map_click, latLng)
3
4TomtomMapCallback.OnMapLongClickListener onMapLongClickListener =
5        latLng -> displayMessage(R.string.menu_events_on_map_long_click, latLng);
6
7TomtomMapCallback.OnMapDoubleClickListener onMapDoubleClickListener =
8        latLng -> displayMessage(R.string.menu_events_on_map_double_click, latLng);
9
10TomtomMapCallback.OnMapPanningListener onMapPanningListener = new TomtomMapCallback.OnMapPanningListener() {
11    @Override
12    public void onMapPanningStarted() {
13        displayMessage(R.string.menu_events_on_map_panning_started, tomtomMap.getCenterOfMap());
14    }
15
16    @Override
17    public void onMapPanningOngoing() {
18        displayMessage(R.string.menu_events_on_map_panning_ongoing, tomtomMap.getCenterOfMap());
19    }
20
21    @Override
22    public void onMapPanningEnded() {
23        displayMessage(R.string.menu_events_on_map_panning_ended, tomtomMap.getCenterOfMap());
24    }
25};

1val showMessageWhenOnMapClick: TomtomMapCallback.OnMapClickListener =
2    TomtomMapCallback.OnMapClickListener { latLng -> displayMessage(SINGLE_PRESS_TITLE, latLng) }
3
4val showMessageWhenOnMapLongClick: TomtomMapCallback.OnMapLongClickListener =
5    TomtomMapCallback.OnMapLongClickListener { latLng -> displayMessage(LONG_CLICK_TITLE, latLng) }
6
7val showMessageWhenOnMapDoubleClick: TomtomMapCallback.OnMapDoubleClickListener =
8    TomtomMapCallback.OnMapDoubleClickListener { latLng -> displayMessage(DOUBLE_CLICK_TITLE, latLng) }
9
10val showMessageWhenMapPanningOccurs: TomtomMapCallback.OnMapPanningListener =
11    object : TomtomMapCallback.OnMapPanningListener {
12        override fun onMapPanningStarted() {
13            displayMessage(MAP_PANNING_STARTED_TITLE)
14        }
15
16        override fun onMapPanningOngoing() {
17            displayMessage(MAP_PANNING_ONGOING_TITLE)
18        }
19
20        override fun onMapPanningEnded() {
21            displayMessage(MAP_PANNING_ENDED_TITLE)
22        }
23    }

Then set them to your TomtomMap instance:

After callbacks are no longer required you can unregister them by calling:

If you want to receive information about the camera changing its position, then you need to define your own TomtomCallback listeners:

Then register them using your TomtomMap instance:

After callbacks are no longer required you can unregister them by calling:

In this example you will see a Toast with the 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 the GesturesConfiguration object to tomtomMap: By default all gestures are enabled.

Disable zooming gesture

Disable the rotating gesture

Disable the tilting gesture

Disable the panning gesture

You can turn off more than one gesture by setting up the mask on properties as shown in the following code snippets:

If you want to enable gestures, pass the GesturesConfiguration object to the tomtomMap object as shown in the following code snippets:

or even in a simpler way: