Before we start: most screens have links in the menu to the on-device help system giving you direct access to information relevant for the current context, you can easily navigate back to this text too. If you have a larger device, for example a tablet, you can open the help system in a separate split window. All the help texts and more (FAQs, tutorials) can be found on the Vespucci documentation site too. You can further start the help viewer directly on devices that support short cuts with a long press on the app icon and selecting "Help"

Введение в Vespucci#

Vespucci is a full featured OpenStreetMap editor that supports most operations that desktop editors provide. It has been tested successfully on Google's Android 2.3 to 14.0 (versions prior to 4.1 are no longer supported) and various AOSP based variants. A word of caution: while mobile device capabilities have caught up with their desktop rivals, particularly older devices have very limited memory available and tend to be rather slow. You should take this in to account when using Vespucci and keep, for example, the areas you are editing to a reasonable size.

Редактирование в Vespucci#

В зависимости от размера экрана и возраста вашего устройства редактировать можно при помощи значков на верхней панели, выпадающего меню справа на этой панели, при помощи нижней панели (если есть) или посредством кнопки меню.

Загрузка OSM-данных#

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

Upload data to OSM server... - review and upload changes to OpenStreetMap (requires authentication) (requires network connectivity)
Review changes... - review current changes
Download current view - download the area visible on the screen and merge it with existing data (requires network connectivity or offline data source)
Clear and download current view - clear any data in memory, including pending changes, and then download the area visible on the screen (requires network connectivity)
Query Overpass... - run a query against a Overpass API server (requires network connectivity)
Location based auto download - download an area around the current geographic location automatically (requires network connectivity or offline data) (requires GPS)
Pan and zoom auto download - download data for the currently displayed map area automatically (requires network connectivity or offline data) (requires GPS)
Update data - re-download data for all areas and update what is in memory (requires network connectivity)
Clear data - remove any OSM data in memory, including pending changes.
File... - saving and loading OSM data to/from on device files.
Tasks... - download (automatically and manually) OSM Notes and "Bugs" from QA tools (currently OSMOSE) (requires network connectivity)

Самый простой способ загрузить данные на устройство - найти нужную позицию на карте и выбрать "Загрузить текущее место". Вы можете менять масштаб сведением пальцев, кнопками на экране или кнопками громкости. Vespucci загрузит данные для текущей области на карте. Для загрузки данных не требуется авторизация.

In unlocked state any non-downloaded areas will be dimmed relative to the downloaded ones if you are zoomed in far enough to enable editing. This is to avoid inadvertently adding duplicate objects in areas that are not being displayed. In the locked state dimming is disabled, this behaviour can be changed in the Advanced preferences so that dimming is always active.

If you need to use a non-standard OSM API entry, or use offline data in MapSplit format you can add or change entries via the Configure... entry for the data layer in the layer control.

Редактирование#

Блокировка, разблокировка, переключение режимов#

Для предотвращения случайных изменений Vespucci сначала запускается в "заблокированном" режиме, где разрешено только перемещаться по карте. Нажмите на значок Locked , чтобы разблокировать экран.

A long press on the lock icon or the Modes menu in the map display overflow menu will display a menu offering 4 options:

Normal - the default editing mode, new objects can be added, existing ones edited, moved and removed. Simple white lock icon displayed.
Tag only - selecting an existing object will start the Property Editor, new objects can be added via the green "+" button, or long press, but no other geometry operations are enabled. White lock icon with a "T" is displayed.
Address - enables Address mode, a slightly simplified mode with specific actions available from the Simple mode "+" button. White lock icon with an "A" is displayed.
Indoor - enables Indoor mode, see Indoor mode. White lock icon with an "I" is displayed.
C-Mode - enables C-Mode, only objects that have a warning flag set will be displayed, see C-Mode. White lock icon with a "C" is displayed.

If you are using Vespucci on an Android device that supports short cuts (long press on the app icon) you can start directly to Address and Indoor mode.

Простое, двойное и долгое нажатие#

По умолчанию, выделяемые линии и точки имеют вокруг себя оранжевую область, означающую, где нужно прикоснуться, чтобы выбрать объект. У Вас есть три возможности:

Простое нажатие: выделяет объект.
- При этом отдельная точка или линия подсвечиваются.
- Однако если вы попытаетесь выделить объект и vespucci определит что можно выделить несколько объектов, появится диалог со списком объектов для выбора.
- Выделенные объекты подсвечиваются желтым.
- Дополнительная информация содержится в главах Выделена точка, Выделена линия и Выделено отношение.
Двойное нажатие: включает режим одновременного выбора объектов Множественное выделение
Долгое нажатие: включает "прицел", режим создания точек, который описан, в разделе Создание новых объектов. Эти действия доступны, когда отключен "Простой режим" редактора.

Если вы пытаетесь редактировать область с высокой плотностью данных, разумно будет приблизить её.

У Vespucci хорошая система отмены и повторения правок, поэтому не бойтесь экспериментировать на устройстве, однако не загружайте на сервер тестовые данные.

Выделение / Снятие выделения (простое нажатие и меню выделения)#

Нажмите на объект, чтобы выделить его и выбрать. Касание экрана в пустом месте отменит выбор. Если Вы выбрали объект, а вам нужно выбрать другой, просто нажмите на нужный объект: нет необходимости сначала отменять выбор выделенного объекта. Двойное нажатие на объекте включит режим Множественное выделение.

Обратите внимание, когда Вы пытаетесь выделить объект и Vespucci посчитает, что может быть выделено несколько объектов (таких, как точка на линии или другие перекрывающиеся объекты), будет показано меню выделения: нажмите на объект, который Вы хотели выбрать и он будет выделен.

Выбранные объекты отображаются с дополнительным тонким жёлтым бордюром. Он может быть плохо заметен на некоторых цветах фона карты или при некоторых масштабах. Когда выделение сделано, Вы увидите уведомление, подтверждающее выбор.

Once the selection has completed you will see (either as buttons or as menu items) a list of supported operations for the selected object: For further information see Node selected, Way selected and Relation selected.

Выделенные объекты: Редактирование тэгов#

Двойной тап по выбранному обьекту открывает редактор тегов, вы сможете редактировать теги связанные с обьектом.

Note that for overlapping objects (such as a node on a way) the selection menu comes back up for a second time. Selecting the same object brings up the tag editor; selecting another object simply selects the other object.

Выделенные объекты: Перемещение точки или линии#

Once you have selected an object, it can be moved. Note that objects can be dragged/moved only when they are selected. Simply drag near (i.e. within the tolerance zone of) the selected object to move it. If you select the large drag area in the preferences, you get a large area around the selected node that makes it easier to position the object.

Добавление новой точки/узла или линии#

On first start the app launches in "Simple mode", this can be changed in the main menu by un-checking the corresponding checkbox.

Простой режим#

Tapping the large green floating button on the map screen will show a menu. After you've selected one of the items, you will be asked to tap the screen at the location where you want to create the object, pan and zoom continues to work if you need to adjust the map view.

See Creating new objects in simple actions mode for more information. Simple mode os the default for new installs.

Advanced (long press) mode#

Long press where you want the node to be or the way to start. You will see a black "crosshair" symbol. * If you want to create a new node (not connected to an object), touch away from existing objects. * If you want to extend a way, touch within the "tolerance zone" of the way (or a node on the way). The tolerance zone is indicated by the areas around a node or way.

Когда вы увидете символ перекрестия, у вас появятся следующие опции:

Normal press in the same place.
- If the crosshair is not near a node, touching the same location again creates a new node. If you are near a way (but not near a node), the new node will be on the way (and connected to the way).
- If the crosshair is near a node (i.e. within the tolerance zone of the node), touching the same location just selects the node (and the tag editor opens. No new node is created. The action is the same as the selection above.
Normal touch in another place. Touching another location (outside of the tolerance zone of the crosshair) adds a way segment from the original position to the current position. If the crosshair was near a way or node, the new segment will be connected to that node or way.

Simply touch the screen where you want to add further nodes of the way. To finish, touch the final node twice. If the final node is located on a way or node, the segment will be connected to the way or node automatically.

You can also use a menu item: See Creating new objects for more information.

Добавить область#

OpenStreetMap currently doesn't have an "area" object type unlike other geo-data systems. The online editor "iD" tries to create an area abstraction from the underlying OSM elements which works well in some circumstances, in others not so. Vespucci currently doesn't try to do anything similar, so you need to know a bit about the way areas are represented:

closed ways (*polygons"): the simplest and most common area variant, are ways that have a shared first and last node forming a closed "ring" (for example most buildings are of this type). These are very easy to create in Vespucci, simply connect back to the first node when you are finished with drawing the area. Note: the interpretation of the closed way depends on its tagging: for example if a closed way is tagged as a building it will be considered an area, if it is tagged as a roundabout it wont. In some situations in which both interpretations may be valid, an "area" tag can clarify the intended use.
multi-polygons: some areas have multiple parts, holes and rings that can't be represented with just one way. OSM uses a specific type of relation (our general purpose object that can model relations between elements) to get around this, a multi-polygon. A multi-polygon can have multiple "outer" rings, and multiple "inner" rings. Each ring can either be a closed way as described above, or multiple individual ways that have common end nodes. While large multi-polygons are difficult to handle with any tool, small ones are not difficult to create in Vespucci.
coastlines: for very large objects, continents and islands, even the multi-polygon model doesn't work in a satisfactory way. For natural=coastline ways we assume direction dependent semantics: the land is on the left side of the way, the water on the right side. A side effect of this is that, in general, you shouldn't reverse the direction of a way with coastline tagging. More information can be found on the OSM wiki.

Улучшение геометрии линий#

If you zoom in far enough on a selected way you will see a small "x" in the middle of the way segments that are long enough. Dragging the "x" will create a node in the way at that location. Note: to avoid accidentally creating nodes, the touch tolerance area for this operation is fairly small.

Вырезание, копирование и вставка#

You can copy selected nodes and ways, and then paste once or multiple times to a new location. Cutting will retain the osm id and version, thus can only be pasted once. To paste long press the location you want to paste to (you will see a cross hair marking the location). Then select "Paste" from the menu.

Эффективное добавление адресов#

Vespucci supports functionality that makes surveying addresses more efficient by predicting house numbers (left and right sides of streets separately) and automatically adding addr:street or addr:place tags based on the last used value and proximity. In the best case this allows adding an address without any typing at all.

Adding the tags can be triggered by pressing Address :

after a long press (in non-simple mode only): Vespucci will add a node at the location and make a best guess at the house number and add address tags that you have been lately been using. If the node is on a building outline it will automatically add an "entrance=yes" tag to the node. The tag editor will open for the object in question and let you make any necessary further changes.
in the node/way selected modes: Vespucci will add address tags as above and start the tag editor.
in the property editor.

To add individual address nodes directly while in the default "Simple mode" switch to "Address" editing mode (long press on the lock button), "Add address node" will then add an address node at the location and if it is on a building outline add a entrance tag to it as described above.

Для того, чтобы интерполяция номеров домов работала, обычно требуется, чтобы на каждой стороне дороги уже существовало хотя бы два номера. Чем больше номеров домов имеется в данных этой области, тем лучше.

Consider using this with one of the Auto-download modes.

Добавление ограничений поворотов#

Vespucci has a fast way to add turn restrictions. if necessary it will split ways automatically and ask you to re-select elements.

select a way with a highway tag (turn restrictions can only be added to highways, if you need to do this for other ways, please use the generic "create relation" mode)
select "Add restriction" from the menu
select the "via" node or way (only possible "via" elements will have the touch area shown)
select the "to" way (it is possible to double back and set the "to" element to the "from" element, Vespucci will assume that you are adding an no_u_turn restriction)
set the restriction type

Vespucci в "locked" режиме#

Когда показывается красный замок, то все не изменяющие действия активны. Дополнительно, долгий тап по объекту покажет детальную информацию по OSM объекту.

Сохранение изменений#

(требуется доступ в интернет)

Используйте ту же кнопку или меню, которые вы выбирали для подгрузки данных, но теперь нажмите "Передача данных на сервер OSM".

Vespucci supports OAuth 2, OAuth 1.0a authorization and the classical username and password method. Since July 1st 2024 the standard OpenStreetMap API only supports OAuth 2 and other methods are only available on private installations of the API or other projects that have repurposed OSM software.

Authorizing Vespucci to access your account on your behalf requires you to one time login with your display name and password. If your Vespucci install isn't authorized when you attempt to upload modified data you will be asked to login to the OSM website (over an encrypted connection). After you have logged on you will be asked to authorize Vespucci to edit using your account. If you want to or need to authorize the OAuth access to your account before editing there is a corresponding item in the "Tools" menu.

Если вы хотите сохранить свои труды, а интернет-соединения поблизости нет, вы можете сохранить данные в файл формата .osm и передать его на сервер позднее с помощью Vespucci или JOSM.

Разрешение конфликтов данных при передаче на сервер#

Vespucci has a simple conflict resolver. However if you suspect that there are major issues with your edits, export your changes to a .osc file ("Export" menu item in the "Transfer" menu) and fix and upload them with JOSM. See the detailed help on conflict resolution.

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.

More information on this and other available functionality on the main display can be found here Main map display.

Using GPS and GPX tracks#

With standard settings Vespucci will try to enable GPS (and other satellite based navigation systems) and will fallback to determining the position via so called "network location" if this is not possible. This behaviour assumes that you in normal use have your Android device itself configured to only use GPX generated locations (to avoid tracking), that is you have the euphemistically named "Improve Location Accuracy" option turned off. If you want to enable the option but want to avoid Vespucci falling back to "network location", you should turn the corresponding option in the Advanced preferences off.

Touching the GPS button (normally on the left hand side of the map display) will center the screen on the current position and as you move the map display will be panned to maintain this. Moving the screen manually or editing will cause the "follow GPS" mode to be disabled and the blue GPS arrow will change from an outline to a filled arrow. To quickly return to the "follow" mode, simply touch GPS button or re-check the equivalent menu option. If the device doesn't have a current location the location marker/arrow will be displayed in black, if a current location is available the marker will be blue.

To record a GPX track and display it on your device select "Start GPX track" item in the GPS menu. This will add layer to the display with the current recorded track, you can upload and export the track from the entry in the layer control. Further layers can be added from local GPX files and tracks downloaded from the OSM API.

Note: by default Vespucci will not record elevation data with your GPX track, this is due to some Android specific issues. To enable elevation recording, either install a gravitational model, or, simpler, go to the Advanced preferences and configure NMEA input.

How to export a GPX track?#

Open the layer menu, then click the 3-dots menu next to "GPX recording", then select Export GPX track.... Choose in which folder to export the track, then give it a name suffixed with .gpx (example: MyTrack.gpx).

Notes, Bugs and Todos#

Vespucci supports downloading, commenting and closing of OSM Notes (formerly OSM Bugs) and the equivalent functionality for "Bugs" produced by the OSMOSE quality assurance tool. Both have to either be down loaded explicitly or you can use the auto download facility to access the items in your immediate area. Once edited or closed, you can either upload the bug or Note immediately or upload all at once.

Further we support "Todos" that can either be created from OSM elements, from a GeoJSON layer, or externally to Vespucci. These provide a convenient way to keep track of work that you want to complete.

On the map the Notes and bugs are represented by a small bug icon Bug , green ones are closed/resolved, blue ones have been created or edited by you, and yellow indicates that it is still active and hasn't been changed. Todos use a yellow checkbox icon.

The OSMOSE bug and Todos display will provide a link to the affected element in blue (in the case of Todos only if an OSM element is associated with it), touching the link will select the object, center the screen on it and down load the area beforehand if necessary.

Filtering#

Besides globally enabling the notes and bugs display you can set a coarse grain display filter to reduce clutter. The filter configuration can be accessed from the task layer entry in the layer control:

Notes
Osmose error
Osmose warning
Osmose minor issue
Maproulette
Todo

План помещения#

Mapping indoors is challenging due to the high number of objects that very often will overlay each other. Vespucci has a dedicated indoor mode that allows you to filter out all objects that are not on the same level and which will automatically add the current level to new objects created there.

Режим может быть включен долгим нажатием на заблокированном объекте, см. Блокировка, разблокировка, переключение режимов и выбором соответствующего пункта меню.

"Только конфликты" (C-Mode)#

In C-Mode only objects are displayed that have a warning flag set, this makes it easy to spot objects that have specific problems or match configurable checks. If an object is selected and the Property Editor started in C-Mode the best matching preset will automatically be applied.

Режим может быть включен долгим нажатием на заблокированном объекте, см. Блокировка, разблокировка, переключение режимов и выбором соответствующего пункта меню.

Настройка проверок#

All validations can be disabled/enabled in the "Validator settings/Enabled validations" in the preferences.

The configuration for "Re-survey" entries allows you to set a time after which a tag combination should be re-surveyed. "Check" entries are tags that should be present on objects as determined by matching presets. Entries can be edited by clicking them, the green menu button allows adding of entries.

Re-survey entries#

Re-survey entries have the following properties:

Key - Key of the tag of interest.
Value - Value the tag of interest should have, if empty the tag value will be ignored.
Age - how many days after the element was last changed the element should be re-surveyed, if a check_date tag is present that will be the used, otherwise the date the current version was create. Setting the value to zero will lead to the check simply matching against key and value.
Regular expression - if checked Value is assumed to be a JAVA regular expression.

Key and Value are checked against the existing tags of the object in question.

The Annotations group in the standard presets contain an item that will automatically add a check_date tag with the current date.

Check entries#

Check entries have the following two properties:

Key - Key that should be present on the object according to the matching preset.
Require optional - Require the key even if the key is in the optional tags of the matching preset.

This check works by first determining the matching preset and then checking if Key is a "recommended" key for this object according to the preset, Require optional will expand the check to tags that are "optional* on the object. Note: currently linked presets are not checked.

Фильтры#

Tag based filter#

The filter can be enabled from the main menu, it can then be changed by tapping the filter icon. More documentation can be found here Tag filter.

Preset based filter#

An alternative to the above, objects are filtered either on individual presets or on preset groups. Tapping on the filter icon will display a preset selection dialog similar to that used elsewhere in Vespucci. Individual presets can be selected by a normal click, preset groups by a long click (normal click enters the group). More documentation can be found here Preset filter.

Настройка Vespucci#

Many aspects of the app can be customized, if you are looking for something specific and can't find it, the Vespucci website is searchable and contains additional information over what is available on device.

Layer settings#

Layer settings can be changed via the layer control ("hamburger" menu in the upper right corner), all other setting are reachable via the main menu preferences button. Layers can be enabled, disabled and temporarily hidden.

Available layer types:

Data layer - this is the layer OpenStreetMap data is loaded in to. In normal use you do not need to change anything here. Default: on.
Background layer - there is a wide range of aerial and satellite background imagery available. The default value for this is the "standard style" map from openstreetmap.org.
Overlay layer - these are semi-transparent layers with additional information, for example quality assurance information. Adding an overlay may cause issues with older devices and such with limited memory. Default: none.
Notes/Bugs display - Open Notes and bugs will be displayed as a yellow bug icon, closed ones the same in green. Default: on.
Photo layer - Displays geo-referenced photographs as red camera icons, if direction information is available the icon will be rotated. Default: off.
Mapillary layer - Displays Mapillary segments with markers where images exist, clicking on a marker will display the image. Default: off.
GeoJSON layer - Displays the contents of a GeoJSON file, multiple layers can be added from files. Default: none.
GPX layer - Displays GPX tracks and way points, multiple layers can be added from files, during recording the generate GPX track is displayed in its own one . Default: none.
Grid - Displays a scale along the sides of the map or a grid. Default: on.

More information can be found in the section on the map display.

Preferences#

Keep screen on. Default: off.
Large node drag area. Moving nodes on a device with touch input is problematic since your fingers will obscure the current position on the display. Turning this on will provide a large area which can be used for off-center dragging (selection and other operations still use the normal touch tolerance area). Default: off.

The full description can be found here Preferences

Расширенные параметры#

Full screen 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: Auto.
Node icons. Default: on.
Always show context menu. When turned on every selection process will show the context menu, turned off the menu is displayed only when no unambiguous selection can be determined. Default: off (used to be on).
Enable light theme. On modern devices this is turned on by default. While you can enable it for older Android versions the style is likely to be inconsistent.

The full description can be found here Advanced preferences

Reporting and Resolving Issues#

If Vespucci crashes, or it detects an inconsistent state, you will be asked to send in the crash dump. Please do so if that happens, but please only once per specific situation. If you want to give further input or open an issue for a feature request or similar, please do so here: Vespucci issue tracker. The "Provide feedback" function from the main menu will open a new issue and include the relevant app and device information without extra typing.

If you are experiencing difficulties starting the app after a crash, you can try to start it in Safe mode on devices that support short cuts: long press on the app icon and then select Safe from the menu.

If you want to discuss something related to Vespucci, you can either start a discussion on the OpenStreetMap forum.