JOSM/Plugins/Mapillary

From OpenStreetMap Wiki
Jump to navigation Jump to search
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].

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

  1. open in the main menu Edit › Preferences…, or alternatively use the keyboard shortcut F12
  2. In the tab named Plugins there is a Mapillary tab

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

  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. Make sure to activate Edit mode in the Data menu
  5. 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
  6. 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.


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.

Development

References