Main Vespucci Screen

The main Vespucci map screen is your normal starting point for interacting with the application. It can be in two modes

Locked locked

In this mode modifying the OpenStreetMap data is disabled, you can however use all the menus and other functions, for example down- or up-load data. The main reason to use this mode is to pan and zoom in high density areas, or to avoid accidental changes when pocketing your device.

Tapping the lock icon will toggle the lock.

Unlocked unlocked

In this mode you can add and change the geometry and tags of OpenStreetMap data. You will still need to zoom until editing is enabled.

If a small "T" is displayed on the lock icon you are in "Tag editing only" mode and will not be able to change geometries, a small "I" indicates indoor mapping mode. A long press on the icon will display a menu allowing you to switch between editing modes, for mode switching purposes it dosen't matter if the display in "locked" or "unlocked".

All the mode options are

The lock icon will always be located in the upper left corner of your devices screen. The placement of the following controls will depend on the size, orientation and age of your device, and may be in the top or bottom bar, or in a menu.

Map and Data display

Once you have downloaded some OSM data you will see it displayed over a configurable background layer. The default background is the standard "Mapnik" style map provided by, however you can choose a different background or none from the Preferences. The style of the OSM data displayed on top of the background layer can be fully customized, however the standard "Color round nodes" or for "Pen round nodes" should work for most situations, the latter has smaller "touch areas" mainly for working with a pen. Depending on the device it may however work better for you than the default.

Note: the map tiles are cached on device and only deleted if explicitly flushed. In principle you can pre-download the tiles for the area you want to work on and so spare yourself the need to access them online while outside.

Layer control

Vespucci currently supports multiple tiled background imagery layers, multiple tiled overlay layers (both raster and Mapbox vector tiles), a grid/scale layer, a task layer, a photo layer, multiple GeoJSON layers, multiple GPX/GPS layers and, naturally, an OSM data layer. Tapping the layer control (upper right corner) will display the layer dialog).

The layer dialog supports the following actions on the layer entries:

Custom tile layers, including on device MBTile containers can be added in the preferences or as decribed above..

Highlighting of data issues

With the standard map style certain data issues will be highlighted in magenta, these are

Indoor mode

In indoor mode the displayed level can be changed with the up/down buttons, tapping the level display button will show suitable objects that doesn’t have a level tag, tapping again will revert to the level selector.

Elements that are not on the current level are drawn in a light grey, this works best on an uncluttered background map, for example the Thunderforest Landscape map. Newly created elements will automatically have the current level assigned in the property editor.

Available Actions

Undo Undo

Tapping the icon once will undo the last operation. A long press will display a list of the operations since the last save, if you have undone anything a corresponding "redo" checkpoint will be displayed. Some operations consist of multiple simpler actions that will be listed as individual items.

Camera Camera

Start a camera app, add the resulting photograph to the photo layer is enabled. The photograph itself should be stored in the Vespucci/Pictures directory, however this depends on the specific camera app.


The "on-map" GPS button duplicates the function of the "Follow GPS position" menu entry. When this is activated the GPS arrow will be displayed as an outline. Note that the Show location function will enable location updates from the system, just as the recording and similar options.

Transfer Transfer

Select either the transfer icon Transfer or the "Transfer" menu item. This will display seven or eight options:

Preferences Preferences

Show the user preference screens. The settings are split into two sets: the first screen contains the more commonly used preferences, the "Advanced preferences" contains the less used ones.

Tools Tools

Find Find

Search for a location and pan to it with the OpenStreetMap Nominatim or Photon service (requires network connectivity)

Search for objects

Search for OSM objects in the loaded data using JOSMs search/filter expressions. See JOSM filter documentation for more information.

Tag-Filter (checkbox)

Enable the tag based filter, the filter can be configured by tapping the filter button on the map display.

Preset-Filter (checkbox)

Enable the preset based filter, the filter can be configured by tapping the filter button on the map display.

Share position

Share the current position (center of the displayed map) with other apps on the device.

Help Help

Start the on device help browser.

Authors and licenses

Some information on the licence of Vespucci itself, specific components and a list of all known contributors to the app.


Internal information on the app and a button to force submission of a crash dump.