Google Maps Usage Reports

此页面仅适用于采用新版 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 Usage Reports 工具可帮助您跟踪应用的 Google Maps APIs 使用情况,以及 Maps API 额度的消耗情况。利用该工具,您可以查看与 Google Maps APIs Premium Plan 随附的所有 API 相关的详细每日报告和每月报告。包含客户端 ID 或项目 ID 的 API 请求可获取报告数据。

:Usage Reports 工具提供的信息正是 Google 用作收费依据的应用使用情况信息。

报告类型

“成功请求”报告

此报告显示您的应用针对每个 API 每天或每月的请求总数。使用此报告对比不同时段的使用情况,以发现使用趋势和确定使用高峰时间。此外,您可以通过“成功请求”报告查看以下数据:

  • 请求错误:对于每个 API,每日报告还显示成功与失败请求(错误)的数量;对于您的应用使用客户端 ID 访问的网络服务 API,报告还会显示错误代码,以供进行问题排查所用。
  • 渠道数据:如果您的请求中包含 channel 参数,则您生成的“成功请求”报告中会显示应用的 API 请求在使用同一客户端 ID 的不同应用之间的细分情况(例如面向外部的访问与面向内部的访问)。利用渠道,您可以生成包含更多详细数据的报告,从而更细致地了解应用使用情况。

“Maps API 额度”报告

此报告针对所有 API,显示您的应用每天或每月合计消耗的总额度。您可以利用此报告确定需购买多少额度。要了解与应用消耗额度的方式相关的信息,请查阅使用率和限制

报告功能

  • 易读图表:每日报告提供图表,帮助您直观查看使用情况在一段时间内的趋势。将指针悬停在图表上,即可查看报告详情。

  • 历史数据:查看过去一年内任意时段的报告。
  • 可下载的数据:将每月请求与总额度下载到逗号分隔值 (CSV) 文件,以供通过电子表格或商业智能工具进行进一步分析,或与其他人共享数据。
  • 数据展开细目:点击报告中的每月总计或列标题,即可直接在每月报告中访问每日报告。例如:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width:30%; margin-right:1%; margin-bottom:0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width:30%; margin-right:1%; margin-bottom:0.5em;">

访问 Usage Reports

要访问 Google Maps Usage Reports,请执行以下操作:

  1. 登录 Google Cloud Support Portal
  2. 在左侧面板中,点击 Maps:Usage Report

生成报告

默认报告是过去 12 个月的每月“成功请求”报告。要生成其他报告,请使用报告过滤器:

过滤器 说明
客户端
仅当您具有多个客户端 ID 时可用。选择要查看其报告的客户端 ID。
渠道 ID
仅适用于“成功请求”报告。选择一个渠道,以查看其使用情况。或选择 Show all,以查看所有渠道的使用情况数据。
从/至 为报告选择时间范围,最长 1 年。点击“Update”生成新报告。
报告类型
选择 Successful Requests 报告或 Maps APIs Credits 报告。
选择时间粒度 选择 MonthlyDaily 报告。每月报告中也包含每日报告的链接。每日报告中既会显示成功请求和不成功请求,也会显示错误代码。
API 类型 仅适用于每日报告。选择要查看其报告的 API。

常见问题解答

“成功请求”报告

使用情况数据需要多长时间才能在报告中显示?

报告数据并非实时提供。对于使用客户端 ID 的请求,使用情况数据的处理周期为一天。由于报告日期基于太平洋标准时间,因此您可能会看到 1 到 2 天的延迟。对于使用 API 密钥的请求,数据需要进行额外处理,最多可能需要 3 天时间才能显示在报告中。

什么是 Google Maps JavaScript API 地图加载次数?它与网页浏览量有什么不同?

在 Google Maps APIs Premium Plan 中,Google Maps JavaScript API 使用量取决于“地图加载次数”,即地图在页面上实际显示一次即计为一次加载。地图加载次数不同于网页浏览量,前者通常用于在之前的 Maps API for Business 或 Maps JavaScript API 许可中计算 Maps APIs for Work 使用情况。如需了解详细信息,请参阅使用率和限制

为什么地图加载次数与我们网络服务器上的访问统计数据不匹配?

以下是页面上的地图加载次数与网络服务器日志中该网址命中数量不一致的原因:

  • 地图使用量可能因页面而异:每次在页面上生成 google.maps.Map 对象时,系统就会生成一次地图加载。在将地图加载报告与网络服务器的访问统计数据进行对比时,请仔细分析每个网页上的地图使用量情况,以找出差异原因。例如:
    • 同一个页面有多个地图,因此创建了多个地图对象。
    • 页面未显示地图,但仍然创建了地图对象。例如,如果地图对象附加到隐藏的 HTML div 元素,就会发生这种情况。
    • 用户需采取操作(例如点击),页面上才显示地图。如果用户未采取该操作,系统就不会创建地图对象。
    • 页面没有任何地图,因此也就无从创建任何地图对象。
  • 时区不同:报告基于设置为太平洋时区的日志。您可以根据太平洋时区分析服务器日志,以减少因按照您本地时区记录日志造成的任何偏差。
  • HTML 被写入缓存:地图加载次数不会写入缓存。如果用户重新加载页面,则该重新加载操作将生成另外一次地图加载以获取会话令牌。但是,在这种情况下,浏览器可能会从缓存中加载 HTML,导致地图加载次数高于服务器日志中的命中数量。
对于 Google Maps Distance Matrix API,请求数为什么高于预期?

Google Maps Distance Matrix API 报告显示元素数(起点-终点对)而不是请求数。有关元素的详情,请参阅开发者指南

请求错误

如何查看应用的请求错误?

生成“成功请求”每日报告,然后从 API type 列表中选择一个 API。您将看到一个图表和表格,显示应用的成功请求与失败请求的数量,对于您的应用使用客户端 ID 访问的网络服务 API,您还可以看到这些请求返回的状态代码:

这些状态代码各代表什么含义?

Usage Reports 工具显示您的应用使用客户端 ID 访问的网络服务 API 的状态代码。您可以在开发者指南中找到每个 API 的代码说明:

Geolocation API、Places API 和 Roads API 始终需要 API 密钥。对于您的应用使用密钥访问的这些 API 及其他 API,请在开发者控制台中查看状态代码。

出现错误是否消耗 Maps API 额度?

不会。收到错误代码的请求不会消耗额度。但是,收到 OKZERO_RESULTS 代码的请求会消耗额度。

渠道数据

什么是渠道?

要跟踪使用同一客户端 ID 的不同应用间的使用情况,可在您的 API 请求中使用 channel 参数。通过从不同角度为应用指定 channel 值,您可以准确确定应用的使用情况。

例如,您的外部网站可能使用设置为 customerchannel 访问 API,而您的内部营销部门可以使用设置为 mktingchannel 访问 API。您的报告将按照这些渠道细分 API 的消使用量。

哪些 API 支持使用渠道?

“渠道”报告适用于使用 Maps JavaScript API、Static Maps API、Street View Image API 以及 Google Maps APIs 网络服务的应用。渠道不适用于 Geolocation API、Places API、Roads API 和 Maps Mobile SDK。

我可以使用多少渠道?

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

如何为我的应用的请求设置渠道?

确保您的请求中的 channel 值符合以下要求:

  • 必须是一个 ASCII 字母数字字符串。
  • 可包含英文句号 (.)、下划线 (_) 和连字符 (-)。
  • 不区分大小写:大写、大小写混合 channel 参数将与对应的小写形式合并。例如,CUSTOMER 渠道的使用量数据将与 customer 渠道的使用量数据合并。
  • 必须是静态的,且分配给每个应用实例(无法动态生成)。例如,您无法使用 channel 值跟踪各个用户。

向您的请求中添加 channel 参数,具体如下:

客户端 API

将 channel 参数附加到脚本标签的 src 值:

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

Static Maps API 与 Street View API

请求网址中包含以下 channel 参数:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

网络服务

请求网址中包含以下 channel 参数:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

“Maps API 额度”报告

Maps API 额度是什么?

您的应用发出 API 请求会消耗您购买 Google Maps APIs Premium Plan 时一起购买的额度池中的 Maps API 额度。有关额度及应用如何消耗额度的更多信息,请参阅使用率和限制

额度数据需要多长时间才能在报告中显示?

Google Maps Usage Reports 的额度消耗数据需要接受处理,最多可能需要 3 天时间才能显示在报告中。