Go to file
2023-10-14 13:19:50 +02:00
doc Add some documentation 2023-09-20 22:10:06 +02:00
hooks Add hook for building linux bin 2023-09-21 22:25:39 +02:00
.gitignore update gitignore 2023-10-08 09:19:38 +02:00
for_futur_me.txt Add hook for building linux bin 2023-09-21 22:25:39 +02:00
mapillary_download.py fix metadata when camera_type is equirectangular 2023-10-14 13:19:50 +02:00
model.py Switching to pyexiv2 2023-09-12 14:31:10 +02:00
README.md update readme 2023-09-21 21:43:58 +02:00
requirements.txt update requirements 2023-09-21 21:11:42 +02:00
writer.py use new metadata for offset localize 2023-09-18 22:16:07 +02:00

mapillary_download

Simple code to download images in one or several mapillary sequences. The images will be geotagged and oriented.

How to use

change the access token with your access token and the sequence ids with the ids of the sequences you want to download

python mapillary_download.py "MLY|xxxx|xxxxxxx" --sequence_ids xxxxxxxxxxx xxxxxxxxxxx

Available arguments

python mapillary_download.py -h
usage: mapillary_download.py [-h] [--sequence_ids [SEQUENCE_IDS ...]] [--image_ids [IMAGE_IDS ...]] [--destination DESTINATION]
                   [--image_limit IMAGE_LIMIT] [--overwrite]
                   access_token

positional arguments:
  access_token          Your mapillary access token

optional arguments:
  -h, --help            show this help message and exit
  --sequence_ids [SEQUENCE_IDS ...]
                        The mapillary sequence id(s) to download
  --image_ids [IMAGE_IDS ...]
                        The mapillary image id(s) to get their sequence id(s)
  --destination DESTINATION
                        Path destination for the images
  --image_limit IMAGE_LIMIT
                        How many images you want to download
  --overwrite           overwrite existing images
  -v, --version         show program's version number and exit

How to get my access token

  • Go to https://www.mapillary.com/dashboard/developers

  • Click on "Registrer Application", enter the needed informations, enable the application to "Read" data, then click on register :

    register application

  • When this registration is done, click on "view" in the token column. This is you access token :

    token

How to get my sequence id (or sequence key)

  • Go to https://mapillary.com/app

  • Click on one of the picture of the sequence you want to download

  • Click on the "image option" button (right panel)

  • Click on "advanced" then click on the sequence key to copy it in the clipboard

    snapshot

How to install the script with a virtual environnement

cd ~
git clone https://github.com/Stefal/mapillary_download.git
cd mapillary_download
python3 -m venv mly_venv
source mly_venv/bin/activate
python -m pip install -r requirements.txt

Then you can run python mapillary_download "MLY|xxxx|xxxxxxx" --sequence_ids xxxxxxxxxxx When you're done with the script, simply run deactivate to exit the virtual environnement.

On windows you can create a virtual environnement too, or use the prebuilt mapillary_download.exe available on the release page.