Using an iPhone with the Mapillary app

Mapillary for iOS lets you capture, upload, and explore images with your iPhone and get an overview of your Mapillary profile activities. You can also connect to external cameras like action cameras or 360° cameras (using one camera or several at a time).

Recommended Devices

iOS mobile devices that are compatible with the Mapillary for iOS app include:

• iPhone Xs
• iPhone Xr
• iPhone X
• iPhone 8
• iPhone 7
• iPhone 6s

First time iPhone setup

Equipment needed

• Recommended iPhone Device with Mapillary app
• Mobile/car charging cable or portable charging pack
• Device mount

Device setup

1. Download the Mapillary app from the App Store.
2. Open the app and tap Sign up to create a new account, or Sign in if you have an existing account.
3. Tap Facebook, Google, email, or OpenStreetMap to create a Mapillary account or sign in with your existing account.

Mounting

1. Mount your iPhone phone inside of your car, in the middle of the windshield, below your rearview mirror.
2. Mount your phone in a way that captures a full view of the street, while avoiding too much of your car hood, the sky, or the ground in the image.
3. Make sure all mounts are tightly secured prior to beginning your drive.

Capture Mapillary imagery using iPhone

1. Open the Mapillary App and tap  (capture).
2. Hold or mount the device horizontally, using the bar in the middle of the screen to keep the phone level.
3. The app captures in automatic, distance-based mode by default. This means that the app automatically takes images when you’ve moved a certain distance (based on your phone’s GPS) or rotated your device a certain degree (based on your phone’s compass).
4. Alternatively, you can set the automatic mode to be time-based instead by tapping  (settings). You can also set your phone to manual mode using  (automatic/manual mode) and tapping  (manual capture) to take every image.
5. You can use  (compass angle) to change the angle at which the phone captures images. The angle can be a fixed direction or change based on the phone’s compass. For greater accuracy, we recommend using a fixed direction which is enabled by default.
6. Tap  (start capture) on the right to start and start moving with the phone to capture images. The app will capture automatically as you move.
7. Once you begin capturing, you can tap  (manual capture) to take an extra image, in addition to the images being captured automatically.
8. Tap  (map) to access a map that tracks your current location to help you navigate. This map does not have a guidance instruction feature.
   • Note: you cannot run the camera in the background for privacy reasons. Therefore, if you want to use a navigation app simultaneously with Mapillary, start the navigation app first and then start Mapillary. You will get notifications and audio from the navigation app while capturing.
9. When you feel like you’ve captured enough images, tap  (stop capture). This ends your capture session and collects the images into one sequence. You may capture multiple sequences without exiting the capture screen. You may take as many sequences as you like without exiting the camera screen.
10. Once you stop capturing, you will be taken to the upload screen. We recommend connecting to wifi prior to initiating an upload. See the link below for next steps on how to upload.

Note:

• Best practices for capturing:
• Avoid capturing at night and when it is actively raining or snowing.
• Avoid capturing too much of your vehicle hood, the sky, and the ground.
• Be sure to fully charge your device before capturing and charge it throughout the duration of your capture session.
• You cannot run the camera in the background for privacy reasons.
• If you want to use a navigation app simultaneously with Mapillary, you can start the navigation app first and then start Mapillary. You will get notifications and audio from the navigation app while capturing.

Upload Mapillary imagery from iPhone

1. Be sure to first plug your phone into a charger and connect it to wifi. 
2. Access the Upload screen by tapping “Upload” at the bottom of the screen or by exiting capture mode after capturing images.
3. Tap any list item to see the images captured in that sequence. Tap on the "Select" option to be able to select multiple images that you want to save on your camera roll, edit, delete, or approve for upload.
• NOTE: If you have not marked any images as “approved” and tap the upload button, it will automatically upload all images.
4. If you press the upload button when viewing a sequence, the app will upload that particular sequence (not others).
5. If you need to delete a whole sequence, swipe the sequence to the left in the main upload screen where the sequences are listed. If you need to delete a whole sequence, swipe it to the left in the main upload screen (where you see the list of sequences). If you tap the upload button on this screen, uploading of all (approved) images will be requested.
6. Keep the app running in the foreground for uploading. If you put it in the background, the upload will stop.
7. The app will automatically upload all images with the necessary geotags. Note that the images will be deleted from your phone after upload.
8. If you want to keep copies of the images or upload the images via the Mapillary Desktop Uploader instead of directly from the app, you must first add GPX tracks to images before uploading. The images and GPX tracks are saved as separate files so you need to do an extra step for adding geotags to the image files.
• Note: To add EXIF data to the images you want to make a copy of, there is a special button on the Upload screen. After tapping the "Add EXIF data" button, the images will be processed and you can copy them to your computer as instructed here.

Upload iPhone imagery using other methods (optional) 

• Desktop Uploader
• Command Line Tools