Interact with map

How to interact with map using buttons and gestures, so you could pan, rotate and zoom in/out the map, how to rotate the map manually or automatically by compass or by bearing and how to change zoom scale.

Gestures

Gestures are important part of the map navigation.

Map Action	Gesture
Move	Press on the map with one finger and move around
Slide	Swipe the map with one finger
Zoom in	Double tap on the map with one finger Double tap on the map with one finger and then swipe up Pinch with two fingers
Zoom out	Double tap on the map with two fingers Double tap on the map with one finger and then swipe down Pinch with two fingers
Rotate	Press with two fingers on the map and rotate
Tilt - 3D	Press with two fingers on the map and then swipe up or down. Android: switch on OpenGL rendering and restart OsmAnd. Currently we have variable tilt angle, it depends on device's screen height in pixels: Minimum - from 33 to 45 degrees. Note: Thus tablets have a smaller tilt angle than phones.

Slide animations could be disabled with special setting.

My Location & Zoom

My location is a circle button that shows whether the center of the map is synchronized with "my location" (geolocation of the device). It is also known as "Where am I?". Generally in navigation, the map is synced with device location, and there are no needs to move the map constantly. In this case, the button is hidden and will be activated when the map and 'my location' will go out of sync by user gesture. The app will try to find the device location and show it on the map at the center of the screen when the user clicks on it. It will switch to the 3D mode when the user click twice on it.

My location button has following indicative states:

• Full blue icon - location is found but it is not synchronized with map
• White icon - location is found and it is synchronized with map
• Grey icon - location has not found yet
• Arrow icon - 3D mode is switched on

Long tap on My location opens Context menu, so user can share own location.

Zoom buttons are always visible next to My Location and allow to control map zoom level. Changing zoom level doesn't change map synchronization with location. Long tap on Zoom buttons opens Map magnifier dialog and allows to change map detailing.

Keep in mind that during navigation zoom can be controlled by Auto zoom setting:

Android: Menu → Settings → App profiles → Navigation settings → Map during navigation → Auto zoom map

iOS: Menu → Settings → App profiles → Navigation settings → Map during navigation → Auto zoom map

Map magnifier

Map magnifier is a special way to magnify the map. Essentially it works as a magnifying glass for paper maps, it allows to see the text bigger for raster maps or to see more or less details for the same scale - Read more.

Map orientation & Compass

Compass widget indicates how map is oriented on the device screen and top arrow / red arrow points where the north of map is located. It also shows the current Map orientation mode. Clicking on the compass will cycle through all Map orientation modes.

Configure visibility

Android Menu → Configure screen → Buttons → Compass

iOS Menu → Configure screen → Left panel → Compass

Map orientation modes

• Fixed (north is up) - map is not being rotated by any external movements, and it could be rotated only by 2 pointer gesture (2 double tap & rotate).
• Movement direction - map is being rotated by bearing, i.e. direction of your movement (GPS direction) is synchronized with the map. Read more.
• Compass direction - map is being synchronized with the device compass orientation. So, Compass widget will point to actual Earth North if device is held flat. In case compass sensor is not present on device, map orientation won't change.

Map orientation could be changed in Profile settings:

Android Menu → Configure profile → General settings → Map orientation

iOS Menu → Settings → App profiles → General settings → Appearance → Map orientation

Rotate map by bearing

If rotate map by bearing is enabled, then the map will be oriented, so that head looking view will be strictly above (higher) my location icon on the map. Without movement the map won't be rotated. In this mode the center of the map will be located slightly below the center of the device. It allows seeing more map information ahead of your movement which is usable in the navigation mode. It can be disabled by a setting

Android Menu → Settings → Profiles → General settings → Display position always in center

iOS Menu → Settings → App profiles → General settings → Display position always in center

Settings

Disable all animations

You can disable all map animations during map change (gestures and buttons) in Settings Android Menu → Settings → Profiles → General settings → No animations

Extra compass settings

• Use Kalman filter (Android) - smoothen rotation of the map with a slower rotation animation though it introduces a small delay (< 1 second) till: Android Menu → Settings → Profiles → General settings → Other → Use Kalman filter

• Use Magnetic sensor - smoothen rotation of the map with a slower rotation animation though it introduces a small delay (< 1 second) till: Android Menu → Settings → Profiles → General settings → Other → Use magnetic sensor

External input device buttons (Android)

Select an external control device, such as a keyboard or WunderLINQ.

Android Menu → Settings → Profiles → General settings → External input devices

Note: the keyboard works with the setting disabled too.

Key	Device	Action
C	Keyboard	"My location"
D	Keyboard	"Map orientation"
↑	Keyboard	Move up
↓	Keyboard	Move down
←	Keyboard	Move left
→	Keyboard	Move right
+	Keyboard	Zoom in
−	Keyboard	Zoom out
Menu (legacy Android)	Keyboard	Drawer
Joystick click (legacy Android)	Keyboard	"My location"
Media button	Keyboard	AV notes
←	Parrot	Zoom out
→	Parrot	Zoom in
↓	Wunderlinq	Zoom out
↑	Wunderlinq	Zoom in
ESC	Wunderlinq	Opens Wunderlinq dashboard

You can check other details in the code.