JOSM/Plugins/Mapillary
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].
Instructions
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 mapillary.com 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 File
› Download Mapillary images in current view
, keyboard shortcut Shift
+ .
)
Go to Mapillary settings
- open in the main menu
Edit
›Preferences…
, or alternatively use the keyboard shortcutF12
- In the tab named
Plugins
there is a
tabMapillary
Login
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 mapillary.com
Preconditions: You have one or more layers holding geotagged images (PhotoLayer) open
- Make sure you are logged into your Mapillary account with JOSM (see #Login)
- Click on
Import images
in theFile
menu and then onFrom existing image layer
. Select the image layer you want to import to the Mapillary layer. - Activate the Mapillary layer (green checkmark in front of the layer).
- Make sure to activate
Edit mode
in theData
menu - 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. note this is broken at least on the windows version - When you are ready, select the images you want to upload and click
File
›Upload Mapillary images
. Double-click an image to select the whole sequence.
![]() | The following parts are not necessarily up-to-date and need rework. |
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 select more than one image:
- Double click to select the whole sequence.
Below options are broken, at least on windows JOSM - aka not working in the current version
- 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 them 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.
Filter
You there is a new button button in the left side bar. It will open a new dialog that lets you filter the images depending 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.
Upload
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.
Versions
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.