Profiles (Settings)

Each profile is available for full customization. In fact, each profile can become a separate application for the needs of the user.

In this article

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

Make a contribution

To start setting up an application profile:

Android: Menu → Configure profile (Browse map or any other profile)

Profiles Settings Android

iOS: Menu → Settings → App profiles

Profiles Settings iOS

Profile configuration

This section contains all the settings related to the appearance, navigation settings, map rendering, configure menu, and screen of a profile.

All settings affect the selected application profile only.

Profiles Settings Android

Profiles Settings iOS

General settings

This section of settings contains settings of the cursor on the map and map view, settings of units & formats of map and profile data, settings of external input devices, and other sensors.

Android: Menu → Configure profile (Browse map or any other profile) → General settings

iOS: Menu → Settings → App profiles → General settings

Appearance

In this section of the General settings menu, you can set parameters for the cursor on the map and map view for the chosen profile.

Profiles General Settings Appearance Android

  • App theme - sets a day or night theme for the application. This setting doesn't change "Map mode" parameter.
  • Map orientation - allows to set orientation the map view.
  • Display position always in center - allows to use center or bottom screen position for the cursor ("My location"). 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.
  • Screen orientation - sets the screen position for the OsmAnd application: Portrait, Landscape, Screen orientation.
  • Screen control - opens the screen control menu, where you can select parameters for your device screen during navigation for keeping device battery consumption.

Profiles General Settings Apperance iOS

  • Map orientation - allows to set orientation the map view.
  • 2.5D view - enables/disables 2.5D view of the map view. Use "Gesture" or "My Location button" for 3D view
  • Display position always in center - allows to use center or bottom screen position for the cursor ("My location"). 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.

Units & formats

In this section you can set parameters of units & formats for chosen application profile.

Profiles General Settings Units & formats Android

ParameterFormatNote
Driving regionAutomaticAccording to the device location
Europe, Asia, Latin America, and similarRight-hand traffic, Kilometers/meters
United StatesRight-hand traffic, Miles/feet
CanadaRight-hand traffic, Kilometers/meters
UK, India, and similarLeft-hand traffic, Miles/feet
JapanLeft-hand traffic, Kilometers/meters
AustraliaLeft-hand traffic, Kilometers/meters
Units of lengthKilometers/meters1 km / 1000 m
Miles/feet0.62 ml / 3281 f
Miles/meters0.62 ml / 1000 m
Miles/yards0.62 ml / 1094 ya
Nautical miles0.54 nml
Coordinate formatDD°MM.MMMM′Example: 50.12333° 19.93233° (Lat Long)
DD°MM.MMM′Example: 50°7.393′ 19°55.941′ (Lat Long)
DD°MM′SS″Example: 50°7′23.6″ 19°55′56.4″ (Lat Long) 23°27′30″
UTM Standard34N 5552876 423678 (Zone Northing Easting) . OsmAnd uses the UTM Standard, which is similar but not identical to the UTM NATO format.
MGRSExample: 34U DA 23678 52873 . OsmAnd uses MGRS, which is similar to the UTM NATO format.
Open Location CodeExample: 9F2X4WFJ+7W (Open Location Code represents area 9m x 14m)
Coordinate formatDegrees 180°All angular values have readings from 0° to 180° and from 0° to -180°.
Degrees 360°All angular values have readings from 0° to 360°.
MilliradiansAll angular values have milliradian value.
Unit of speedKilometers per hour90 km/h
Miles per hour55.92 mph
Meters per second30 m/s
Minutes per mile1.073 min/m
Minutes per kilometer0.667 min/km
Nautical miles per hour (knots)48.59 kn

Profiles General Settings Units & formats iOS

ParameterFormatNote
Driving regionAutomaticAccording to the device location
Europe, Asia, Latin America & similarRight-hand driving, Kilometers/meters
United StatesRight-hand driving, Miles/feet
CanadaRight-hand driving, Kilometers/meters
UK, India & similarLeft-hand driving, Miles/feet
JapanLeft-hand driving, Kilometers/meters
AustraliaLeft-hand driving, Kilometers/meters
Units of lengthKilometers/meters1 km / 1000 m
Miles/feet0.62 ml / 3281 f
Miles/meters0.62 ml / 1000 m
Miles/yards0.62 ml / 1094 ya
Nautical miles0.54 nml
Coordinates formatDDD.DDExample: 50.12333° 19.93233° (Lat Long)
DDD MM.MMExample: 50°7.393′ 19°55.941′ (Lat Long)
DDD MM SS.SSExample: 50°7′23.6″ 19°55′56.4″ (Lat Long) 23°27′30″
UTM34N 5552876 423678 (Zone Northing Easting) .
Open Location Code (OLC)Example: 9F2X4WFJ+7W (Open Location Code represents area 9m x 14m)
Angular measurement unitsDegrees 180°All angular values have readings from 0° to 180° and from 0° to -180°.
Degrees 360°All angular values have readings from 0° to 360°.
MilliradiansAll angular values have milliradian value.
Unit of speedKilometers per hour90 km/h
Miles per hour55.92 mph
Meters per second30 m/s
Minutes per mile1.073 min/m
Minutes per kilometer0.667 min/km
Nautical miles per hour (knot)48.59 kn

Other

Additional settings for profile (like external devices and etc.)

You can enable/disable buttons and input devices for OsmAnd, on or off animations for navigation mode, use or not fullscreen mode, magnetic sensor, Kalman filter.

Profiles General Settings Other Android

  • Volume buttons as zoom - allows to use or not volume buttons of a device as zoom.
  • Use Kalman filter - allows to use or not Kalman filter for smoothen rotation of the map with a slower rotation animation though it introduces a small delay (< 1 second) till.
  • Use magnetic sensor - allows to use or not Magnetic sensor for smoothen rotation of the map with a slower rotation animation though it introduces a small delay (< 1 second) till.
  • Fullscreen mode - use or not fullscreen mode of OsmAnd app on the device.
  • No animations - allows to switch on/off animation for navigation mode.
  • External input devices - allows adding external input devices for control OsmAnd app by buttons of these devices. External input devices: WunderLINQ, Keyboard, Parrot.

You can enable/disable buttons and input devices for OsmAnd.

  • External input devices - allows adding external input devices for control OsmAnd app by buttons of these devices. External input devices: WunderLINQ, Generic Keyboard.

In this part, there are all settings for navigation mode of a profile.

This part of settings doesn't exist for "Browse map" profile.

Android: Menu → Configure profile → Navigation settings

Profiles Navigation Settings Android

iOS: Menu → Settings → App profiles → Navigation settings

Profiles Navigation Settings iOS

In this section you can set routing and navigation parameters of your profile, map during navigation and vehicle parameters.

Navigation type - governs how routes are calculated. These are rules for routing your profile. It means that your bicycle profile has Cycling navigation type for example. You can import the routing file from any cloud storage app by opening it in OsmAnd. More about Routing.xml on our Github page.

Route parameters - controls which parameters will be used during routing and which parameters will be showed on the device screen. During navigation you can change some of these parameters in "Navigation Options". Below list of parameters:

ParameterDescriptionNote
Navigation type:'Navigation type' selects how routes are calculated, with available offline and online routing engines.
OfflineOffline routing uses sources of the device and calculation the route by using data of OsmAnd offline maps.Navigation types (OsmAnd routing) by default: Boat, Bicycle, Direct-to-point, Car, , Public transport, Ski, Straight line, Horseback riding.
OnlineOnline routing builds the route servers' resources online by the Internet connection.List of online routing providers. Here you can add an online routing engine: (Graphhopper, OSRM, Openrouteservice, GPX.
Route parameters:allows setting routing for any cases and showing additional info about roads.
"Fastest route"Enable to calculate fastest route or disable for fuel-saving route.
"Driving style"select driving puprose to get shorter, faster, safer or unpaved route."Prefer unpaved roads": prefer unpaved over paved roads for routing.
"Prefer byways": prefer safer roads for routing.
"Balanced": prefer faster way for routing.
"Shorter routes": prefer shorter way for routing.
"Avoid roads…"avoid certain routes and road types for routing:Each navigation type has its own set of avoiding.
"No unpaved roads"
"No stairs"
"No border crossings"
"Avoid footways"
"Avoid tunnels"
"No cobblestone or sett"
"No toll roads"
"Avoid low emission zones"
"No shuttle train"
"No motorways"
"No ice roads or fords"
"No trains"
"No subways"
"No ferries"
"No trams"
"No buses"
"No share taxi"
"Prefer…"Prefer unpaved over paved roads for routing.
"Fuel-efficient way"Optimized shorter route (energy saving)
"Allow streams and drains"allows streams and drains for boat navigation type.Boat navigation type
"Allow intermittent water ways"allows intermittent water ways for boat navigation type.Boat navigation type
"Number of changes"specify upper limit of changes of for public transport.Public transport navigation type
"Use motorways"Allows motorways.Cycling
"Allow private access"Allow access to private areas.
"Use elevation data"allows choosing relief parameters for the routing. The routing could avoid strong uphills:Cycling routing
"Flat"Routing could avoid strong uphills.
"Less hilly"Routing could avoid strong uphills.
"Hilly"Routing could avoid strong uphills.
"Consider temporary limitations"Use road restrictions that are active now on the map. Data from OpenStreetMap.
"Recalculate route"allows to recalculate the route by the next cases:
"Minimal distance to recalculate route"Recalculate route in case of deviation. Select the distance after which the route will be recalculated.
"In case of reverse direction"The route will be recalculated if the direction is changed to reverse.
"Development"using live updates and the initial part for calculation the route
"OsmAnd Live data"Enable navigation for OsmAnd Live changes.
"Smart route recalculation"Recalculates only the initial part of the route, useful for long trips.
"Use 2-phase A* routing algorithm"Two-phase routing for car navigation.
Screen alertsshowing or not alerts on the screen like a widget. Alerts shown bottom left during navigation.Types of alert widgets
Voice promptson/off and settings of voice guidance during navigation.Configure to announce street names, traffic warnings (forced stops, speed bumps), speed camera warnings, speed limits.
Vehicle parametersspecified vehicle parameters may affect routing:
Default speedChange default speed settings.
Weight limitProvide your vehicle weight, some route restrictions may apply for heavy vehicles.
Height limitProvide your vehicle height, some route restrictions may apply for high vehicles.
Length limitProvide your vehicle length, some routes restrictions may be applied for long vehicles.
Width limitProvide your vehicle width some route restrictions may apply for wide vehicles.
Customize route lineChange color and width for the route line during navigation.Pro feature
ColorUsing color by: Map style, Custom, Altitude, Slope, Road type, Surface, Smoothness, Winter and ice roads,Surface firmness.
WidthUsing width by: Map style, Thin, Medium, Bold, Custom.

Navigation type - governs how routes are calculated. These are rules for routing your profile. It means that your bicycle profile has Cycling navigation type for example. You can import the routing file from any cloud storage app by opening it in OsmAnd. More about Routing.xml on our Github page.

Route parameters - controls which parameters will be used during routing and which parameters will be showed on the device screen. During navigation you can change some of these parameters in "Navigation Options". Below list of parameters:

ParameterDescriptionNote
Navigation typechoose your Navigation type which controls how routes are calcualted.Navigation types (OsmAnd routing) by default: Boat, Cycling, Direct-to-point, Driving, On foot, Public transport, Ski, Straight line.
Route parameters:allows setting routing for any cases and showing additional info about roads.
"Recalculate route in case of deviation"The route will be recalculated if the distance from the route to the current location is more than selected value.
"Recalculate route in case of reverse direction"the route will be recalculated if you are moving to the start point.
"Driving style"select driving puprose to get shorter, faster, safer or unpaved route."Prefer unpaved roads": prefer unpaved over paved roads for routing.
"Prefer byways": prefer safer roads for routing.
"Balanced": prefer faster way for routing.
"Shorter routes": prefer shorter way for routing.
"Avoid roads"avoid certain routes and road types for routing:Navigation types and notes
"No unpaved roads"
"No stairs"
"No border crossings"
"Avoid footways"
"Avoid tunnels"
"No cobblestone or sett"
"No toll roads"
"Avoid low emissions zones"
"No shuttle train"
"No motorways"
"No ice roads or fords"
"No trains"
"No subways"
"No ferries"
"No trams"
"No buses"
"No share taxi"
"Select elevation fluctuation"allows choosing relief parameters for the routing. The routing could avoid strong uphills:Cycling routing
"Flat"Routing could avoid strong uphills.
"Less hilly"Routing could avoid strong uphills.
"Hilly"Routing could avoid strong uphills.
"Use elevation data"Using elevation fluctuation for routing.
"Use motorways"using Motorways for routingCycling routing
"Allow private access"ignore the Private Access restriction for routing
"Consider temporary limitations"using temporaty limitations for routing from OpenStreetMap data
"Road speeds"setting the minimum and the maximum travel speed for all roads in the route.
Voice promptson/off and settings of voice guidance during navigation.Configure to announce street names, traffic warnings (forced stops, speed bumps), speed camera warnings, speed limits
Screen alertsshowing or not alerts on the screen like a widget.Types of alert widgets
Vehicle parametersspecified vehicle parameters may affect routing:
Default speedEstimates arrival time for unknown road types, and limits speed for all roads (may affect routing)
Weight limitProvide your vehicle weight, some route restrictions may apply for heavy vehicles.
Height limitProvide your vehicle height, some route restrictions may apply for high vehicles.
Length limitProvide your vehicle length, some route restrictions may be applied for long vehicles.
Width limitProvide your vehicle width some route restrictions may apply for wide vehicles.

Other

Parameters for "Map during navigation" and others:

ParameterDescriptionNote
Map during navigation:Change map behavior during navigation.
"Auto-center map view"Time until the map view synchronizes with the current position..Value: Never, 5 sec, 10 sec, 15 sec, 20 sec, 25 sec, 30 sec, 45 sec, 60 sec, 50 sec.
"Auto zoom map"Zoom level according to your speed (while map is synchronized with current position)..Value: No auto zoom, To long-range, To mid-range, To close-up.
"Map orientation threshold"Select speed of switching orientation from 'Movement direction' to 'Compass direction' below..Value: 0 km/h, 5 km/h, 7 km/h, 10 km/h, 15 km/h, 20 km/h.
"Snap to road"Current position icon will snap to the current navigation route.
Animate own positionTurn on animated map panning of 'My position' during navigation.
ParameterDescriptionNote
Map during navigation:Change map behavior during navigation.
"Auto-center map view"Time until map view synchronizes with current position after moving.Value: Never, 5 sec, 10 sec, 15 sec, 20 sec, 25 sec, 30 sec, 45 sec, 60 sec, 50 sec.
"Auto zoom map"Auto zoom map according to your speed (while map is synchronized with current position).Value: No auto zoom, To long-range, To mid-range, To close-up.
"Map orientation threshold"Select below which speed the map orientation switches from 'To direction of movement' to 'To compass'.Value: 0 km/h, 5 km/h, 7 km/h, 10 km/h, 15 km/h, 20 km/h.
"Snap to road"Snap position to roads during navigation.

Configure map

Here you can set parameters for Configure map of chosen profile

Configure map menu is a central place where you could configure map display for your profile needs, i.e. highlight Favorite points, Navigation markers or special Points of Interests on the map; display specific routes or 3rd party GPX files; overlay the map with relief information, satellite imagery or any other available raster map; display public transport information and change the map style.

Android: Menu → Configure profile → Configure map

Set parameters for Configure map menu for chosen profile.

Profiles Configure map Settings Android

iOS: Menu → Settings → App profiles → Configure map

Set parameters for Configure map menu for chosen profile.

Profiles Configure map Settings iOS

Configure screen

Here you can set parameters for Configure screen of chosen profile.

Configure screen is a menu that allows to configure what widgets will be displayed over the map. It allows you to enable and configure Quick action, Informational & Navigational widgets and other elements.

Android: Menu → Configure profile → Configure screen

Set parameters for Configure screen menu for chosen profile.

Profiles Configure screen Settings Android

iOS: Menu → Settings → App profiles → Configure screen

Set parameters for Configure screen menu for chosen profile.

Profiles Configure screen Settings iOS

Profile appearance

You can choose the color of the profile elements, its icon and name, also assign icons on the map for movement and without.

Android: Menu → Configure profile → Profile appearance

ParameterDescriptionNote
"Profile name"entering a profile name
"Profile appearance"changing color and label for chosen profile:
"Select color"choosing color for a profile icon and menu
"Select icon"choosing label for a profile icon
Profile Appearance Android
"Appearance on the map"changing position icons:
"Position icon at rest"choosing label for a profile icon without moving
Profile Appearance at rest Android
"Position icon while moving"choosing label for a profile icon while moving
Profile Appearance on the map Android

iOS: Menu → Settings → App profiles → Profile appearance

ParameterDescriptionNote
"Name"entering a profile name
"Appearance"changing color and label for chosen profile:
"Select color"choosing color for a profile icon and menu
"Select icon"choosing label for a profile icon
Profile Appearance iOS
"Appearance on the map"changing position icons:
"Position icon at rest"choosing label for a profile icon without moving
"Position icon while moving"choosing label for a profile icon while moving
Profile Appearance on the map iOS

UI Customization

Customize the quantity of items in "Drawer", "Configure map" and "Context menu actions".

Turn off unused [plugins](/osmand/plugins) for hide all their controls.

Android: Menu → Configure profile → UI Customization

Under each menu there is the info about items quantity / active items.

Profile UI Customization Android

Drawer

In this part of the menu you reorder or hide items from the Drawer.

ActionsNote
"Minus"These items are hidden from the menu, but the represented options or plugins will continue to work.
"Moving"These items are moved to other positions in the menu.
Profile Drawer Android
"Reset"These items are reset from the "Hidden" part of the menu to the visible.
Profile Reset Android
"Reset to default"resetting the "Drawer" menu to default.
"Copy from another profile"coping the "Drawer" menu from another profile.
Profile Copy Android

Configure map

In this part of the menu you reorder or hide items from the Configure map menu.

ActionsNote
"Minus"These items are hidden from the menu, but the represented options or plugins will continue to work.
"Moving"These items are moved to other positions in the menu.
Profile Configure map menu Android
"Reset"These items are reset from the "Hidden" part of the menu to the visible.
Profile Configure map menu Reset Android
"Reset to default"resetting the "Configure map" menu to default.
"Copy from another profile"coping the "Configure map" menu from another profile.
Profile Configure map menu Copy Android

Context menu actions

In this part of the menu you reorder or hide items from the Context menu actions menu.

ActionsNote
"Minus"These items are hidden from the menu, but the represented options or plugins will continue to work.
"Moving"These items are moved to other positions in the menu.
Profile Configure map menu Android
"Reset"These items are reset from the "Hidden" part of the menu to the visible.
Profile Configure map menu Reset Android
"Reset to default"resetting the "Context menu actions" menu to default.
"Copy from another profile"coping the "Context menu actions" menu from another profile.
Profile Configure map menu Copy Android

Plugin settings

Plugins are a collection of settings that can be enabled with one click. Plugins also unlock additional functions of the application, they can be either paid or free. Some plugins have their own settings. Among other things, you can enable or disable plugins for each profile separately.

Plugins must be enabled in [the Plugin list](/osmand/plugins) for activating it in the setting list for the profile.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings

Profile Settings Plugins Android

iOS: Menu → Settings → App profiles → Plugins

Profile Settings Plugins iOS

Trip recording

This menu opens the trip recording settings for the selected profile. Where you can choose any parameters for recording your trip.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → Trip recording

iOS: Menu → Settings → App profiles → Plugins → Track recording

Audio / Video notes

This menu opens audio-video plugin settings for the selected profile. Where you can choose any parameters for your needed.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → Audio/video notes

Not exist for iOS version.

OpenStreetMap editing

This menu opens the OpenStreetMap editing plugin settings for the selected profile. Where you can input your data for starting OSM edit.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → OpenStreetMap editing

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings →

OpenPlaceReviews

This menu opens the OpenPlaceReviews plugin settings for the selected profile. Where you can input your data for starting added reviews of any places.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → OpenPlaceReviews

Not exist for iOS version.

Accesibility

This menu opens Accessibility plugin settings for the selected profile. Where you can choose any parameters for your needed.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → Accessibility

Not exist for iOS version.

OsmAnd development

This menu opens Development plugin settings for the selected profile. Settings for development and debugging features, like navigation simulation, rendering performance, or voice prompting. Intended for developers, not needed for normal app use.

Android: Menu → Configure profile (Browse map or any other profile) → Plugin settings → Development

Not exist for iOS version.

Actions

Actions with chosen profile: export, copy from another profile, reset to default, delete profile:

Profiles Actions Settings Android

  • Export profile
  • Copy from another profile
  • Reset to default
  • Delete profile

Profiles Actions Settings iOS

  • Export profile
  • Copy from another profile
  • Reset to default
  • Delete profile

Did this doc help you?

Privacy policy

Help us make these docs great!

All OsmAnd docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.