此页面仅适用于采用新版 Google Maps APIs Premium Plan的客户,该版本于 2016 年 1 月推出。
拥有旧版 Maps APIs for Work 或 Maps API for Business 许可?请参阅我们的 Maps APIs for Work 许可指南。要确定您是否拥有旧版许可,请执行以下操作:在 Google Cloud Support Portal 中,点击左侧的 Maps:Usage Report。如果报告顶部的 ID 采用以下格式,则说明您拥有新版 Premium Plan:gme-[company] & proj-[number] ([type])
。否则,您拥有的是旧版许可。
使用率
在 Google Maps APIs Premium Plan 中,应用消耗配额的速率因应用请求的 API 而异。
Maps API 额度
Premium Plan 客户估算的应用每年使用量,并据此购买一年或多年的配额(称为“Maps API 额度”)。您的应用发出的所有 Maps API 请求都会消耗您购买的额度池中的额度。例如,如果您的应用使用 Google Maps JavaScript API 显示地图,就会消耗 Maps JavaScript API 的地图加载额度。应用消耗完额度池中的所有额度后,您可以根据需要购买更多额度。
使用率(按 API)
| API 请求的类型... | 消耗的 Maps API 额度数量... |
|---|---|
| Maps JavaScript API 地图加载 | 1 |
| Static Maps API、Street View Image API 地图加载 |
0.25 |
| Street View Image API 元数据请求 |
0 |
| Mobile SDK(Android、iOS)地图加载 | 1 |
| Places API 服务器端(包括 Zagat)和客户端请求;不包括 Place Autocomplete | 2 |
| Place Autocomplete(服务器端和客户端)请求 | 0.1 |
| 网络服务 API(服务器端)请求Geocoding API、Directions API、Distance Matrix API(每元素)、Elevation API、Geolocation API、Time Zone API、Roads API | 0.25(加入每日使用限制后) |
| 客户端请求:Geocoding API、Directions API、Distance Matrix API(每元素)、Elevation API | 0.25(加入每日使用限制后) |
地图加载
Web API:
出现以下任意情况时对单个地图加载收费:
- 网页或应用使用 Google Maps JavaScript API 展示地图。
- 网页或应用使用 Google Maps JavaScript API 展示 Google Street View Image API 全景图。如果用街景全景图代替同一个
div元素中的地图,不会对全景图收费。 - 应用从 Google Static Maps API 请求单个地图图像。
- 应用从 Google Street View Image API 请求单个全景图图像。
网页或应用加载地图、静态地图图像或街景全景图后,与之进行的平移、缩放或切换地图图层等任何用户互动都不会额外产生地图加载次数或影响使用限制。
Mobile SDK:
每次在 Android 或 iOS 移动应用中对 Google 地图或全景对象进行实例化时,对单次地图加载收费:
- iOS 上的
GMSMapView或GMSPanoramaView对象。 - Android 上的
MapFragment、SupportMapFragment、MapView、StreetViewPanoramaFragment、SupportStreetViewPanoramaFragment或StreetViewPanoramaView之一。每次调用相关的onCreate()方法都计为一次地图加载。
移动应用加载地图或街景全景图后,与该应用进行的任何用户交互均不会产生其他地图加载,也不会影响使用限制。
Places API 消耗
对 Place Search、Details 和 Photos 的请求会在 Place Autocomplete 请求之外单独收费。例如,在 Autocomplete 小组件中,如果某位用户平均输入 5 个字符(按键)来查找某一地点,然后该用户选择该地点以获取它的详细信息,您的应用将消耗以下额度:
5 次 Place Autocomplete 请求 × 0.1(0.5 个额度)+ 地点详情(地点选择)请求(2 个额度)= 2.5 个额度
Google Places API for Android 和 Google Places API for iOS 不供出售,因此不包含在 Premium Plan 中。
使用限制
使用限制总量
应用的所有 API 请求均消耗 Maps API 额度。因此,应用的使用限制总量取决于您所购买的额度数量。如果您用完了 Maps API 额度,您应用的请求仍会成功,但是您的帐号可能需要支付超额费用。在这种情况下,您需要尽快续订您的 Google Maps APIs Premium Plan许可,以免您的帐号出现服务中断。在您使用完 85% 的配额后,Google 将通过电子邮件通知您。
Google Maps JavaScript API
根据您为 Premium Plan 购买的 Maps API 总额度提供产生地图加载的 Maps JavaScript API 请求。
Maps JavaScript API 服务(客户端)
以下列出了您的应用从 Google Maps JavaScript API 请求的客户端服务的使用限制:
| 服务 | 限制 |
|---|---|
| Directions | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每个请求最多 23 个路径点。无论有多少位用户共享同一项目,均以用户会话为单位应用使用率限制。** |
| Elevation | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每个请求最多 512 个点。无论有多少位用户共享同一项目,均以用户会话为单位应用使用率限制。** |
| Geocoding | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。无论有多少位用户共享同一项目,均以用户会话为单位应用使用率限制。** |
| Distance Matrix | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每次查询最多 625 个元素 (每个查询最多 25 个来源或 25 个目标位置)。注:mode=driving 时使用可选参数 departure_time 的请求有每个请求 100 个元素的限额。无论有多少位用户共享同一项目,均以用户会话为单位应用使用率限制。**
|
* ** 以会话为单位的使用率限制会防止将客户端服务用于批量请求(例如批量地理编码)。对于批量请求,请使用我们的网络服务 API。 |
|
Google Maps Mobile SDK
| 服务 | 限制 |
|---|---|
Maps Android API |
|
根据您为 Premium Plan 购买的 Maps API 总额度提供每次地图加载。 |
Google Maps Image API
| 服务 | 限制 |
|---|---|
| Static Maps API | 根据您为 Premium Plan 购买的 Maps API 总额度提供请求。 图像最大为 2048 x 2048 像素,具体取决于 |
Street View Image API |
根据您为 Premium Plan 购买的 Maps API 总额度提供请求。 最大图像大小为 2048 x 2048 像素。 请注意,Street View Image API 元数据请求是免费的,不消耗任何 Maps API 额度。 |
您的应用可以请求最大像素为 2048 x 2048 的 Google Static Maps API 图像。由于静态地图请求中的 scale 值会影响返回的像素数,因此每个缩放级别的最大 size 值有所不同:
| 缩放 | 最大大小 | 返回 |
|---|---|---|
| 1 | 2048x2048 |
2048x2048 |
| 2 | 1024x1024 |
2048x2048 |
| 4 | 512x512 |
2048x2048 |
Google Street View Image API 不支持 scale 参数。
Web Service API
| 网络服务 | 限制 |
|---|---|
| Directions | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每个请求最多 23 个路径点。每秒 50** 次请求。 |
| Elevation | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每个请求最多 512 个点。每秒 50** 次请求。 |
| Geocoding | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每秒 50** 次请求。 |
| Distance Matrix | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每个请求最多 625 个元素 (每个查询最多 25 个来源或 25 个目标位置)。使用率限制为每秒 1,000 个元素。注:mode=driving 时使用可选参数 departure_time 的请求有每个请求 100 个元素的限额。 |
| Geolocation | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每秒 50** 次请求。 |
| Time Zone | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每秒 50** 次请求。 |
| Roads | 100,000 个请求的每日免费共享*配额(每 24 小时);根据每年购买的 Maps API 额度提供的额外请求。每秒 50** 次请求。每次请求最多可包含 100 个点。 |
* ** 为防止滥用而规定的默认使用率限制。了解如何优化网络服务使用或请求提高使用率限制 (QPS)。 |
|
Google Places API
| 服务 | 限制 |
|---|---|
| Places API Web Service |
根据您为 Premium Plan 购买的 Maps API 总额度提供请求。使用率限制为每秒 5 次请求。了解如何优化网络服务使用或请求提高使用率限制 (QPS)。 |
| Places API 客户端服务 | 根据您为 Premium Plan 购买的 Maps API 总额度提供请求。无论有多少位用户共享同一项目,均以用户会话为单位施加速率限制。 |
消耗模型摘要
下表提供了 Google Maps APIs Premium Plan 使用率和使用限制的摘要。

