Mapillary Vector Tiles API (从街景 /街道图像中提取矢量信息)
2025年10月15日 16:43
GISBox是一站式三维GIS数据编辑、转换、发布平台,支持OSGB/GEOTIFF/RVT等多种GIS格式编辑,转换为3DTiles/Terrain等并发布。
简介
Mapillary Vector Tiles API是一种提供结构化矢量地图数据的接口,它以高效传输的“切片”形式,向开发者提供Mapillary平台捕捉到的现实世界物体信息(如道路标记、交通标志、车道线等)的地理位置和属性数据。开发者可以利用这些精确的矢量数据来构建应用程序,例如增强现实导航、详细的地图分析或基础设施管理工具。
文件结构
Mapillary Vector Tiles API的文件结构主要基于矢量瓦片技术规范,其核心组成可分解为以下关键部分:
- 瓦片层级组织:采用标准的TMS/XYZ规范,将地球表面按缩放层级(zoom level)分割为256x256像素的正方形瓦片。
- 图层定义:每个瓦片包含一个或多个图层(Layer),用于分类存储不同地理要素。
- 要素与几何数据:矢量瓦片的核心是要素(Feature),每个要素包含几何形状(点、线、面)和属性数据。几何坐标采用Delta编码优化存储,属性数据以键值对形式存储,支持要素级交互和筛选。
- 元数据扩展:瓦片头部包含元数据字段,如版本号、坐标系(通常为Web Mercator)、瓦片边界范围等。部分实现可能扩展自定义元数据,用于描述数据来源或处理时间戳。
- 动态样式支持:与栅格瓦片不同,矢量瓦片的文件结构允许客户端通过样式规则动态渲染要素。样式参数通常绑定到要素属性,实现同一图块的多主题可视化。
优点
- 街景数据深度集成:Mapillary API的核心价值在于其独特的街景数据支持,通过矢量瓦片层直接关联全球众包采集的街景图像。
- 实时更新机制:采用社区贡献模式的数据更新策略,其矢量瓦片服务能快速反映现实世界变化。根据官方文档,部分区域的更新频率可达小时级,远超传统地图服务商的周/月更新周期。
- 客户端样式灵活性:遵循Mapbox Vector Tile规范,支持在客户端动态调整图层样式。
缺点
- 数据覆盖不均衡:由于依赖社区贡献,其数据分布存在明显地域差异。
- 商业使用限制:免费API存在严格的调用配额(如每月50万次请求),超出后需购买企业级许可。
- 技术复杂度较高:需要开发者同时处理矢量瓦片和图像数据流,实现要素与图像的关联逻辑。
应用场景
Mapillary Vector Tiles API的应用场景主要集中在需要结合街景与矢量数据的垂直领域,例如智慧城市管理、交通设施巡检、自动驾驶测试以及AR导航等。其独特的街景数据集成能力允许开发者实现图像与矢量要素的联动交互,如点击道路要素时自动调取对应位置的街景快照,这在交通管理和城市巡检中具有显著优势。此外,其实时更新机制能快速反映现实世界变化,适合需要动态数据的应用场景,如应急响应和实时导航。客户端样式灵活性则支持自定义符号化表达,满足不同行业的可视化需求。
示例图
1. 利用MapTiler在网页上显示自定义地图。
2. 矢量图块API与Leaflet.VectorGrid集成。

文件打开方式
1. 映射矢量图显示都柏林市中心的图像覆盖率。
相关 GIS 服务
Web 地图渲染服务 OGC API
切片地图服务
HERE Technologies
OpenStreetView API
参考资料
- https://docs.maptiler.com/sdk-js/examples/custom-map/
- https://forum.mapillary.com/t/vector-tiles-integration-with-leaflet/5428
- https://blog.mapillary.com/update/2021/06/23/getting-started-with-the-new-mapillary-api-v4.html