mapillary-dl
CLI tool to bulk-download street-level imagery from Mapillary fast. You can define a bounding box or pick a city, and it discovers and downloads every available image of that area, with GPS embedded in EXIF, resumable downloads, and a SQLite-based cache for easy re-runs and fault resistance to interruptions.
This tool was spun off from CityZero, where its original commit history can be found.
Install
pip install mapillary-dl
Setup
You'll need to get a client token from mapillary.com/dashboard/developers and export it:
export MAPILLARY_CLIENT_TOKEN=MLY|...
Usage
# Interactive mode — pick a city, then download
mapillary-dl
# Specify a city directly
mapillary-dl --city "San Francisco"
# Custom bounding box
mapillary-dl --bbox "-122.52,37.70,-122.35,37.83"
# Limit images (useful for testing)
mapillary-dl --city "New York" --limit 100
# Show available cities
mapillary-dl --list-cities
Options
| Option | Description |
|---|---|
--city NAME |
Download from a predefined city |
--bbox W,S,E,N |
Custom bounding box |
--limit N |
Cap the number of images to download |
--output-dir PATH |
Output directory (default: <city> or bbox# in current directory) |
--preview |
Open an interactive map in the browser before downloading |
--state STATE |
Resume behaviour: maintain | merge | rediscover |
--granularity 1-100 |
Discovery thoroughness (default: 25) |
--list-cities |
Show predefined cities and exit |
Discovery states
When a previous run exists for a city:
| State | Behaviour |
|---|---|
maintain |
Load from cache, skip API (default) |
merge |
Re-discover and add new images to existing cache |
rediscover |
Wipe cache and run a full fresh discovery |
1 maintainer
Metadata
1 maintainer
Release files for mapillary-dl 0.1.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mapillary_dl-0.1.9.tar.gz | 17.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mapillary_dl-0.1.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.6 kB
Release files / mapillary_dl-0.1.9.tar.gz
| Download URL | mapillary_dl-0.1.9.tar.gz |
|---|---|
| Size | 17.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ef39c8a03b040d38c6558a3635fab4cef8993be08aba9c885b7e004ceeb9936
|
|
BLAKE2b-256 checksum How to use checksums |
8bc7f94c62d17a28f54671477b71888866f1d3337041e404d63d237f94eea64e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.20
|
Release files / mapillary_dl-0.1.9-py3-none-any.whl
| Download URL | mapillary_dl-0.1.9-py3-none-any.whl |
|---|---|
| Size | 18.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc66567f6681944e3d9bec9fb4c34e6eadce10f7feb29e6291bfb6c33d846a9c
|
|
BLAKE2b-256 checksum How to use checksums |
0207116449a00cf2012f64dd324c395fd57d6313c6ae2fe7da8bfe4f5a046bf8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.20
|
