配额和报告

此页面仅适用于拥有旧版 Maps APIs for Work 或 Maps API for Business 许可的客户。此页面不适用于拥有新版 Google Maps APIs Premium Plan2016 年 1 月上市发售)的客户。

配额

Google Maps APIs for Work 套装中的客户端 API 将按页面查看次数消耗已购买的配额。 一次页面查看定义为:

  • 向页面加载一次 Google Maps JavaScript API。
  • 一次 Google Street View Image API 图像或 Google Static Maps API 图像请求。

  • 向页面加载一次 Google Earth API。

用户与地图的交互(例如,平移、缩放或更改地图类型)不会生成额外的页面查看次数。

如果将 API 加载到页面中,则即使随后未使用 API 显示地图,也会生成一次页面查看。 因此,我们不建议包含会将 API 加载到页面模板中的 <script> 标记,而是建议您在仅为响应可选用户活动而显示的地图所在的页面上异步加载 API。

如果已经用完购买的所有配额,您需要及时续订您的许可。

报告

您可以通过两种不同方式分析您的使用情况统计信息:

  • 要获取与您的 Google Maps APIs for Work 消耗有关的详细信息(与计费相关),请从以下位置获取可用报告:

Google Cloud Support PortalMaps: Usage Report 标签。

消耗报告

Google Cloud Support Portal 提供了 Google Maps JavaScript API 和 Google 地图图像 API 的详细报告。

登录门户后,请点击左侧导航面板中的 Maps:Usage Report。 您可以按渠道和日期范围过滤。

Google 将使用这些报告中的数据确定您的消耗费用。

渠道报告

要跟踪使用相同客户端 ID 的不同应用的消耗情况,您可以在您的请求中提供一个可选的 channel 参数。 通过为应用的不同方面指定不同的 channel 值,您可以准确确定如何使用应用。

例如,您面向外部的网站可以使用设为 customerchannel 访问 API,而您的内部营销部门可以使用设为 mktingchannel

您的报告将按照这些 channel 值对消耗进行细分。

渠道报告适用于使用 Google Maps JavaScript API、图像 API 或任意 Google Maps APIs 网络服务的应用。

channel 参数必须使用下面的格式:

  • 必须是 ASCII 字母数字字符串。
  • 接受句点 (.)、下划线 (_)和连字符 (-) 字符。
  • channel 参数不区分大小写;大写、大小写混合及小写的 channel 参数都将合并成它们对应的小写形式。

例如,CUSTOMER 渠道的消耗数据将与 customer 渠道的消耗数据组合。

  • channel 值必须为按应用实例分配的静态值,并且不得动态生成。 例如,您不能使用 channel 值跟踪各个用户。

每个客户端 ID 最多可以使用 2,000 个不同的渠道。

channel 参数应追加至您的脚本标记的 src 值后:

<script src="https://maps.googleapis.com/maps/api/js?v=3&client=gme-yourclientid&channel=YOUR_CHANNEL"></script>

Analytics for Google Maps APIs for Work

通过 Analytics for Google Maps APIs for Work,您可以了解用户如何与您的地图交互,以便您可以根据实际使用情况统计信息改进您的应用。

Analytics for Google Maps APIs for Work 可以解答以下问题:

  1. 哪些缩放比例和地图类型最常见?
  2. 用户正在请求哪些国家/地区的地理编码结果?
  3. JavaScript 服务的使用频率如何?

无需更改代码即可启用 Analytics,并且为了保护用户隐私,所有数据将聚合并匿名处理。

Google Maps JavaScript API 和相关服务可以提供报告。

此 *Zoom Interactions* 报告显示,对于与此客户端 ID 关联的网站,大多数用户都在使用介于 4 和 7 之间的缩放比例。

访问 Analytics

访问 Google Cloud Support Portal 然后从 Resources 列表中选择 Maps:Analytics。 如果您的帐号关联了多个客户端 ID,那么在您每次访问 Analytics 时,系统都会要求您选择想要使用的客户端 ID 和渠道。

为您的客户端 ID 启用 Analytics

Analytics 在默认情况下处于停用状态,并且必须单独为各个客户端 ID 启用。 在您首次尝试为每个客户端 ID 获取报告时,系统会要求您确认希望启用 Analytics。 在您启用 Analytics 后,该功能可能需要 5 分钟的时间才能开始记录数据。

不需要修改您的现有代码,除非您想要在加载 JavaScript 内容库时使用渠道功能,但是当前未指定渠道。