Skip to main content

Interact with map

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

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 on the map with one finger
Double tap on the map with one finger and then swipe down
Pinch with two fingers
Zoom outDouble tap on the map with two fingers
Double tap on the map with one finger and then swipe up
Pinch with two fingers
RotatePress with two fingers on the map and rotate
Tilt - 3DPress 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 & 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). In this case, the map orientation mode will change to Manual rotation.
  • 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

  • Map Orientation modes can be opened in Profile settings as well as by long-tapping the Compass button.

  • To quickly switch map orientation modes, tap the "Compass" button located in the upper left corner of the screen, if it is visible.

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 on 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.

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.

Own Type creation​

You can create your own Type:

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.

External devices External devices

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.

External devices

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 β†’ Navigation β†’ 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.