Google Maps

简介

Google Maps Platform 是一组用于嵌入地图和位置功能的 API：Maps JavaScript API（交互式地图）、Geocoding API（地址 ↔ 坐标）、Places API（搜索商家/POI）、Directions、Distance Matrix 等。

⚠️ 不是免费 API。 与本站大多数条目不同，Google Maps Platform 是按用量计费的。每次调用都需要项目密钥。具体价格以官方定价页为准——它会随时间变化。

快速开始

地理编码——把地址转成坐标（无效 key 会返回 REQUEST_DENIED）：

curl "https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway&key=YOUR_API_KEY"

响应的 status 字段是关键：OK、ZERO_RESULTS、OVER_QUERY_LIMIT、REQUEST_DENIED、INVALID_REQUEST。

认证方式

• 在 Google Cloud Console 创建项目，启用所需 API（Geocoding、Maps JavaScript、Places 等），生成 API 密钥。
• 建议按 HTTP referrer / IP 限制密钥，防止被盗用。
• 通过 key 查询参数携带（部分新 API 用 X-Goog-Api-Key 请求头）。
• 每个 API 独立计费；不用的 API 保持禁用，避免意外费用。

速率限制与注意事项

• 按请求按 API 计费；Google 给新账号提供每月免费额度（金额有变化——以定价页为准）。
• 地理编码有每个密钥的 QPS（每秒查询数）限制。
• 响应的 status 字段精确说明问题所在——错误处理时务必读取它。
• 本条目 auth 标记为 apiKey 反映了密钥要求；所有请求强制 HTTPS。

常见问题

Google Maps API 免费吗？ 不免费——按用量计费。Google 通常给新账号提供每月免费额度，之后按请求收费。

需要 API 密钥吗？ 是的——每次请求都需要 Google Cloud Console 生成的密钥。

适合业余项目吗？ 每月免费额度可以覆盖轻度使用；重度或商业使用需要预算按请求费用。