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.

Display labels from presets

Display labels from presets in the tag form 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 location button layout

Change the side of the display the "Follow location" button is positioned on or remove it completely. 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. No statusbar will additionally try to remove Androids status bar besides forcing full screen mode.

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 - 10:0: Auto, 4.0 - 4.3 and 11.0 and later: 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.

Theme

Select the theme to use. Follow system will follow the setting in the system preferences as far as possible, Light and Dark will fix the setting on the respective theme. Follow system is only available on Android 10 and later. Default: Follow system. 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.

App language

Select a language for the user interface that is different from the device default, setting the value to Device language will revert to using your preference for the whole device. On devices running Android 13 and later the app language can be changed in the system settings too. 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.

Long string limit

Limit from which, instead of an inline text field, a modal will be displayed will be used for text editing in the form based editor. The modal will be displayed if either the existing text is longer than the limit, or if the preset text field length attribute is longer than the limit. Default: 255.

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

If the number of pending object uploads is below this limit the situation is considered unproblematic. Default: 50 objects.

Pending upload warning limit

If the number of pending object uploads is below this limit it will have warning status. A pending upload count above this will have danger 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.

Use volume keys for zooming

Allow the use of the volume keys for zooming in and out. Default: false.

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.

Distance between neighbour addresses

The distance in meters up to which two addresses are considered to be potential neighbours, this is useful for fine tuning how the increment used for predicting addresses is calculated. Default: 50 meters.

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.

Use imperial units for measuring

Use imperial units when measuring in countries that customarily use them. Default: off.

Minimum number of nodes in circle

The target minimum number of nodes that should be aimed for in a circle. Default: 6.

Maximum circle segment length

Maximum distance between two circle nodes. Default: 2m.

Minimum circle segment length

Minimum distance between two circle nodes. Default: 0.5m.

Maximum distance to move tagged node

Maximum distance to move a tagged node when replacing way geometry. DEfault: 1.0m.

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

Enable/disable automatically pruning in memory data and tasks. Default: on.

Auto-prune limit

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

Auto-prune Bounding Boxes limit

Number of Bounding Boxes in memory that when reached will trigger a prune. Requires Auto prune to be on. Default: 100 Bounding boxes.

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. Requires Auto prune to be on. 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: off.

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.

OSM API URL

This lists all the configured OSM API instances, allows adding further ones and editing the configuration of existing entries. The default configuration contains an entry for the regular openstreetmap.org API and the sandbox API for development and experimentation.

Select Edit from the overflow menu to configure the URLs including read-only sources and authentication method for a specific entry. Basic Authentication, OAuth 1.0a and OAuth 2 are supported, however the API instance on openstreetmap.org only supports OAuth 2 since June 2024.

For API instances that support uploading compressed bodies in POST requests, Support compressed uploads can be set. By default this is only enabled for the openstreetmap.org API instance.

These preferences can also be accessed by selecting Configure for the OpenStreetMap Data layer in the layers modal.

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.

Overpass server

Configure the overpass API server used online object search.

OpenAerialMap server

Configure the OpenAerialMap server used for providing additional imagery for backgrounds.

Panoramax URL

The base URL for a Panoramax instance without the appended "/api".

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.

Auto-save configuration

Settings for the automatic saving of edits.

Save state

Save the complete state including unchanged data and undo information. This is used to restore the app to its previous state and is the same information saved as when the app is paused or stopped. The saved state is stored in an app private location and is not accessible by the end user. Default: enabled.

Save changes

Save changes as OSC file. This saves the current changes as a .osc file in the "Autosave" directory in the public Vespucci directory. Default: enabled.

Minimum interval

The minimum interval in minutes between saves. Default: 5 minutes.

Minimum number of changes

Minimum number of changes required for a save to occur. Default: 1.

Maximum number of OSC files to retain

The maximum number of OSC files the app will retain, when this limit is reached the oldest files will be deleted. Default: 5.

Minimum GPX saving interval

Minimum interval in minutes between saves of GPX recordings. Default: 5 minutes.

Miscellaneous

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 functionality is completely disabled. Default: on.

Enable hardware acceleration

On Android 10 and later.

Turn on use of hardware rendering on Android 10 and later. Default: on

Show stats

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

Experimental

Enable JS Console

Turn on the JavaScript console. Default: off.

Enable voice commands

Enable voice command support: Default: off.

Enable split window property editor

Enable displaying the property editor in a separate window if available. Default: off

Use "new task" mode for property editor

Set FLAG_ACTIVITY_NEW_TASK when starting the property editor, this may improve the behaviour of certain launchers when resuming the app. Default: off