Mapbox

简介

Mapbox 是完整的地理空间平台：矢量瓦片、静态地图、地理编码、路线规划、搜索等。每个请求都需要 Mapbox access token（免费层带月度请求额度——实测：无效 token 返回 401）。是网页和移动应用的主流地图技术栈。

快速开始

地理编码（替换 YOUR_TOKEN）：

curl "https://api.mapbox.com/geocoding/v5/mapbox.places/paris.json?access_token=YOUR_TOKEN"

静态地图图片：

curl "https://api.mapbox.com/styles/v1/mapbox/streets-v12/static/2.35,48.85,10,0/600x400?access_token=YOUR_TOKEN"

路线规划（驾车）：

curl "https://api.mapbox.com/directions/v5/mapbox/driving/2.35,48.85;2.29,48.87?access_token=YOUR_TOKEN"

认证方式

• 在 mapbox.com 创建账号 → 控制台 → 默认公开 token（或按应用创建 scoped token）。
• 通过 access_token 查询参数携带。
• token 设计为可嵌入客户端（可限定 scope 且可撤销）——但仍建议按应用限定。

速率限制与注意事项

• 免费层：50,000 次地图加载/月 + 各服务请求限额（地理编码、路线等）——以定价页为准。
• mapbox.places 地理编码器是标准正向/反向地理编码 API。
• 静态地图、瓦片和样式是独立产品，各有自己的端点——都需要 token。
• 用量按服务计量；超额需要付费套餐。

常见问题

Mapbox 免费吗？ 有免费层（50k 地图加载/月 + 服务额度）；超额付费。

需要 token 吗？ 是的——每个 Mapbox 请求都需要 access token（无效 token 返回 401，已实测）。

可以把 token 嵌在网页应用里吗？ 可以——Mapbox token 设计为客户端使用；请按应用限定 scope。