Uploading your changes

While Vespucci allows you to save your edits to local files on your device, most use cases center around uploading and publishing your data to a server providing the OpenStreetMap editing API and that will be the instance available on openstreetmap.org if you are contributing to regular OpenStreetMap. The following information only concerns itself with this standard configuration, other APIs and non-standard authorizations methods can be configured in the data layer configuration.

Authorization

To successfully publish your edits you need to authorize your Vespucci on your device to access your account on openstreetmap.prg on your behalf. You can start the authorization process by either selecting the corresponding option in the configuration dialog display on initial install of the app, by starting an upload process or by using the Authorize OAuth option from the Tools menu.

Note that you will need to have your OSM display name and password available and be connected to the Internet to successfully complete authorization, if you don't already have an account you will have to create one outside of Vespucci prior to starting authorization. While it technically would be possible to create the account from inside the app, doing so invokes additional requirements from google that we cannot fulfill for legal reasons.

During the authorization process you will be connected to openstreetmap.org and asked to login to your account, you then need to confirm the authorization and will be returned back to Vespuccis map map display.

If you have pending edits and for whatever reason cannot authorize, Vespucci reliably saves your edits on your device until you upload them or explicitly delete them. If you want to be extra safe you can save them to a local file in OCS or (J)OSM format that you can read with Vespucci or import in to JOSM.

Uploading

To upload your edits you can either select Upload data to OSM server from the Transfer menu, or select Upload element from the overflow menu in any of the element selection modes or multi-select. The later will only upload the selected elements.

The Upload changes dialog display two tabs Changes and Properties. The Changes tab displays a list of all the OSM elements that will be affected by the upload, the type of change and an information button that allows you to view further information on the element and jump to it to make corrections. The Properties tab allows you to set a comment for this upload and document that source that was used to create the changes (for example survey if you were personally present at the location in question). Prior entries in both fields are retained and can be used when appropriate.

It is considered best practice to provide meaningful information for other mappers in these fields. However Vespucci will automatically include a summary of your changes (starting with version 20.2) and a list of all imagery layers used for the current set of changes. If you leave the comment field empty it will include text pointing to the automatically generated summary.

Upload options