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 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.
Afhankelijk van de schermgrootte en de leeftijd van je apparaat, kunnen acties direct beschikbaar zijn via een icoon in de bovenbalk, via een menu rechts van de topbalk, via de onderbalk (wanneer zichtbaar) of via de menu knop.
Select either the transfer icon or the "Transfer" menu item. This will display eleven options:
De gemakkelijkste manier om data te downloaded is door te slepen en te zoomen naar de locatie die je wilt wijzigen en dan "Download in huidige weergave" te selecteren. Je kan zoomen door schermbewegingen, de zoom knoppen of de volumeknoppen op het apparaat. Vespucci zal dan de data downloaden in de huidige weergave. Er is geen authenticatie vereist voor het downloaden van data naar je apparaat.
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.
Om onbedoelde veranderingen te voorkomen, start Vespucci in "vergendelde" modus, waarmee je alleen kan slepen en zoomen met de kaart. tik op het icoon om het scherm te ontgrendelen.
Een lange klik op het slot-icoon of het Modes menu in het uitklapmenu in de kaartweergave, toont het menu met 4 opties:
Als je Vespucci gebruikt op een Android apparaat dat shortcuts ondersteunt (druk lang op het app icoon), kan je direct starten in Adres en Binnen modus.
Standaard hebben selecteerbare knopen en wegen een oranje oppervlakte om zich heen waarmee het object geselecteerd kan worden. Je hebt drie opties:
Het is een goed idee om in te zoomen als je wijzigingen wilt maken in een gebied met een hoge dichtheid.
Vespucci heeft een goed "ongedaan maken" en "opnieuw" systeem, dus wees niet bang om te experimenteren op je apparaat. Maar zorg ervoor dat je test data niet opslaat en uploadt.
Tik op een object om het te selecteren en te markeren. Tikken in een leeg gebied op het scherm zal deselecteren. Als je een object hebt geselecteerd en je wilt iets anders selecteren, dan kan je er direct op tikken zonder eerst te deselecteren. Een dubbele tik op een object begint de Multiselectie modus.
Als je een object probeert te selecteren en Vespucci bepaalt dat de selectie meerdere objecten zou kunnen betekenen (zoals een knoop in een weg of andere overlappende objecten), dan zal er een selectiemenu worden weergegen: Tik het object dat je wilt selecteren, en het object wordt geselecteerd.
Geselecteerde objecten worden aangeduidt met een dunne gele rand. De gele rand kan moeilijk zijn om te zien, afhankelijk van de kaart achtergrond en de zoom factor. Als een selectie is gemaakt, zie je een bevestigingsnotificatie.
Als een selectie is gelukt, dan zie je (als knoppen of al menu items) een lijst van beschikbare acties voor het geselecteerde object. Voor meer informatie zie Geselecteerde knoop, Geselecteerde weg en Geselecteerde relatie.
Een tweede klik op een geselecteerd object, opent de tag bewerker waarmee de toegekende tags van het object kunnen worden gewijzigd.
Voor overlappende objecten (zoals een knoop op een weg) wordt het selectiemenu een tweede keer getoond. Als je hetzelfde object aanklikt wordt de tag bewerker getoond; als je een ander object aanklikt wordt dat object geselecteerd.
Als je een object hebt geselecteerd, dan kan het worden verplaatst. Objecten kunnen alleen worden verplaatst als ze zijn geselecteerd. Sleep dichtbij (dus binnen de tolerantie zone van) het geselecteerde object om het te verplaatsen. Als je een grote sleepoppervlakte selecteert in de [instellingen]](Preferences.md), dan krijg je een grote oppervlakte rond de geselecteerde knoop waarmee het gemakkelijker geplaatst kan worden.
De eerste keer start de app in "Simpele modus". Dat kan worden gewijzigd in het hoofdmenu door de bijbehorende selectievakje uit te vinken.
Het klikken op de grote groene kop op het kaartscherm toont een menu. Als je een van de items hebt geselecteerd, wordt gevraagd om het scherm te klikken op de locatie waar je het object wilt maken. Slepen en zoomen blijft werken als je de kaartweergave wilt aanpassen.
Zie Nieuwe objecten maken in simpele actiemodus voor meer informatie. Simpele modus is standaard voor nieuwe installaties.
Klik lang waar je de knoop wilt plaatsen of de weg wilt beginnen. Je ziet een zwart "crosshair" symbool. * Om een nieuwe knoop (dat niet is verbonden aan een object) te maken, klik op een gebied zonder bestaande objecten . * Om een weg te verlengen, klik binnen de "tolerantiezone" van de weg (of een knoop in de weg). De tolerantiezone is aangegeven met een oppervlakte rond de knoop of weg.
Als je het "crosshair" symbool ziet heb je deze opties:
Klik op het scherm waar je nieuwe knopen aan de weg wilt toevoegen. Om af te ronden kan tweemaal worden geklikt op de laatste knoop. Als de laatste knoop zich op de locatie van een weg of knoop bevindt, zal het segment automatisch aan de weg of knoop worden verbonden.
Je kan ook een menu item gebruiken: Zie Nieuwe objecten maken voor meer informatie.
OpenStreetMap heeft op het moment geen "oppervlakte" object type zoals andere geo-data systemen. De online bewerker "iD" probeert een abstractie te maken van de onderliggende OSM elementen waarmee wordt gewerkt. Dat werkt goed in sommige omstandigheden en minder goed in andere. Vespucci probeert dat niet, dus je zult iets moeten weten over hoe weg-oppervlaktes worden voorgesteld:
Als je ver genoeg inzoomt op een geselecteerde weg dan zie je een kleine "x" in het midden van de wegsegmenten die lang genoeg zijn. Het slepen van de "x" zal een nieuwe knoop maken in de weg op die locatie. Om te voorkomen dat er per ongeluk kopen worden gemaakt, is de tolerantiezone voor deze operatie redelijk klein.
Je kan geselecteerde knopen en wegen kopiëren en één of meerdere keren plakken op een nieuwe locatie. Knippen onthoudt de OSM identificatie en versie, en kan dus maar eenmalig worden geplakt. Om te plakken, druk lang op de locatie waar je wilt plakken (je ziet een doel dat de locatie markeert). Selecteer dan "Plakken" in het menu.
Vespucci ondersteunt functionaliteit om het vastleggen van adressen efficiënter te maken, door huisnummers te voorspellen (linker- en rechterkant van de straat los van elkaar) en automatisch addr:street of addr:place tags toe te voegen op basis van de laatst gebruikte waarden en nabijheid. In het beste geval kunnen adressen worden toegevoegd zonder te typen.
De tags toevoegen kan worden gedaan door te tikken op :
Om losse adres-knopen direct in te voeren tijdens het gebruik van de "Simpele modus", wissel naar "Adres modus" (lange tik op het slot-icoon). De "Voeg adres-knoop toe" voegt dan een adres-knoop toe op de locatie. Als de knoop binnen een gebrouw ligt, kan een ingangs-tag worden toegekend zoals hierboven beschreven.
Huisnummervoorspelling heeft normaal gesproken ten minste twee huisnummers aan beide kanten van de weg nodig om goed te werken. Hoe meer huisnummers zijn ingevoerd, hoe beter.
Er wordt geadviseerd om dit samen met een van de Auto-download modi te gebruiken.
Vespucci heeft een snelle manier om afslagbeperkingen toe te voegen. Zo nodig worden wegen opgesplitst en wordt gevraagd om elementen opnieuw te selecteren.
Als het rode slot wordt weergegeven dan zijn alle acties die niets wijzigen beschikbaar. Er kan ook lang worden geklikt op of dichtbij een object om het detailscherm weer te geven wanneer het een OSM object betreft.
(vereist netwerkverbinding)
Selecteer dezelfde knop of menu item als om te downloaden en selecteer "Upload data naar OSM server".
Vespucci ondersteunt OAuth 2, OAuth 1.0a authorizatie, en de klassieke gebruikersnaam en wachtwoord methode. Sinds 1 juli 2024 ondersteunt de standaard OpenStreetMap API alleen OAuth 2 en andere methodes zijn alleen beschikbaar op privé-installaties van de API of andere projecten die OSM software hebben aangepast.
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.
Om je werk op te slaan zonder internettoegang, kan je naar een JOSM compatible .osm bestand opslaan en het later met Vespucci of JSOM uploaden.
Vespucci heeft een simpele conflict-oplosser. Bij een vermoeden van grote problemen men je bewerkingen, exporteer je wijzigingen naar een .osc file ("Exporteren" menu item in het "Overbrengen" menu) en repareer en upload ze met JOSM. Zie de gedetaileerde hulp bij conflicten oplossen.
De weergave van interessante objecten in de omgeving kan worden getoond door de balk middenin de onderbalk omhoog te slepen.
Meer informatie hierover en andere functionaliteit op het hoofdscherm kan worden gevonden in Hoofdscherm weergave.
Met standaard instellingen zal Vespucci GPS (en andere satellietgebaseerde navigatiesystemen) proberen in te schakelen, en terugvallen op het bepalen van de locatie via "netwerk locatie". Dit gedrag neemt aan dat tijdens normaal gebruik het Android apparaat is geconfigureerd om alleen GPX gegenereerde locaties te gebruiken (om tracking te voorkomen), en dus dat de "Verbeterde Locatiebepaling" optie is uitgeschakeld. Als je deze optie wilt inschakelen, maar niet wilt dat Vespucci terugvalt op "netwerk locatie", kan je de optie uitzetten in de Geavanceerde instellingen.
Touching the 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.
Om een GPX-route op te nemen en hem op het apparaat weer te geven, selecteer "Start GPX-route" in het menu. Dit voegt een laag toe aan de weergave met de huidige opgenomen route. De route kan worden geüpload en geëxporteerd via de menu optie in lagen configuratie. Andere lagen kunnen worden toegevoegd van lokale GPX-bestanden of gedownload van de OSM API.
Let op: standaard zal Vecpucci geen hoogtegegevens opnemen in de GPX-route, wegens Android-specifieke problemen. Om hoogtegegevens toch op te nemen kan een zwaartekrachtmodel worden geïnstalleerd, of simpeler: ga naar de Geavanceerde instellingen en configureer NMEA invoer.
Open het lagen menu, klik op het 3-punten menu naast "GPX opnemen", en selecteer Exporteer GPX track.... Kies in welke map de track moet worden opgeslagen, en geef het een naam die eindigt met .gpx
(bijvoorbeeld: MijnTrack.gpx).
Vespucci ondersteunt het downloaden, commentaar geven en sluiten van OSM Notes (voorheen OSM Bugs) en de equivalente functionaliteit voor "Bugs" die worden gemaakt door de OSMOSE kwaliteitsgarantie tool. Beide moeten expliciet worden gedownload of er kan gebruik worden gemaakt van de automatische download functionaliteit om items te vinden in je directe omgeving. Na het aangepassen of sluiten van een Bug of Notitie kan het direct worden geüpload of alles in een keer.
Verder ondersteunen we "Taken" die kunnen worden aangemaakt van OSM objecten, vanuit een GeoJSON laag of van buiten Vecpucci. Deze taken geven een gemakkelijke manier om werk bij te houden.
Op de kaart worden Notities en Problemen voorgesteld door een klein insect (bug) icoon . Groene zijn opgelost, blauwe zijn door jou aangemaakt of aangepast, en geel geeft aan dat het probleem nog steeds actief en onaangepast is. Taken gebruiken een geel vinkje als icoon.
De OSMOSE fouten en taken weergave, toont een link naar het element in blauw (voor taken alleen als er een OSM element is gekoppeld). Klikken op de link zal het object selecteren, de kaart centreren en de gegevens in de omgeving van te voren zo nodig downloaden.
Behalve het globaal activeren van de weergave van Notities en Bugs, kan je een grove weergavefilter instellen om rommel te voorkomen. De filterconfiguratie kan worden gevonden van de takenlaag laag configuratie:
Binnen dingen in kaart brengen is ingewikkeld door het hoge aantal objecten dat over elkaar heen ligt. Vespucci heeft een speciale binnenmodus die het mogelijk maakt om alle objecten te filteren die niet op dezelfde verdieping zijn en zal automatisch de huidige verdieping aan nieuwe objecten toevoegen.
De modus kan worden aangezet door lang te klikken op de slot knop, zie Vergendelen, ontgrendelen, modus wijzigen en de goede modus te selecteren.
In C-Modus worden alleen objecten weergegeven met waarschuwingen. Dit maakt het gemakkelijk om objecten met specifieke problemen te vinden of het koppelen van configureerbare controles. Als een object is geselecteerd en de Eigenschappen Bewerker is gestart in C-Modus dan zal de best passende voorkeuze automatisch worden toegepast.
De modus kan worden aangezet door lang te klikken op de slot knop, zie Vergendelen, ontgrendelen, modus wijzigen en de goede modus te selecteren.
Alle validaties kunnen worden aan of uitgezet in de "Validator instellingen/Ingeschakelde validaties" in de instellingen.
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.
Opnieuw bekijken items hebben de volgende eigenschappen:
Sleutel en Waarde worden gecheckt tegen de bestaande tags in het object.
De Annotaties groep in de standaard voorkeuzes bevatten een item dat automatisch een check_date tag met de huidige datum zal toevoegen.
Check items hebben de volgende eigenschappen:
Deze check werkt door eerst de voorkeuze te achterhalen en dan te checken of Sleutel is een "aanbevolen" sleutel voor dit object volgens de voorkeuze, Vereis optioneel zal de check uitbreiden naar tags die "optioneel" zijn op het object. Let op: gekoppelde voorkeuzes worden niet gecheckt.
De filter kan worden aangezet via het hoofdmenu. Het kan dan worden gewijzigd door het filtericoon te tikken. Meer documentatie kan worden gevonden op Tag filter.
Een alternatief op het bovenstaande is het filteren van objecten op basis van losse voorkeuzes of voorkeuzegroepen. Tikken op het filtericoon toont een voorkeuze selectie scherm net als op andere plekken in Vespucci. Losse voorkeuzes kunnen met een normale tik worden selecteerd, voorkeuzegroepen kunnen met een lange tik worden geselecteerd (een normale tik gaat de groep binnen). Meer documentatie kan worden gevonden op Voorkeuze filter.
Veel aspecten van de app kunnen worden aangepast. Als je zoekt naar iets specifieks en het niet kan vinden, dan is de Vespucci website zoekbaar en die bevat additionele informatie over wat er beschikbaar is op het apparaat.
Lagen instellingen kunnen worden aangepast via de lagen instellingen knop ("hamburger" menu in rechter bovenhoek). Alle andere instellingen zijn bereikbaar via de instellingen in het hoofdmenu. Lagen kunnen worden ingeschakeld, uitgeschakeld of tijdelijk verborgen.
Beschikbare laagtypes:
Meer informatie kan worden gevonden op de kaartweergave.
De volledige beschrijving kan worden gevonden in Instellingen
De volledige beschrijving kan worden gevonden in Geavanceerde instellingen
Als Vespucci crasht, of een inconsitente staat detecteert, dan kan je worden gevraagd om een crash dump te versturen. Doe dat graag, maar maximaal één keer per specifieke situatie. Als je verdere toelichting wilt geven, of een probleemmelding wilt openen voor een vraag of opmerking dan kan dat hier: Vespucci problemendatabank. De "Geef feedback" functie van het hoofdmenu opent een nieuwe probleemelding en voegt automatisch relevante app- en systeeminformatie toe zonder extra typwerk.
Als je problemen hebt om de app op te starten na een crash, kan je proberen hem op te starten in Veilige modus op apparaten die shortcuts ondersteunen: druk lang op het app icoon, en selecteer Veilig in het menu.
Als je iets wilt discussiëren dat aan Vespucci gerelateerd is, kan je een discussie starten op het OpenStreetMap forum.