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 is "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 background layer. The default background is the standard "Mapnik" style map provided by openstreetmap.org, however you can change the configuration by using the layer control. The styling of the OSM data displayed on top of the background layer can be fully customized, but the standard "Color round nodes" or for "Pen round nodes" should work for most situations, the later has smaller "touch areas" mainly for working with a pen.

Note: the map images are cached on device and are only deleted if explicitly flushed. If you need to have background images available without network connectivity see custom imagery with MBtiles.

Nearby point-of-interest display

A nearby point-of-interest display can be shown by pulling the handle in the middle and top of the bottom menu bar up.

The view will include a filtered view of all "POI"s displayed on the current map view. If no explicit filter is set this is limited to objects that have a key with one of shop, amenity, leisure, tourism, craft, office or emergency. If an explicit filter is set, that is a tag filter or a preset filter, or a mode (Indoor and C-mode) is selected that sets a filter the display will display objects that are allowed by the filter. For example if Indoor mode is selected, the display will only show POIs on the currently selected level.

Tapping an entry in the display will center the map on the object and select it, tapping it a second time (just as on the map display) will start the property editor, in Tag only mode the property editor will start directly as expected. The POI entries are highlighted with the same validation indication as map icons, see validation styling.

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

Layer specific information

Highlighting of issues on the data layer

The included map styles highlight certain data issues, these are

The colours can be changed in the data style.

GeoJSON layer

Clicked GeoJSON objects will display a modal with its details. Further you can copy the attributes from the object to the clipboard and paste them as tags in to an OSM element, or you can directly create an OSM element from the object.

Note GeoJSON Polygon objects that consist of a single ring will be converted to a OSM closed way if the ring has less than 2000 vertices (the limit for an OSM way element), all other Polygons and Multipolygons will be converted to OSM multipolygon relations. Nodes in GeoJSON GeometryCollections will not be merged with the vertices of linear and area elements in OSM. You might want to do the later manually.

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, and add the resulting photograph to the photo layer if it is enabled. The photograph itself will be stored in the Vespucci/Pictures directory, however if this works depends on the specific camera app. Photographs may also be "shared" from other apps into Vespucci, these can be viewed, just as images taken via the camera button in Vespuccis image viewer.

Notes * Because of restrictions in recent versions of Android you will need to configure the target app in the preferences if you are not happy with the standard app on your device. See [16.1 release notes](16.1.0 Release notes.md). * OpenStreetMap currently does not provide an upload/storage facility for large numbers of images (you can store individual images of interest in the OSM wiki).

Location Location

The "on-map" GPS button duplicates the function of the "Follow location" 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. To reposition or remove the "on-map" GPS button use the "Follow position button layout" Preference.

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. Besides searching in the loaded data alternatively you can create a Overpass API query and use that to download data.

Overpass queries

The queries will be run against the Overpass server set in the "Advanced preferences". The standard behaviour is to replace the current data with the results of the query, if you have unsaved changes the query will not run except if you select the Merge result check box (this will merge the results of the query with the existing data). If Select result is checked, any results (with the exception of way nodes) will be selected and the app will zoom to the data.

Note: if you are generating the query from the JOSM query language you need to add an inview term otherwise the query will be executed for the whole world, if you are manually creating a query you should add ({{bbox}}) terms for the same reason.

Modes...

This menu allows mode selection as via the lock button and enabling/disabling of the simple mode.

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.

Debug

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