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 is present). Default: on.

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

Configure the behaviour on devices with "soft" buttons. Default on Android 4.4 and later: automatic, 4.0 - 4.3: off, earlier versions: not available. 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.

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.

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

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

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