Uploading with Mapillary Tools for the command line

Depending on your use case, you may need additional processing and upload capabilities beyond those offered in the Desktop Uploader. Fortunately, Mapillary Tools for the command line offers additional settings which can handle more advanced uploads.

Why might I want to use mapillary_tools?

If you identify with any of the following scenarios, you'll likely want to upload via Mapillary Tools:

• You have large quantities of imagery or videos to upload (to an individual or organization account)
• to geotag images in less clicks than the Desktop Uploader
• You'd like to ignore duplicate images in a batch (e.g. for when the camera has stopped moving, like when waiting on traffic lights)
• You'd like to split sequences by a custom distance or capture time delta
• You'd like to set a custom sampling distance for videos (control the distance between sampled images, the default is to extract an image every 3 meters)
• You need to set an offset time to synchronize .gpx and video file timestamps (e.g. if your GPS device and camera's clocks were not in sync)
• You'd like to filter your imagery by a specific bounding box before uploading
• You'd like to interpolate image directions 

Additionally, the mapillary_tools package can be imported into a Python file if you are interested in automating processing and uploading via Python or interested in using mapillary_tools alongside other packages.

Getting started with Mapillary Tools 

Full documentation for Mapillary Tools is available on Github.

The documentation assumes you have experience using the command line. If you do not have experience with command line, but believe your use case may require mapillary_tools, we suggest you familiarize yourself with the command line first. There are some great introductory videos on YouTube— search "[your OS] command line for beginners" and you should find plenty of tutorial options.  

Troubleshooting Mapillary Tools

If you have general inquiries regarding Mapillary Tools, please submit a support ticket to the Mapillary Help Center. 

If you have a feature request, or believe you have found a bug, submit an issue on Github.