Mapillary API（提供街景图像与街道级别地物图像服务与定位参考）
2025年10月14日 09:49

GISBox是一站式三维GIS数据编辑、转换、发布平台，支持OSGB/GEOTIFF/RVT等多种GIS格式编辑，转换为3DTiles/Terrain等并发布。

简介

Mapillary API 是一个允许开发者访问 Mapillary 众包街景平台数据的接口，支持获取地理标记照片、视频及交通相关信息‌。通过该接口，开发者可以集成街景数据到应用中，用于地图服务、交通分析或计算机视觉任务‌。其功能包括图像检索、元数据查询及与目标检测模型（如评估指标AP/mAP）的协同应用‌。该API主要服务于需要大规模街景数据的技术场景，例如自动驾驶或智慧城市项目‌。

 

文件结构

Mapillary API 的文件结构主要包括以下核心组件：

  1. SDK 核心库：包含原生动态库（如 .a 或 .so 文件）及基础 API 接口，用于地图加载、数据解析和交互功能。
  2. 资源文件：存储图标（如 symbols 配置中的 image 或 character 字段）、样式表（JSON 格式）及默认地图素材。
  3. 模板与示例：提供快速集成的工程模板（如View-based应用模板）和示例代码（如MapViewer实例），覆盖基础功能实现。
  4. 文档与元数据：包含 API 参考文档（HTML/PDF）、版本说明及架构定义文件（如 mapfile.json 用于验证配置有效性）。
  5. 依赖项与工具：集成第三方库（如地理编码工具）和开发工具链（如调试工具、模拟器配置）。

优点

  1. 众包数据优势：依赖全球用户上传的街景图像和视频，覆盖范围广且更新频繁，适合需要实时或多样化地理数据的应用‌。
  2. 开放性与集成能力：支持OAuth 2.0授权，提供Access Token机制，便于开发者集成到第三方平台（如WebGIS或移动应用）‌。
  3. ‌技术生态支持：与开源工具（如OpenSfM）深度结合，支持结构重建（SfM）和地理对齐，适合三维场景重建需求‌。
  4. 隐私友好设计：相比谷歌街景，其众包模式更注重用户隐私控制，数据上传可选择性公开‌。

缺点

  1. 依赖用户贡献：数据质量受限于用户上传内容，可能存在覆盖不均或低分辨率问题‌。
  2. API复杂度：需处理授权流程（如OAuth 2.0）和令牌管理，对新手开发者有一定门槛‌。
  3. 功能局限性：缺乏高级地图定制功能（如Apple MapKit的混合样式或高程渲染），可视化灵活性较低‌。
  4. 成本与稳定性：企业级API可能面临高成本风险，且众包数据更新可能导致接口响应波动‌。

应用场景

Mapillary API主要应用于众包街景数据采集与可视化，支持开发者集成实时影像地图到物流导航、城市规划或旅游服务中‌。其与开源工具（如OpenSfM）结合时，可辅助三维重建和地理对齐，适用于自动驾驶环境建模或生态监测‌。此外，通过机器学习标记路标的功能，能提升商业地图（如房地产展示）的交互体验‌。该API的众包特性使其在覆盖偏远地区或更新高频场景（如灾害评估）中更具灵活性，但需依赖用户上传数据质量‌。

示例图

1. 街景数据集Mapillary Vistas Dataset。

2. 通过Mapillary对象检测。

 

文件打开方式

1. 把json文件导入mapshaper网站中可视化。  

相关 GIS 服务

Web 地图渲染服务 OGC API

切片地图服务

HERE Technologies

QGIS Cloud

参考资料

  1. https://baike.baidu.com/item/Mapillary?fromModule=lemma_search-box
  2. https://cloud.tencent.com/developer/article/1561020
  3. https://www.trekview.org/blog/playing-with-mapillary-api/
  4. https://blog.csdn.net/weixin_44797004/article/details/138773385