Skip to main content

Interact with Map

Overview​

This article explains how to customize and interact with the map using various buttons and gestures. It covers how to rotate, zoom, adjust the view angle, and change the map's view angle, rotate it manually or automatically using the compass, or according to bearing.

Gestures​

Gestures are essential for navigating the map easily and intuitively.

Map ActionGesture
MoveTap and hold the map with one finger, then drag to move around.
SlideSwipe the map with one finger.
Zoom InDouble tap the map with one finger.
Double tap with one finger and swipe down.
Pinch with two fingers to zoom in.
Zoom OutDouble tap with two fingers.
Double tap with one finger and swipe up.
Pinch with two fingers to zoom out.
RotateTap the map with two fingers, then rotate your fingers in a circular motion.
Tilt (3D)Tap with two fingers and move them up or down.
Available only with Map Rendering Engine version 2 (OpenGL).

Slide animations can be disabled in the settings with a special option.

My Location and Zoom​

Configure screen menu

My location.
The My Location button is a circular icon that indicates whether the map's center is synchronized with your device’s current geolocation. Often referred to as the "Where am I?" button, it helps you quickly find your location on the map. During navigation, the map typically stays synced with the device's location, so the button remains hidden. However, it becomes visible if the map and your location go out of sync due to user interaction. Tapping the button will re-center the map on your current location, and a double tap will switch the view to 3D mode.

  • The My Location button has the following states:

    • Full blue icon. The location is found but not synced with the map.
    • White icon. The location is found and synced with the map.
    • Grey icon. The location has not been found yet.
    • Arrow icon. 3D mode is activated.
  • Long tap (Android) on the My Location button opens the Map Context menu, allowing you to share your location.


Zoom buttons.
Zoom buttons are always visible next to My Location and allow you to control the map's zoom level.

  • Changing the zoom level does not affect the map's synchronization with your location.
  • Long tap Zoom buttons opens Map magnifier dialog,allowing you to adjust map detail levels.
  • Keep in mind that during navigation, the zoom can be controlled automatically by the 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

My Location Appearance​

You can customize My Location button icons using Profile appearance settings. Read more about how to do this here.

Map Magnifier​

The Map Magnifier is a tool that enhances the map's visibility, similar to a magnifying glass used with paper maps. It allows you to zoom in on the map to view text and details more clearly or to adjust the level of detail while maintaining the same scale. For more information, go to Vector Maps article.

Map Orientation Modes​

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

Compass widget

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.

  1. Manually rotated. When this option is selected, the map is fixed in the current position and does not rotate automatically. You can change the orientation of the map manually using a two-pointer gesture (two-finger touch and rotate). The manual rotation mode is set by default.

  2. Movement direction. The map rotates relative to the direction of your movement known from GPS data. For details, go to Rotate map by bearing.

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

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

    • for the Android version it has hard lock the North mode (without manual rotation with two-finger touch and rotate).
    • for the iOS version you can rotate it manually with a two-pointer gesture (two-finger touch and rotate), and in this case, the map orientation mode will change to Manually rotated.

Settings for map orientation modes:

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

  • To quickly switch between map orientation modes:

    • For Android version:
      Double tap the Compass button located in the upper left corner of the screen, if visible.

    • For iOS version:
      Single tap the Compass button located in the upper left corner of the screen, if visible.

  • (Android only) A single tap of the Compass button rotates the map orientation to the North in all orientations. Even if it reverts after a second, such as in compass mode.

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. Double tap (Android), One tap (iOS) the compass button toggles through all modes in turn.

Rotate Map by Bearing​

When the "rotate map by bearing" mode (rotation by movement direction) is enabled, the map is oriented so that your forward view aligns directly above the My Location icon. If there is no movement, the map will remain stationary.
In this mode, the map's center is positioned slightly below the center of the screen, allowing you to see more map data ahead of your movement β€” especially helpful in navigation mode.
You can adjust the "rotate map by bearing" mode in the Profile settings or by tapping the Compass.

Map Tilt and Horizon​

Tilt android 1 Tilt android 2

With new map rendering engine you can change camera tilt from 90 (no tilt) to 10 degrees. Approximately at a 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.

Under the horizon, you can see so-called haze or fog. This area of the map is filled with grey color, only a 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 the OsmAnd map is currently limited to 35 tiles.

info

Map tilt can be changed by a long tap the screen with two fingers and moving them up/down. You can also change the 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 the Camera tilt when the old map rendering engine (version 1) is on.

Settings​

Extra Compass Settings​

  • Use Kalman filter - Reduces noise in compass readings but adds inertia. Smoothes the rotation of the map 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 map 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​

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

You can disable all map animations during map interactions, including gestures and buttons.
Menu β†’ Settings β†’ Profiles β†’ General settings β†’ No animations

Animate Own Position​

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 it if such issues arise.

External Input Devices​

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, or WunderLINQ and Parrot controllers.

One of the main functions of buttons on external input devices is to zoom in and out of the map. They also allow you to navigate the map and change its orientation without having to tap and gesture on the screen. Buttons on external input devices support many other functions, such as opening the main menu.

note

The keyboard remains functional even when the External input devices option is turned off, and None is selected.

Preconfigured Input Device​

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

External devices External devices

To access the settings of an external input device, you need to enable this feature.

  • Go to the main Menu β†’ Settings β†’ select the Profile β†’ General settings β†’ Other β†’ External input devices, and switch to Enabled.

  • Select a device from those supported by OsmAnd by tapping the Type item in the list:
    Keyboard,Β  WunderLINQ,Β  Parrot (Android only), or create your own type (Android only).

  • There is a different defined action-key bundle assignment for each type of external input device. Tap the Key assignments to see a list of actions and keys. The table of keys is shown below.

  • You can read more about external input device actions on GitHub in the MapActivityKeyListener package.

KeyDeviceAction
CKeyboardMove - To My location
DKeyboardChange - Map orientation
NKeyboardShow / Hide - Navigation view
SKeyboardShow / Hide - Search view
PKeyboardChange - App profile to next
OKeyboardChange - App profile to previous
↑KeyboardMove - Map up
↓KeyboardMove - Map down
←KeyboardMove - Map to the left
β†’KeyboardMove - Map to the right
+ =KeyboardMap - Zoom in
βˆ’KeyboardMap - Zoom out
Press backKeyboardNavigate – Previous screen
↓WunderlinqMap - Zoom out
↑WunderlinqMap - Zoom in
ESCWunderlinqOpen WunderLINQ Datagrid
M
(legacy Android)
KeyboardShow / Hide - Side menu
Joystick press
(legacy Android)
KeyboardMove - To My location
Media button
(Android only)
KeyboardShow / Hide - AV notes
←
(Android only)
ParrotMap - Zoom out
β†’
(Android only)
ParrotMap - Zoom in

Custom Input Device Type​

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

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

External devices External devices

If you want to assign keys for an external input device (such as a keyboard, joystick, or controller), you need to create a device type: go to the External Input Device setting, select Type from the list, tap theΒ  "οΌ‹" Β  and enter a name. Each type has a menu with the following options: Rename, Duplicate, and Remove.

Add Action & Key Asssigments​

External devices External devices

After you have created a custom input type, you can assign the required actions to the keys. A wide range of action types from the Quick Action widget is available.

  • Select a device type, then tap the Key assignments item.
  • Tap the Add button (Β "οΌ‹"Β ) in the bottom right corner of the screen.
  • Select the required action then tap the Add key field and tap the button on your device to assign it to the action.
note
  • If the button you assign is already being used for another action, you will receive a notification with the option to reassign the button or cancel the assignment.
  • Later you can change actions and key assignments or add other ones for already created actions, just select an item in the Key assignments list.

Delete Key assignment​

External devices

You can delete multiple unnecessary actions using the Edit button (pencil-shaped) in the upper right corner of the screen at once:

  • Remove one action per action, with theΒ  "βˆ’" Β button in the item field.
  • Remove all key assignments for the selected type by tapping the button in the upper right corner of the screen next to the Edit name.

This article was last updated in September 2024