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 GPX 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 can I do with the editor?

Currently, you can:

... see Vespucci feature list for 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:

Which languages are supported?

The user interface is currently available in: English, German, Chinese (Taiwan), Spanish, Ukrainian, Russian, Turkish, French, Italian, Vietnamese, Chinese, Icelandic, Greek, Portuguese, Japanese, Hebrew, Hungarian, Polish and Czech. 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). If the translation for your language is incomplete or missing, please feel free to request the language on Transifex and start translating. Any help in this area would be gratefully received. Please see Vespucci's Transifex page to help.

What is the status of Vespucci development?

We typically provide monthly updates to the released version (bug fixes and updated presets and imagery configurations), minor releases roughly every quarter and major release once to twice a year.

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

How can I install Vespucci on my Android device?

Just download and install like any other app =)

Which special permissions does Vespucci require?

How can I install Vespucci on the Android emulator?

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

Using third party builds of Vespucci

If you have a third party build of Vespucci installed (for example from F-Droid), that is you haven't obtained the app from google, Amazon or directly from our github repository, you need to be aware that certain functionality will be disabled because of missing API keys, in particular:

will not be available.

Removing the Bing imagery layer

Due to an implementation detail, once per session a metadata call will be made to the Bing servers, potentially leaking some minimal information (IP address, and the fact that you are using Vespucci to edit OSM). You can remove the Bing API key which will disable the Bing source and the behaviour with the following steps:

Note that this can only be reversed by either you providing a new Bing API key, or completely removing Vespuccis data directory.

Using Vespucci

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 uses OAuth authorization by default for new installations. On your first upload you will be directed to an OSM page where you will need to grant Vespucci permission to use your OpenStreetMap account. 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 OSMF-operated 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?

How can I add a custom (aerial/satellite) imagery layer

The preferred method is to add your imagery source to the Editor Layer Index so that it can be used by all OpenStreetMap editors.

From 10.1 on, the "Advanced preferences" contain an option to add custom imagery via a form, however adding to the ELI is still preferred. You can update the complete configuration at any time by selecting the corresponding menu entry in the Tools/More imagery tools... menu. Note if you prefer to use JOSMs imagery configuration you can update from that source in the same place.

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 .osm file, open that with JOSM and use JOSM's conflict resolution capabilities.

Support and help

Where to get help

Most content from this web site is available on your device. Many of the menus contain a Help entry that will display useful information for the current context. You can start the help browser stand alone (long press on the Vespucci icon in your launcher) and on modern Android versions use split-screen mode to display the contents in parallel with the editor.

If you cannot find an answer in the help system, feel free to open an issue on our github repository via the Provide feedback item in the main menu.

Why can't you provide technical support on the google play store review section

The google play store allows only one reply to a review with a maximum length of just 350 characters. If you believe that what you are experiencing is a clear malfunction please open a new issue on github, if you have questions or can't find how do a specific operation you can ask on the OpenStreetMap help site or one of the other OpenStreetMap communication channels.

350 characters is 100 characters less than the text above.

Error messages and other issues

Vespucci warning that it cannot write to an external SD card

Vespucci preferentially attempts to store aerial imagery data on an external SD card if present, this is slower but leaves expensive internal storage free. On some devices this seems to cause persistent issues that are not resolved by giving the app permissions to write to external storage. A potential workaround is to remove the SD card (if this works in your setup), and then run Vespucci. If that works and background imagery is displayed you can reinsert the SD card and Vespucci should continue to use the internal storage.

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 "" as API URL) and select that. 0.9.8 and later versions already have such an entry, you only need to activate it.

Note that the same issue may apply to certain background and overlay layers.

"301 Moved Permanently" error when trying to download

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

I've downloaded data, but the screen remains blank

There are a number of potential reasons for this, all of them harmless:

OAuth authorization fails

If OAuth authorization fails, for example with a blank screen, you may need to disable any ad blocker you have installed during the authorization process. For example Blockada is known to cause issues, but any blocker that uses Easylist will likely have similar problems, see discussion on Easylist repo for some background.

Can't enter key with MessageEase

When word prediction is turned on in MessageEase it causes issues entering text for keys in the "Details" tab, disabling word prediction allows it to work.

Why do I have to have GPS turned on?

You don't. You can return to the app and continue working by pressing the back button when the system asks you to turn on GPS (location based functions will not work).

The reasoning behind this is that we assume that typical use is an on the ground survey and that you will want your current position to be displayed on the map. As a result the standard behaviour is to ask you (once) on start up of the app to turn GPS on, you can however disable this in the "Advanced Preferences" in the GPS section, by setting the "Leave GPS off" preference.

The translation for language X is incomplete or wrong!

Vespucci is a community developed, open source, project. While not everybody will be able to contribute to the code, everybody should be able to work on the translations on transifex. Translations in the app are updated typically once a month.

The translation for the presets is broken!

The preset translations tend to be a work in progress and given that a large number (over 2'300) of terms have to be translated, many are incomplete. From Vespucci 12.0 on you can disable the use of translations per preset, a long-click on the respective preset entry in the preset preference screen will allow you to change the behaviour.

Presets for military objects are missing!

Due to the touchy situation having pre-defined presets for military objects on device could create you need to download them and install them yourself. You can find a link at the bottom of the preset help page.

Fullscreen mode doesn't work properly

Fullscreen mode on Android is a bit hit and miss (depending on Android version and device) as it is really designed for games and for apps without keyboard use. If the Android buttons are hidden, the standard Android way to show them, at least in recent Android versions, is a swipe from the bottom edge.

If fullscreen mode is causing issues for you, the best solution is to simply turn it off in the Advanced preferences.

The aerial or satellite imagery is out of date

Vespucci uses the Editor Layer Index for configuring the available backgrounds. The contents cover essentially all imagery that can legitimately be used for OpenStreetMap purposes. If you believe the imagery for a specific region is out of date or there are better sources you should preferably update the ELI or open an issue there.

On startup Vespucci complains that it can't write to a directory or reports an error

Vespucci stores downloaded background and overlay tiles in a database that it tries to create on removable storage if present, this to preserve space on your device at the expense of access potentially being a bit slower.

If the app can't write to the database it will show a message and will not display any background layer.

To recover from the directory containing the tile database not being writable you do not need to re-install Vespucci, simply clearing the apps data in your application manager is enough. If the problem is related to access to a removable storages, disabling the "Prefer removable storage" in the "Advanced preferences" "Layer download and storage" section may help.

While rare, now and then the database holding the background tiles can become corrupted, for example by a sudden power loss.

To resolve you can clear all the data for the app (upload any pending changes before that), or you can try to simply remove the database file,. The location is typically (on removable storage or on the internal "sdcard") in Android/data/ remove osmaptilefscache_db.db and the accompanying journal file too.

Can't save MapRoulette API Key

If you have an existing Vespucci installation you may have to re-authorize the application by going to "Tools" - "Authorize OAuth" menu. This is due to a change in the OSM API that occured after the release of the support for MapRoulette.

Android 9 introduced the option to replace the navigation bar at the bottom of the screen with gestures, these were further refined with the release of Android 10. If you have this enabled you will notice that this conflicts with the menu bar at the bottom of the screen used by Vespucci.

There is no completely satisfactory solution to this, but if you don't want to disable the gestures the best setup is to change the following settings in the Advanced preferences user interface settings:

Vespucci 15.0 and higher will detect that gestures have been enabled and will try to configure itself appropriately.

Long press on Undo button doesn't do anything

This most likely due to you having navigation gestures configured, but the app not being able to detect this. For example this has been the case with devices running the /e/ variant of Android. Switching Fullscreen mode to never in the Advanced preferences should allow the Undo button to work as intended.

Can't (re-)authenticate - TLS 1.0 / 1.1 issues

Many sites have turned off support for TLS 1.0 / 1.1 secured connections, this includes the API on This renders Vespucci on devices with an Android version older than 4.1 essentially useless.

On Android versions between 4.1 and 4.4 the app can be used without issues, except that authorization with OAuth will potentially not work. If you are unable to use OAuth you can still simply authenticate with login and password. To enable this:


Vespucci is getting slower and slower

Adding more data via the auto-download facility and/or the menu item "Add current view to download" increases the amount of the data retained in memory. Due to the way Android works this has to be saved and re-loaded in a number of situations, including, naturally, on restart of the app. Further certain operations that need to select a subset of the data in memory can be impacted by this slow down too. In current versions of Vespucci data downloaded by the auto-download facilities will be automatically pruned if possible, but particularly zooming far out will make this less effective.

Recommended practice if you no longer need the previously loaded data and have uploaded all edits, is to reset the data in memory by using the "Clear and download current view" action, or manually (by using the corresponding entry in the menu for the data layer) start the prune process.

Running Vespucci on "old and small" devices

Modern (0.8 and up) Vespucci versions have been tested and found to work on Android 2.3 (2.2 was last supported in version 0.9.8) 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):

The location dependent tagging and validation feature is not available on such devices as it alone requires 4MB of heap.

Rendering is very slow

Rendering multi-polygons is quite complex, and the default style for these is quite computationally expensive and will be slow on older devices. Try switching to the data style without multi-polygon to improve this. See preferences.