From OpenStreetMap Wiki
< JOSM‎ | Plugins
Jump to: navigation, search
Available languages — JOSM/Plugins/Mapillary
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português português do Brasil română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް
Mapillary icon Mapillary
A plugin to integrate mapillary with JOSM

A JOSM plugin for viewing and modifying images from Mapillary as well as uploading new images to the website. It was developed as part of the Google Summer of Code 2015[1][2].


Open Mapillary layer

Open the Imagery menu and click the Mapillary entry at the bottom (or keyboard shortcut Shift + ,). This downloads and shows sequences from on the map.

At all times there is only one Mapillary layer. If you try to repeatedly open the Mapillary layer, JOSM will toggle the active layer between the Mapillary layer and the OSM data layer instead of opening more Mapillary layers.

By default only sequences are displayed that cross through the area for which you have downloaded OSM data. This can be changed in the Mapillary preferences (see section #Go to Mapillary settings), there is a dropdown to select the download mode.

The alternative download modes are everything in the visible area (download all sequences in the visible map area when zooming and/or panning) and only when manually requested (download only when clicking FileDownload Mapillary images in current view, keyboard shortcut Shift + .)

Go to Mapillary settings

  1. open in the main menu EditPreferences…, or alternatively use the keyboard shortcut F12
  2. In the topmost tab named Display settings there is a Mapillary logo.svg Mapillary tab


Go to the Mapillary preferences (see section #Go to Mapillary settings). In the top right corner you can see if you are already logged in and a Login button to log in or log out of your Mapillary using OAuth 2.0 protocol.

Upload images from a "GeoImage layer" to

Preconditions: You have one or more layers holding geotagged images (PhotoLayer) open

  1. Make sure you are logged into your Mapillary account with JOSM (see #Login)
  2. Click on Import images in the File menu and then on From existing image layer. Select the image layer you want to import to the Mapillary layer.
  3. Activate the Mapillary layer (green checkmark in front of the layer).
  4. You can move the images around with Click and drag and rotate them with Shift-click and drag. Select multiple images to change them simultaneously.
  5. When you are ready, select the images you want to upload and click FileUpload Mapillary images. Double-click an image to select the whole sequence.

Select an image

Click on its icon. Then the image will be shown in the lateral dialog. If there is no dialog, a new button should be on the left bar. If you click on it the dialog will show. There are also multiple ways to selecte more than one image:

  • Double click to select the whole sequence.
  • Ctrl+click to add a single image to the selection.
  • Shift+click to select a range of images.

Delete an image/images

Select an image or a set of then and then press DEL key. This will delete them from the map.

Export images

In the file menu, there is a export images button. It will open a new window where you can choose what you want to export and when.

History dialog

Another toggle dialog on the left bar. You can see latest commands and revert them.


You there is a new button button in the left side bar. It will open a new dialog that lets you filter the images dependending on their origin and the signs they have.

Walk mode

New button in "More tools" menu. It allows the user to set an interval and the selected picture will move forward periodically.


You can upload to the Mapillary server a set of imported images. There is a new button in file menu. After it, you will have to go to a webpage in order to manually approve the push.


You can find an overview of the different revisions of the plugin over on GitHub.

It's generally recommended to use the latest version available.

Old versions

This box contains descriptions for very old versions that are not included in the version list on GitHub. Show the contents by clicking the switch in the top right corner.

Version 31606 (v1.0.3)

  • The plugin was being compiled with java 8 and it was causing issues when executing with java 7.

Version 31496 (v0.9.4) Version 31482 (v0.9.2)

  • Issues when uploading images taken with the Mapillary app

Version 31480 (v0.9.1)

  • During the upload, the progress was not being properly updated.

Version 31477 (v0.9.0)

  • Error in the history dialog when moving first an image, and then a set containing that image.

Version 31331

  • #11698, click on website button opens a html code editor (unconfirmed).
  • When downloading multiple times, several objects represent the same image.

Version 31317

  • #11591, livelock and other issues when downloading big areas.

Version 31282

  • #11581. Download view area button not always shown.
  • Bug when creating new ways. Related to the selection of pictures from the OSM data layer.
  • Time is shown in GMT +2 instead of GMT.
  • Infinite cache loop. Every cache petition created more petitions, but they where ignored.
  • Buttons are not updated if more pictures are downloaded.

Version 31275

  • #11576, related with location download
  • Problems when extending a sequence with another download.
  • Title bar of the picture dialog not changing when detached.

Version 31272

  • #11574 and #11573, related to download of huge areas.
  • Problems when extending a sequence with another download.

Version 31215

  • You will get an error if you open the Mapillary layer having other layers active but none of them being the OSM layer.
  • Using JOSM version 8339 is not supported, use latest instead.