Mapillary
Open street-level imagery platform from Meta for mapping and visual data.
Open the official app on www.mapillary.com
This tool is hosted by its maintainers. Click below to open www.mapillary.com in a new tab — it's their official demo.
Browse maps tools →What's next with Mapillary?
Choose how you want to get started.
Use it free
Open the official tool or demo — no account needed.
Self-host it
Run the open-source version on your own infrastructure.
What is Mapillary?
Mapillary is an open-source project designed to facilitate the upload and processing of geotagged images and videos for crowdsourced mapping applications. Developed under the MIT license, it enables users to contribute georeferenced media to create detailed street-level imagery datasets. The tool is primarily used by developers, researchers, and civic technologists who require structured access to geospatial data for projects involving urban planning, disaster response, or geographic analysis. By aggregating geotagged media from contributors, Mapillary addresses the challenge of creating comprehensive, publicly accessible street-level maps without relying on proprietary datasets. Its command-line interface allows for scalable automation of media processing and upload workflows, making it a valuable tool for integrating crowdsourced data into geographic information systems (GIS).
How it works
Mapillary is a command-line tool that uploads geotagged images and videos to the Mapillary platform, which hosts crowdsourced street-level imagery. Its primary purpose is to enable users to contribute media to geographic datasets, supporting applications like mapping, navigation, and spatial analysis. The tool is part of the Mapillary ecosystem, which includes a web-based platform for viewing and analyzing geotagged media. By processing and uploading media via the CLI, users can integrate their contributions into large-scale mapping projects without manual intervention. Mapillary_tools supports batch processing of geotagged media, allowing users to upload images and videos from directories. It handles file formatting, geolocation metadata, and API interactions with the Mapillary service. Supported formats include common image types like JPEG and PNG, as well as video files compatible with the platform's ingestion pipeline.
How to use it
- 1Install the tool via pip: `pip install mapillary_tools`.
- 2Prepare geotagged media in a directory, ensuring metadata includes geographic coordinates.
- 3Run the `process_and_upload` command, specifying the directory: `mapillary_tools process_and_upload MY_CAPTURE_DIR`.
- 4Verify uploads via the Mapillary web interface or CLI command listing: `mapillary_tools --help`.
What it can do
- street-level imagery
Use cases
Assumptions and limitations
Assumptions
- source: https://github.com/mapillary/mapillary_tools
- license: MIT — free to use
- privacy: Self-hosted — you control your data
Limitations
- Requires manual geotagging of media before upload, limiting automated data collection
- Depends on internet connectivity for processing and uploading media
- Limited real-time processing capabilities for large datasets
- No built-in tools for data analysis or visualization beyond the Mapillary platform
- May require additional software for advanced geospatial processing workflows
Understanding the result
Open street-level imagery platform from Meta for mapping and visual data.
Tool details
- Clearly flagged when a network request is needed.
- No account, no sign-up, and no tracking of your content.
- Powered by (MIT).
- Built with
- (mapillary/mapillary_tools)
- License
- MIT
- Runs locally
- No — requires a network request
- Verification
- Not yet verified
- Input
- Query
- Output
- Text
Built with mapillary/mapillary_tools. OpenToolVault provides the discovery and browser interface while crediting the original project maintainers.
- Built with
- License
- MIT
Open-source project
OpenToolVault is an independent directory. We are not affiliated with or endorsed by this project.
References
- / — GitHub Repository
Upstream project · GitHub
- MIT License
Upstream project
Frequently asked
What is Mapillary and how does it differ from other mapping tools?
Mapillary is a specialized tool for uploading and processing geotagged media to create crowdsourced street-level imagery. Unlike general-purpose mapping platforms, it focuses on aggregating user-contributed media for geographic datasets. It integrates with the Mapillary platform, which provides tools for viewing and analyzing the collected data, distinguishing it from standalone mapping solutions.
How does Mapillary handle geotagged media processing?
Mapillary_tools processes geotagged media by validating metadata, extracting geographic coordinates, and formatting files for upload to the Mapillary platform. It ensures compatibility with the platform's ingestion pipeline by standardizing metadata and file formats. The tool handles batch processing, allowing users to upload multiple files at once while maintaining geospatial accuracy.
How do I upload images and videos using Mapillary_tools?
To upload media, first install the tool via pip. Organize geotagged images and videos in a directory, ensuring they contain valid geographic metadata. Run the `process_and_upload` command followed by the directory path: `mapillary_tools process_and_upload MY_CAPTURE_DIR`. The tool will process the files and upload them to the Mapillary platform, where they can be viewed and analyzed.
How does Mapillary compare to OpenStreetMap or Google Maps?
Mapillary differs from OpenStreetMap and Google Maps by focusing specifically on crowdsourced street-level imagery rather than general geographic data. While OpenStreetMap relies on user contributions for map features, Mapillary aggregates geotagged media to create detailed visual datasets. Google Maps provides pre-rendered maps but does not offer the same level of user contribution for raw imagery. Mapillary complements these platforms by providing accessible, georeferenced media for specialized applications.
What should I do if my upload fails with an error?
Common upload errors include invalid file formats, missing geotags, or API rate limits. Verify that files are in supported formats (JPEG/PNG for images, MP4 for videos) and contain valid geographic metadata. Check the Mapillary API documentation for rate limit details. If issues persist, consult the tool's GitHub repository for troubleshooting guidance or seek support from the Mapillary community.