Skip to main content

Interact with map

Overview​

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 ActionGesture
MovePress on the map with one finger and move around.
SlideSwipe the map with one finger.
Zoom inDouble tap the map with one finger
Double tap the map with one finger and then swipe down
Pinch with two fingers.
Zoom outDouble tap the map with two fingers
Double tap the map with one finger and then swipe up
Pinch with two fingers.
RotateTap with two fingers on the map and rotate.
Tilt - 3DTap with two fingers on the map and then move them up/down
This option is only available with map rendering engine version 2 (OpenGL).

Slide animations could be disabled with special setting.

My Location & Zoom​

Configure screen menu

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 and Compass​

Map orientation modes​

The map orientation modes allow the user to select how the map is displayed on the device screen. Enabling each mode changes the way the map is oriented according to the selected option.

Menu β†’ Settings β†’ Profiles β†’ General settings β†’ Appearance β†’ Map orientation

Compass widget

  • North is up. The map is fixed in the direction of the North, which is the top edge of your device. The map does not have automatic rotation, but you can rotate it manually with a two-pointer gesture (two-finger touch & rotate), and in this case, the map orientation mode will change to Manual rotation. You can hard lock the North mode for Android by the Enable Fixed North Up feature.
  • Movement direction. The map rotates relative to the direction of your movement known from GPS data. For details, go to Rotate map by bearing.
  • Compass direction. The icon on the button points to the actual North, and the map moves according to the compass orientation of your device. Your device should be in as horizontal a position as possible. If your device does not have a compass sensor, the orientation of the map remains unchanged.
  • Manually rotated. When you select this option, the map is fixed in the current position and does not rotate automatically. You can manually change the map orientation with a two-pointer gesture (two-finger touch & rotate).

Note

Compass​

Menu β†’ Configure screen β†’ Buttons β†’ Compass

Compass widget

The compass button shows how the map is oriented. The red arrow, or the direction of the arrow in Movement direction mode, indicates the North. The icon on the button indicates the current map orientation mode. One tap the compass button toggles through all modes in turn.

Rotate map by bearing​

If rotate map by bearing (rotation by movement direction) is enabled, the map will be oriented so that the forward view will be strictly above the icon of my location 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 you to see more map data before you move, which is useful in the navigation mode.
Rotate map by bearing mode can be changed in Profile settings or by single tap the Compass.

Map Tilt and Horizon​

With new map rendering engine you can change camera tilt from 90 (no tilt) to 10 degrees. Approximately at map tilt less than 20-22 degrees (this parameter depends on zoom level), the imaginary horizon line becomes visible. Unlike the real one, the program horizon is always straight.

Tilt android 1 Tilt android 2

Under horizon you can see so-called haze or fog. This area of the map is filled with grey color, only few map details can be observed.
The use of fog is necessary, since the display of remote objects on the map requires significant computing resources and is not always justified due to map distortions at small viewing angles. So the visible distance on OsmAnd map is currently limited to 35 tiles.

info

Map tilt can be changed by long press on the screen with two fingers and moving them up/down. You can also change tilt by tapping on the "My location" icon in the lower-right corner of the screen (only 45 and 90 degree positions are available).
You can not change Camera tilt when old map rendering engine (version 1) is on.

Settings​

External input device buttons​

External input device buttons provide a convenient and efficient way to interact with the map and the OsmAnd application interface. They are located on external devices, such as Bluetooth or other types of keyboards, specialized buttons on vehicle navigation devices, WunderLINQ, Parrot and other controllers.

One of the main functions of the external input device buttons is to zoom in and out on the map. They also allow you to navigate around the map, and change map orientation without having to tap and gesture at the screen. The external input device buttons also support other functions, such as opening the main menu or AV Notes.

note

The keyboard continues to work even if the External input devices option is turned off, when None is selected.

Enabled the External input device function:

Menu β†’ Settings β†’ Profiles β†’ General settings β†’ External input devices

After you need to choose your device Type: Keyboard, Parrot, WunderLINQ or create your own type.

External devices External devices

Each External input devices Type has Key assignments. You can click on Key assignments to see the list of actions and kyes. Table with Keys you can see below:

KeyDeviceAction
CKeyboardMy location
DKeyboardMap orientation
NKeyboardOpen Navigation view.
SKeyboardOpen Search view.
PKeyboardSwitch to the next app profile. Show toast like message App profile: Name.
OKeyboardSwitch to the previous app profile.
↑ KeyboardMove up
↓ KeyboardMove down
← KeyboardMove left
β†’ KeyboardMove right
+ KeyboardZoom in
βˆ’ KeyboardZoom out
Menu (legacy Android)KeyboardDrawer
Joystick click (legacy Android)KeyboardMy location
Media buttonKeyboardAV notes
← ParrotZoom out
β†’ ParrotZoom in
↓ WunderlinqZoom out
↑ WunderlinqZoom in
ESCWunderlinqOpens Wunderlinq dashboard
note

You can read more about the actions of external input devices on GitHub in the MapActivityKeyListener package.

Extra compass settings​

  • Use Kalman filter - Reduces noise in compass readings but adds inertia. Smoothes the rotation of the card with a slower rotation animation, although this introduces a slight delay, not more than 1 second.
    Menu β†’ Settings β†’ Profiles β†’ General settings β†’ Other β†’ Use Kalman filter

  • Use magnetic sensor - For the compass reading, use the magnetic sensor instead of the orientation sensor. Smoothes the rotation of the card with a slower rotation animation, although this introduces a slight delay, not more than 1 second.
    Menu β†’ Settings β†’ Profiles β†’ General settings β†’ Other β†’ Use magnetic sensor

No animations​

You can turn off all map animations during map changes, such as gestures and buttons.
Menu β†’ Settings β†’ Profiles β†’ General settings β†’ No animations

⚠️ Android only
This feature is currently not available for the iOS version of the OsmAnd app.

Animate own position (iOS: Animate my location)​

Android: Menu β†’ Settings β†’ App profiles
iOS: Menu β†’ Settings β†’ Profiles β†’ Navigation settings β†’ Animate own position

Creates a smooth map panning effect versus the My Position icon when in motion. The effect introduces a slight delay versus ground truth of about 1 second. Enabling this has been reported to create some pronounced lag issues under some circumstances, disable if such issues arise.

Assign custom keys​

You can create your own Type of keys for an external input device:

Menu β†’ Settings β†’ Profiles β†’ General settings β†’ External input devices β†’ Type β†’ +

External devices External devices

Now, you can change buttons for actions. Just go to your created Type:

Menu β†’ Settings β†’ Profiles β†’ General settings β†’ External input devices β†’ Type β†’ Your type β†’ Key assignments β†’ Click to any Actions or Map interactions β†’ + or Button

External devices

Now, press the button on your device to assign it to the action.

External devices

If this button is used for another action you see a warning about it and a question about the reassignment. This way the user can assign his actions to the External input device buttons. You can reset key assignments by clicking to Reset button in the top corner of the screen:

Menu β†’ Settings β†’ Profiles β†’ General settings β†’ External input devices β†’ Type β†’ Your type β†’ Key assignments β†’ Reset.

All key assignments for the selected type will be removed.