Uploading with mapillary_tools command line tool

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

Take me to the Github repository!

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; a link to the readme is here. We suggest you read through it in its entirety to understand the full scope of mapillary_tools.

The readme will walk you through downloading the package, standard commands, advanced commands, and storing your user credentials. Examples are also provided. The readme 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.  

After reviewing the readme, you should be all set to upload imagery to Mapillary via the command line!

Tip: mapillary_tools [command] --help will show you all available parameters for the specified command.

Troubleshooting mapillary_tools

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

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