# Introdución ó 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 10.0 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.

## Empregar por primeira vez

On startup Vespucci shows you the "Download other location"/"Load Area" dialog after asking for the required permissions and displaying a welcome message. If you have coordinates displayed and want to download immediately, you can select the appropriate option and set the radius around the location that you want to download. Do not select a large area on slow devices.

De xeito alternativo, pode pecha-lo diálogo premendo o botón "Ir ó mapa" e afastar ou achegar cara unha localización onde desexe editar e baixa-los datos (ollar máis adiante: "Edición co Vespucci").

## Editando co Vespucci

Dependendo do tamaño da pantalla e da idade do seu dispositivo, as accións de edición poden ser accesíbeis de xeito directo a través das iconas na barra superior, a través dun menú despregábel á dereita da barra superior, dende a barra inferior (se está presente) ou a través da tecla do menú.

### Estasen a baixar datos do OSM

Selecciona a icona de transferencia! Transfer ou o "Transfer" artigo do menu. Isto amosará sete opcións:

- 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 and then download the area visible on the screen (requires network connectivity)
- Upload data to OSM server - upload edits to OpenStreetMap (requires authentication) (requires network connectivity)
- Update data - re-download data for all areas and update what is in memory (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)
- File... - saving and loading OSM data to/from on device files.
- Note/Bugs... - download (automatically and manually) OSM Notes and "Bugs" from QA tools (currently OSMOSE) (requires network connectivity)

O xeito máis sinxelo de baixar datos ó dispositivo é achegar e marca-la localización que desexa editar e despois escoller "Baixar vista actual". Podes achegar a imaxe empregando xestos, coma os botóns de achegamento ou os botóns de control do volume do dispositivo. O Vespucci tería que baixar entón datos da vista actual. Non se precisas dunha autenticación para baixar datos no teu dispositivo.

With the default settings any non-downloaded areas will be dimmed relative to the downloaded ones, this is to avoid inadvertently adding duplicate objects in areas that are not being displayed. The behaviour can be changed in the Advanced preferences.

### Estase a editar

#### Alternancia do modo bloquear e desbloquear

Para evitar edicións accidentais Vespucci comeza no modo "bloqueado", un modo que só permite achegar e mover o mapa. Tócao! Locked icona para desbloquear a pantalla.

Una premida longa na icona do candeado amosará un menú con 4 opcións:

- 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, a long press on the main screen will add objects, but no other geometry operations will work. 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.

#### Premido único, dobre premido e premido longo

De xeito predeterminado, os nós e as vías seleccionábeis teñen unha área laranxa ó redor dela, indicando de xeito aproximado onde ten que premer para escoller un obxecto. Ten tres opcións:

- Single tap: Selects object.
  - An isolated node/way is highlighted immediately.
  - However, if you try to select an object and Vespucci determines that the selection could mean multiple objects it will present a selection menu, enabling you to choose the object you wish to select.
  - Selected objects are highlighted in yellow.
  - For further information see Node selected, Way selected and Relation selected.
- Double tap: Start Multiselect mode
- Long press: Creates a "crosshair", enabling you to add nodes, see below and Creating new objects. This is only enabled if "Simple mode" is deactivated.

É unha boa estratexia achega-lo mapa se tenta editar unha área con alta densidade.

O Vespucci ten un bo sistema "desfacer/refacer" así que non teñas medo de experimentar no teu dispositivo, pero non subas e gardes datos de proba ó chou.

#### Selección / Deselección (premido único e "menú de selección")

Touch an object to select and highlight it. Touching the screen in an empty region will de-select. If you have selected an object and you need to select something else, simply touch the object in question, there is no need to de-select first. A double tap on an object will start Multiselect mode.

Teña en conta que se tenta escoller un obxecto e Vespucci determina que a selección podería significar varios obxectos (coma un nó nunha vía ou outros obxectos sobrepostos) presentará un menú de selección: prema o obxecto que desexe seleccionar e o obxecto é seleccionado.

Os obxectos seleccionados son indicados a través dun delgado bordo amarelo. O bordo amarelo pode ser difícil de detectar, dependendo do fondo do mapa e do factor de achegamento. Unha vez feita unha selección, verás unha notificación que confirma a selección.

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.

#### Obxectos escollidos: Editando etiquetas

Un segundo premido no obxecto seleccionado abre o editor de etiquetas e pode editar as etiquetas asociadas ó obxecto.

Teña en conta que para sobreponer obxectos (coma un nó nunha vía) o menú de selección volve a subir por segunda vez. Ó escolle-lo mesmo obxecto aparecerá o editor de etiquetas; escoller outro obxecto sinxelamente escolle o outro obxecto.

#### Obxectos seleccionados: movendo un nó ou camiño

Despois de seleccionar un obxecto, pode moverse. Teña en conta que os obxectos poden ser arrastrados/movidos só cando están seleccionados. Sinxelamente arrastre preto (isto é, dentro da zona de tolerancia) o obxecto seleccionado para movelo. Se escolle a área de arrastre grande nos axustes, obtén unha grande área ó redor do nó escollido que facilita a posicionamento do obxecto.

#### Engadindo un nevo Nodo/Punto ou Vía

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

##### Simple mode

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.

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

Unha vez que podes ver o símbolo da mira, tes estas opcións:

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

#### Estase a engadir unha área

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:

- vías pechadas ("polígonos"): A variante de área máis sinxela e máis común, son vías que teñen un primeiro e derradeiro nó compartido que forman un "anel" pechado (por exemplo, a maioría dos edificios son deste tipo). Son moi doados de crear no Vespucci, sinxelamente conéctate ó primeiro nó cando remate de debuxar a área. Nota: a interpretación do camiño pechado depende da súa etiquetaxe: por exemplo, se un camiño pechado está etiquetado coma un edificio considerado coma unha área, se está marcado coma unha rotonda, non vai. Nalgunhas situacións nas que ámbalas dúas interpretacións poden ser válidas, unha etiqueta de "área" pode aclarar o uso desexado.
- multi-polígonos: Algunhas áreas teñen múltiples partes, buracos e aneis que non se poden representar cunha soa vía. O OSM emprega un tipo específico de relación (o noso obxecto de propósito xeral que pode modelar as relacións entre elementos) para evitar isto, un multipolígono. Un multipolígono pode ter varios aneis "externos" e múltiples aneis "internos". Cada anel pode ser unha vía pechada coma se describe enriba, ou varias vías individuais que teñen nós nos extremos comúns. Mentres os grandes multipolígonos son difíciles de manexar con calquera ferramenta, os pequenos non son difíciles de crear no Vespucci.
- beiramar: Para obxectos moi grandes, continentes e illas, mesmo o modelo multipolígono non funciona de xeito satisfactorio. Para formas natural=coastline tomamos a semántica dependente de dirección: a terra está na beira esquerda do camiño, o auga na beira dereita. Un efecto secundario disto é que, en xeral, non debe revertir a dirección dunha vía co etiquetado da costa. Pode atopar máis información na wiki do OSM.

#### Estase a mellora-la xeometría das vías

Se achegaches o suficiente na vía seleccionada, verás un pequeno "x" no medio dos segmentos que son o suficientemente longos. Arrastrando o "x" creará un nó na vía dese lugar. Nota: para evitar a creación de nós de xeito accidental, a área de tolerancia táctil para esta operación é bastante pequena.

#### Cortar, copiar e colar

Pode copiar ou cortar nós e vía seleccionados e, deseguido, colar ou pegar unha ou varias veces nunha nova ubicación. O corte conservará o ID e versión do OSM. Para colar prema a posición na que desexa colar (verá unha liña cruzada marcando a localización). Deseguido, escolla "Colar ou pegar" no menú.

#### Estasen a engadir enderezos de xeito eficiente

Vespucci has an "add address tags" function that tries to make surveying addresses more efficient by predicting the current house number. It can be selected:

- after a long press (_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 a "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.

A predicción de números de casa normalmente require que polo menos dous números de casa a cada lado da estrada para ser ingresados ao traballo, cantos máis números presentes nos datos mellor.

Considerar usando isto con modo Auto-download.

#### Estasen a engadir restriccións de xiro

O Vespucci ten un xeito axiña de engadir restricións de xiro. Se é necesario, dividirase de xeito automático e pediralle que volva selecciona-los elementos.

- Seleccione un camiño cunha etiqueta de autoestrada (as restricións de xiro só se poden engadir ás autoestradas, se hai que facer isto por outros xeitos, empregue o modo xenérico "crear relacións").
- Escolla "Engadir restricións" no menú
- Escolla o nó "vía" ou o camiño (só os elementos "via" posíbeis terán a área táctil amosada)
- Escolla o modo "a" (é posíbel volver a dobrar e configura-lo elemento "a" no elemento "dende", o Vespucci asumirá que está engadindo un xiro sen restricións no_u_turn)
- Estabeleza o tipo de restrición

### O Vespucci no modo "bloqueado"

Cando se amosa o bloqueo vermello, tódalas accións non editadas están dispoñíbeis. Adicionalmente, unha prensa longa ou próxima a un obxecto amosará a pantalla de información detallada se é un obxecto OSM.

### Estasen a garda-las súas mudanzas

(require conectividade na rede)

Escolla o mesmo botón ou elemento do menú que fixo para a baixada e agora escolla "Subir datos no servidor do OSM".

O Vespucci admite a autorización do OAuth e o método clásico de nome do usuario e contrasinal. O OAuth é preferíbel xa que evita o envío de contrasinais nun texto plano.

As novas instalacións do Vespucci terán o OAuth activado por defecto. No primeiro intento de subir datos modificados, carrega unha páxina do sitio web do OSM. Despois de iniciar sesión (a través dunha conexión cifrada) pediráselle que autorice ó Vespucci a editar empregando a súa conta. Se queres ou precisas autoriza-lo acceso do OAuth á súa conta antes de editar hai un elemento correspondente no menú "Ferramentas".

Se desexa garda-lo seu traballo e non ten acceso á Internet, pode gardar nun ficheiro .osm compatíbel co JOSM e subilo máis tarde co Vespucci ou co JOSM.

#### Estasen a resolver conflitos ó subir

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.

## Estase a empregar GPS

Podes empregar o Vespucci para crear unha pista GPX e visualizalo no teu dispositivo. Ademais, podes amosar a posición actual do GPS (configurar "Amosar localización" no menú GPS) e/ou ter a pantalla en torno e seguir a posición (configura "Seguir posición GPS" no menú GPS).

Se ten este último conxunto, mover a pantalla de xeito manual ou editar fará que o modo "Seguer GPS" se desactive e que a frecha azul do GPS troque dun esquema cara unha frecha chea. Para voltar axiña ó modo "seguer", sinxelamente prema o botón GPS ou volva a verificar a opción do menú.

## Notas e erros

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.

No mapa, as notas e os erros están representados por unha pequena icona de erro! Bug, os verdes están pechados/resoltos, os que foron creados ou editados son azuis e o amarelo indica que aínda está activo e non foi modificado.

A visualización de erros do OSMOSE fornecerá unha ligazón ó obxecto afectado en azul, premendo a ligazón seleccionará o obxecto, centrará a pantalla nel e baixará a área previamente se fose necesario.

### Filtrado

Besides globally enabling the notes and bugs display you can set a coarse grain display filter to reduce clutter. In the Advanced preferences you can individually select:

- Notes
- Osmose error
- Osmose warning
- Osmose minor issue
- Custom

## Modo Interior

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.

The mode can be enabled by long pressing on the lock item, see Lock, unlock, mode switching and selecting the corresponding menu entry.

## Modo-C

No Modo-C só se amosan os obxectos que teñen activa un sinal de aviso, isto fai máis doado resaltar obxectos que teñen problemas específicos ou coinciden con comprobacións configurábeis. Se un obxecto é seleccionado e o Editor de Propiedades iniciado no Modo-C aplicarase de xeito automático o predefinido que mellor se axuste.

The mode can be enabled by long pressing on the lock item, see Lock, unlock, mode switching and selecting the corresponding menu entry.

### Estasen a configura-las comprobacións

Currently there are two configurable checks (there is a check for FIXME tags and a test for missing type tags on relations that are currently not configurable) both can be configured by selecting "Validator settings" in the "Preferences".

The list of entries is split in to two, the top half lists "re-survey" entries, the bottom half "check entries". 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.

#### Comprobar entradas

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.

## Filtros

### Filgros baseados en Etiquetas

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.

### Filtro baseado nos predefinidos

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.

## Persoalizando 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 GPX tracks. 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. Default: off.
- Grid - Displays a scale along the sides of the map or a grid. Default: on.

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

#### Axustes avanzados

- 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

## Informar de problemas

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 want to discuss something related to Vespucci, you can either start a discussion on the Vespucci Google group or on the OpenStreetMap Android forum