Frequently Asked Questions

What is Vespucci?

Vespucci is the first OpenStreetMap editor for Android. That means: It is a light-weight, easy-to-use mapping tool on mobile Android devices.

What is Vespucci NOT?

I am already familiar with OSM editor xyz. Why should I use Vespucci?

If you are mapping for OSM and already have an Android device (or planning for this) then Vespucci could help in your mapping work. Data is acquired "on site" and uploaded to the OSM server. By entering data in your mobile device "on the road" you can save time because you do not have to upload GPS tracks to your home PC and work your way again through these. Additionally, obscure OSM data can be verified easily and quickly "on site", data which is already available in OSM is not acquired again.

What do I need to get started with Vespucci?

You need:

What is the status of Vespucci development?

The current Vespucci version is 0.9.7, 0.9.8 is currently in developement.

Is Vespucci available for other mobile platforms?

No, with the exception of those that provide an Android compatible environment.

How can I obtain Vespucci?

See Obtaing Vespucci

How can I install Vespucci on my Android device?

Just download and install like any other app =)

How can I install Vespucci on the Android emulator?

Installation of the Vespucci APK is like any other APK. There are plenty descriptions available (e.g. 1 , 2 , 3 , 4 )

Running Vespucci on "old and small" devices

Modern (0.8 and up) Vespucci versions have been tested and found to work on Android 2.2 and later, however older devices tend to have very limited memory and correspondingly the apps are allocated very small amounts of heap (this can be as low as 16MB). If you are trying to run Vespucci on such a device, particularly with 0.9.4 and later, the following hints should be helpful (ordered in decreasing order of importance):

Can't download data from OpenStreetMap servers

If it is not a connectivity issue you may be running in to the following problem: current Vespucci versions use https (encrypted connections) to connect to the OpenStreetMap servers, if you are running on an older Android version this may be failing due to problems the old devices have with more recent certificates.

Workaround: create a new non-https API entry (enter "http://api.openstreetmap.org/api/0.6/" as API URL) and select that. Version 0.9.8 and later automatically adds such an entry so you will only need to select it.

"301 Moved Permanently" error when trying to download

The OpenStreetMap API server you are using is likely redirecting http (non-encrypted) to https (encyrpted) connections. Try changing the API configuration to use https.

What can I do with the editor?

Currently, you can

and much more.

Does Vespucci support OSM Notes?

Yes, Vespucci supports manual and automatic download of Notes and offline storage of them, further it supports displaying and editing warnings produced by the OSMOSE quality assurance system. OpenStreetBugs is no longer supported.

What are the limits of Vespucci?

Some things missing at this point in time

Remember, Android is intended to be lightweight and easy-to-use.

Which languages are supported?

The user interdace is currently available in: English, German, Chinese (Taiwan), Spanish, Ukranian, Russian, Turkish, French, Italian, Vienamese, Chinese, Icelandic, Greek, Portugeses and Janpanese. These translations are typically complete or only have a small number of terms missing.

We also have partial translations for a number of other languages (please see link to transifex below for the current status). Any help in this area would be gratefully received. Please see .

How can I download OSM data?

On the first time startup, Vespucci requests which area to download. You can choose from the following options:

For all download options, the additional parameter "Radius" is used. It specifies how large the downloaded area is. (In detail: Radius is half the side length of the bounding box that is used when downloading.)

You can alternatively dismiss the dialog, zoom and pan to the area in question and then select the "Download current view" from the transfer menu.

How can I upload new/changed data to the OSM server?

Choose "Upload data to OSM server" from the transfer menu. (With other words: Data is not automatically uploaded!)

Which user account is used when uploading data to the OSM server?

Vespucci will use OAuth authorization as default for new installs. On your first upload you will be directed to an OSM page that we ask you to authorize your Vespucci install. It is not necessary nor recommended to store username/password on your device (it is however possible if OAuth causes problems for whatever reasons).

Note: OAuth will work for both the standard API and the development servers, if you are running your own or need to access a third party site with OAuth you need to add the corresponding secrets to the API configuration and rebuild Vespucci.

How can I zoom into an area?

Conflict resolution

vespucci has a built in conflict resolution capability. If you want finer grain control over the resolution process you can export all your changes to a .osc file, open that with JOSM and use JOSMs conflict resolution capabilities.