From OpenStreetMap Wiki
Jump to: navigation, search
Available languages
Mapillary link showing the Mapillary Malmö office
Mapillary Global Coverage Jan 2015

Mapillary ( is a service for sharing geotagged photos developed by a startup, located in Malmö, Sweden. Its creators want to represent the whole world (not only streets) with photos [1][2]. They believe that for covering all interesting places in the world, there needs to be an independent, crowd-sourced project and a systematic approach to cover interesting areas. Services like Google, having especially equipped cars with camera mounts, are not going to be able to cover the world in sufficient detail [1]. According to them, the local knowledge is almost unbeatable, and people know what really matters in capturing a photo [1]. They are interested in coverage of any outdoor place and this can contribute to a system that represents the world with high level of detail [1]. Most of the "intelligence" of image processing is done on the server side using Big data technologies and computer vision, making the data collection super simple for the user. As a result, Mapillary will improve with each new photo since all new photos are related to any existing photos in the vicinity. Here is a short presentation [3] for a brief technical overview. The idea is that the users of the data are empowered to increase coverage in areas that interest them [1]. The developers of Mapillary believe there is a place in the market for a provider of neutral and independent pictures [1][2]

The contributors can install the Mapillary app on WindowsPhone, Android or iPhone, there are successful reports from even Kindle App Store, Jolla and Blackberry devices that can run Android apps. After registration, the user can start taking photos.

At developer resources, the JSON API is documented, including an embeddable Widget.

Mapillary Examples

The Mapillary Workflow

Data collection

Screenshot of the Mapillary Android app in Camera mode
Capturing photos with an Android phone
Useful kit to carry while mapping
Ready to map! (walking)

The application for data collection is virtually the same in Android or iPhone. However, due to Android supporting background services it is possible to automatically send your photos whenever a network WiFi is connected without the user actively caring about it. You can also view and share Mapillary places from within the app.

The data collection can also be made using a traditional camera (without a GPS chip), but will need to correlate photos location manually using a GPS track.

Capturing modes

  • Walking (hiking) - manual and sequence capturing; ideal for a foot walks, hikes and strolls.
    Try to collect photos that overlap.
    Try to capture the change of direction in overlapping frames while rotating around your axis slowly.
    For best quality pictures and gps position, hold device in front of you, frame shot, keep camera level, minimize shake.
    Longer duration walks (or cold weather) will require the device to be mounted to yourself e.g. jacket or rucksack harness. Ensure that the device is both secure (small plastic hair clips are useful) and level before starting to map. Discrete mounting is recommended while mapping in city or other heavily populated areas to avoid unwelcome attention.
  • Riding (bike / car) - shots every 2 seconds.
    Point the camera at the location in which you are going. Great for use with bike!
    If you are driving, make sure to panels, columns, etc. are not in view on the camera.
  • Panorama - when standing in one place, you want to capture views from all directions.
    Suitable for use in front of monuments, interesting buildings, at junctions or in a place that stands for beauty.
    Stand absolutely still at the same point while performing all catches of a "panorama".
    Be sure to take several overlapping pictures in sequence.

In either mode, taking pictures in phone landscape orientation (horizontal) is recommended in order to have a nice stitching experience. And remember: the capture mode selected will determine how the photos are processed, which rules and approaches are applied, improving the final result, especially the intelligent navigation. Using a smartphone connected to the Internet, it is also possible you know the photos that already exist to a certain place.

Preparing to Capture Images

  • Short (less than 30 mins)
    No special preparation required.
    Images will consume storage, so ensure you have enough free space on your device. An image taken on an Iphone5 will consume about 2 MB. In riding mode (2 sec), in 30 minutes, you will take about 900 pictures, about 1.8 GB.
  • Medium (30 - 60 mins)
    Consider deleting any unused apps, backup then delete old photos and videos, minimize music.
    Close all non-required apps or restart the device. This will minimize the chances that another app will interrupt the mapping session. On IOS double click the home key and swipe up to close apps.
    Images will consume storage, so ensure you have enough free space on your device. An image taken on an Iphone5 will consume about 2 MB. In riding mode (2 sec), in 60 minutes, you will take about 1800 pictures, about 3.6 GB.
    If outdoors, use an ear piece. This gives you the confidence (with the shutter click) that pictures are being taken. It is possible to listen to music (or your favorite radio station via app) while mapping.
    Attach an external power supply, Depending on the health of your device battery, without an external source, you may have nothing or very little left at the end of a 60 minute session.
    Most devices will automatically backup to the cloud. Mostly this is not required for Mapillary pictures, so you should deactivate this app from backups (in IOS go to system settings > icloud > storage > your iphone > show all apps).
  • Long (longer than 60 mins)
    If you receive regular calls, consider an alternative to put your sim card while mapping.
    Consider carrying a download device (laptop) in order to extend mapping range. A typical 16 GB Iphone5, with only bare minimum apps and other files will not allow more than 5500 pictures (3 hours).
    Consider carrying an external GPS (or car satnav) if traveling in new areas. This will allow you to plan your route and ensure you do not get lost.

Image processing (traditional cameras only)

In order to store location information directly in your photos (in EXIF metadata), you can use JOSM (see Photomapping In JOSM#Arranging photos on a GPS trace).

If your camera time is not synchronized (and not adjustable), you can edit photo timestamps with this procedure (under Linux, with jhead and exiftool) :

  • jhead -da2015:02:14/15:30-2014:08:18/01:41 *
    • This command changes the photo time stamp, the syntax for the date is newdate-olddate.
  • jhead -ft *
    • This command copies the new photo time stamp from EXIF meta-data into file meta-data
  • In JOSM, do the GPS correlation
  • exiftool -Orientation=1 -overwrite_original -n *
    • This command create an empty field for photo orientation in EXIF meta-data.

Editing content


Any logged-in user can edit all public content. The basic actions are

  • Correct lon/lat
  • Correct compass direction of images or all images in a sequence
  • Edit location info
  • Hide images or whole sequences
  • Request [4]blurring or un-blurring for parts of images

All changes are approved by the Mapillary team before being applied.

Traffic sign recognition

A traffic sign recognition algorithm has processed the Mapillary images in the United States and in Europe[5]. To view the results, point the browser to any Mapillary image, click on the filter button in the lower left corner and enable the traffic sign filter.

If incorrectly marked traffic signs are spotted, feedback can be given by enabling a traffic sign mode when logged into Mapillary [6]. You can also provide feedback when you click on the box around the detected traffic sign in the Mapillary image. The traffic sign can then be changed in the dialog.


The images on Mapillary can by used under Creative Commons Attribution-ShareAlike 4.0 International License (CC-BY-SA).[7] There is special permission to derive data from the photos for contributing to OpenStreetMap. The GPX tracks can be used without restriction.

The license was changed on 29 April 2014 from CC-BY-NC to CC-BY-SA. [8]


  1. 1.0 1.1 1.2 1.3 1.4 Welcome to Mapillary! (en), by Jan Erik Solem. Posted on 1 Jan 2014.
  2. 2.0 2.1 Mapillary Manifesto (en), by Jan Erik, Johan, Peter and Yubin (a.k.a the Mapillary team).
  3. Technical Overview (en) by Peter Neubauer
  4. [1]
  5. "Traffic Sign Recognition". 2015-01-27. Retrieved 2015-03-15. 
  6. "Traffic Sign Recognition Feedback". 2015-02-11. Retrieved 2015-03-15. 
  7. [2]