Advanced preferences

The Advanced preferences page is split in to seven topical sections that can be access by clicking on the main entries. Depending on the Android version running on your device some settings may be not available for technical reasons.

User Interface Settings

Show node icons

Show icons on nodes if they can be matched with a preset. Default: on.

Show POI icons on buildings

Show icons on buildings if the tags on the building can be matched with a preset. Default: on.

Display tag form

Enable the form based tag editor. Default: on.

Show camera action

Show a camera button on the main display (if a camera app is present). Default: on.

Camera app

Select the camera app to use. If your, installed, camera app is not listed, please report this and we will add it to the list. Unluckily google does not allow to automatically determine installed camera apps outside of pre-installed ones. Default: System default.

Use the MediaStore

Additionally use Androids MediaStore for accessing photos. This will add all photographs in JPEG format found via the MediaStore that contain coordinates in their EXIF data to the phto layer. Default: off.

Follow position button layout

Change the side of the display the "follow GPS" button is located on. Default: lefthand side.

Always dim non-downloaded areas

If on the non-downloaded areas will be dimmed when the screen is locked. Default: off.

Fullscreen mode

On devices without hardware buttons Vespucci can run in full screen mode, that means that "virtual" navigation buttons will be automatically hidden while the map is displayed, providing more space on the screen for the map. Depending on your device this may work well or not.

In Auto mode we try to determine automatically if using full screen mode is sensible or not, setting it to Force or Never skips the automatic check and full screen mode will always be used or always not be used respectively.

On devices running Android 11 or higher the Auto mode will never turn full screen mode on as Androids gesture navigation provides a viable alternative to it.

Default on Android 4.4 and later: Auto, 4.0 - 4.3: Never.

You need to restart the app for changes to this setting to take effect.

Map screen orientation

If set to any other value than Auto Vespucci will try to override your device settings for screen rotation.

Show tolerance

Show halos indicating the size of the "touch areas" around elements. Default: on.

Use back key for Undo

Use the back key for undo. Default: off.

Light theme

Use a theme with a light background. Default: on. You need to restart the app for changes to this setting to take effect.

Enable split action bar

Show the menu buttons at the bottom of the screen. Default: on. You need to restart the app for changes to this setting to take effect.

Disable translations

Use English for the user interface. Google does not provide a supported way to switch languages for individual apps, as a result this setting relies on multiple workarounds that may, or may not, work on your device. Preset translations can be disabled in the preset configurations.

Max. number of inline values

Maximum number of values that will directly be displayed in the form based editor for Tags with pre-determined values. Default: 4.

Time to wait before auto-locking

How long to wait before auto-locking the map display, setting the value to 0 disables the auto-locking. Default 60 seconds.

Enable Anti-Aliasing

Use anto-aliasing when rendering OSM data. Default: on.

Max line width

Maximum width lines will increase to when zooming in. Default: 16 pixels.

Pending upload OK

Limit below which pending object uploads will be considered OK. Default: 50 objects.

Pending upload warning

Limit below which pending object uploads will have warning status. Default: 200 objects.

Disable feedback activity

Disable the feedback activity and use an URL instead. Default: false.

Upload reminder interval

Interval for reminders if you have unpublished changes. Default: 6 hours.

Too much data warning

Limit (in number of Nodes) at which we start warning about too much data being loaded. Default: 50'000 objects.

Beep volume

Set how load the beep is Vespucci uses when you are pressing unsupported short cut keys on a connected real keyboard. Default: 50.

Minimum zoom for Mapillary

Set the minimum zoom level for Mapillary data to be displayed. If set too low the application might crash in areas with very high density Mapillary data. Consider increasing the number if your display if very large or very high resolution. Default: 16

Name capitalization

Set the capitalization mode for keyboard input for name-like tag. One of No capitalization, Word capitalization and Sentence capitalization. Default: Word capitalization.

Note: this setting is only applicable when the current locale uses latin script.

Data and Editing Settings

Settings related to editing.

Always use contextual menu

Always show the element selection context menu if the selection is ambiguous. If turned off the nearest element will be selected. Default: off.

Override address tag default

Use our address tag configuration over any region specific values that we may have found. Default: off.

Address tags

When using address prediction only add the tags configured here.

Enable auto-apply of preset

Automatically apply the best matching preset when the property editor is invoked. This will add keys for all non-optional tags. Default: on.

Enable name suggestions

Support special handling of name tags with canonical name suggestions. Default: on.

Enable name suggestion presets

When using name suggestions, automatically apply the best preset. Default: on.

Generate notifications

Generate notifications for validator detected issues. Default: on.

Group alerts only

Generate notifications (audio) only once per notification group. Default: off.

Max. number of displayed notifications

Maximum number of notifications retained in the status bar: 5 (per type).

Max distances for notifications

Maximum distance a validation issue or note/bug can be from the current positions to trigger a notification. Default: 100 meters.

Close changesets

Close the current open changeset after uploading edits. Default: on.

Squaring threshold

The threshold in ° over which angles are ignored for squaring and straightening. Default: 15°.

Auto-format phone numbers

This allows to control if phone numbers should be auto-formatted. Default: on.

Max distance for stored imagery offsets

The farthest distance a locally stored layer offset will be automatically be applied. Default: 100 meters.

Auto-download Settings

Download radius

When auto-downloading, the radius of the area that is attempted to download around the current position. In pan and zoom auto-download mode, this is the minimum download size. Default: 50 meters.

Maximum auto-download speed

Maximum speed up to which auto-download is attempted. Default: 10 km/h.

Auto-prune limit

Limit at, when reached, an automatic prune of the data in memory is attempted. Default: 5000 Nodes.

Zoom limit

Minimum zoom for pan and zoom auto-download to work. In high data density areas this should be set to higher values to avoid loading very large amounts of data when zooming out. This is used both for data and tasks. Default: 17.

Task download radius

When auto-downloading notes and bugs, the radius of the area that is attempted to download around the current position. Default: 200 meters.

Maximum task auto-download speed

Maximum speed up to which auto-download of notes and bugs is attempted. Default: 30 km/h.

Task auto-prune limit

Limit at, when reached, an automatic prune of the tasks in memory is attempted. Default: 10000 Tasks.

Location Settings

GPS and Network location settings.

GPS/GNSS source

Source of GPS/GNSS location updates.

Possible values:

Internal use the internal GNSS location provider.

Internal NMEA use the internal GNSS location provider with NMEA output, this is only useful for testing.

NMEA from TCP client connect to a source of NMEA sentences over TCP, if the source is gpsd, the client will attempt to switch it to NMEA output (from 14.0.11 on).

NMEA from TCP server this will start a server on a specified port and listen for a client providing NMEA sentences, this is mainly useful with rtklib.

Default: internal.

NMEA network source

If GPS source is set to one of the NMEA TCP options, configure on which IP address and port the client or server is. In NMEA from TCP server mode the host part is currently ignored.

Minimum GPS/GNSS interval

Minimum interval between updates for the internal GPS/GNSS source. Default: 1000 ms.

Minimum GPS/GNSS-distance

Minimum distance between updates for the internal GPS/GNSS source. Default: 5 meters.

Leave GPS/GNSS turned off

If GPS has been disabled by the user, don't ask to turn it on. Default: off.

Fallback to network location

If the device is providing "Network" location data use it as a fallback if we haven't received a GPS location for a longer time. Default: on.

Stale location after

Time, in seconds, after which a location will be considered stale. Default: 60 s

Server Settings

OpenStreetMap API and other servers configuration.


Select and add custom OpenStreetMap API servers.

User account

Set a user and password for API authentication. This is only needed if the target API server does not support OAuth authentication, and in general should be avoided as unsafe.

Offset server

API server for imagery offsets.

OSMOSE server

OSMOSE QA API server configuration.

Configure geocoders

Geocoding service providers. Currently Photon and Nominatim servers are supported.

Taginfo server

Configure the taginfo server used for the "online" preset search/construction.

Layer download and storage

Download and storage configuration for the tiled imagery layers.

Max. number of download threads

Maximum number of simultaneous download threads. Default: 4.

Tile cache size

Total on device size for caching imagery tiles. Default: 100MB.

Prefer removable storage

Prefer removable storage for storing tiles. Requires restart of app to take effect, you will need to manually remove the existing tile cache if you change this. Default: true.

Mapillary cache size

Total on device size for caching Mapillary images. Default: 100MB.


Report app crashes

Submit ACRA crash dumps to the Vespucci developers. You will still be asked on a per event basis if you want to submit a specific crash dump, if you set this to off the functionalitiy is completely disabled. Default: on.

Show stats

Show some uninteresting stats on screen. Debugging use only. Default: off.


Enable JS Console

Turn on the JavaScript console. Default: off.

Enable voice commands

Enable voice command support: Default: off.

Enable hardware acceleration

Do not use, may cause hangs of the app and other problems.