高级计划使用情况报告

注意：Google Maps Platform 高级计划不再适用于注册客户或新客户。

本页面仅适用于使用新版 Google Maps Platform 高级计划（于 2016 年 1 月推出）的客户。

您拥有的是高级计划许可还是旧版许可？
如需确认您拥有的是哪种许可，请执行以下操作：
> 在 Google Cloud 支持门户中，点击左侧的 Maps: Usage Report。
> 报告顶部的 ID 是否为以下格式？
   gme-[company] & proj-[number] ([type])
如果是，则表示您拥有的是高级计划许可。
如果不是，则表示您拥有的是旧版许可（Maps API for Work 或 Maps API for Business）。

概览

作为高级计划客户，您可以使用 Google Maps Usage Reports 工具跟踪您的应用对 Google Maps Platform 的使用情况及其对 Maps API 额度的消耗情况。借助该工具，您可以查看 Google Maps Platform 高级计划中包含的所有 API 的详细每日报告和每月报告。报告数据适用于包含客户端 ID 或项目 ID 的 API 请求。

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

报告类型

“成功请求”报告

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

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

“Maps API 额度”报告

此报告显示您的应用每天或每月通过所有 API 消耗的总额度。您可以使用此报告确定要购买的额度。如需了解与应用消耗额度的方式相关的信息，请参阅使用费率和用量限额。

报告功能

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

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

查看“使用情况”报告

如需访问 Google Maps Usage Reports，请按以下步骤操作：

  1. 登录 Google Cloud 支持门户。
  2. 点击左侧面板中的 Maps: Usage Report。

生成报告

默认报告是过去 12 个月的每月“成功请求”报告。如需生成其他报告，请使用报告过滤器：

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

常见问题解答

“成功请求”报告

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

报告数据并非实时更新。对于使用客户端 ID 的请求，使用情况数据的处理周期为一天。由于报告日期采用的是太平洋标准时间，因此可能会出现几天的延迟。对于使用 API 密钥的请求，数据需要进行额外处理，最长可能需要 4 天的时间才能显示在报告中。

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

在 Google Maps Platform 高级计划中，Maps JavaScript API 使用次数取决于地图加载次数，即地图在页面上实际显示一次即计为一次加载）。地图加载次数不同于网页浏览量，前者通常用于在旧版 Maps API for Business 或 Maps API for Work 许可中计算 Maps JavaScript API 的使用次数。如需了解详情，请参阅使用费率和用量限额。

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

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

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

Distance Matrix API 报告显示的是元素数（起点-终点对）而不是请求数。如需详细了解各个元素，请参阅开发者指南。

请求错误

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

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

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

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

Geolocation API、Places API 和 Roads API 始终需要 API 密钥。对于您的应用使用密钥访问的这些 API 及其他 API，请在 Developers Console 中查看状态代码。

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

不会。收到错误代码的请求不会消耗额度。但是，收到 OK 或 ZERO_RESULTS 代码的请求会消耗额度。

渠道数据

什么是渠道？

如需跟踪使用同一客户端 ID 或 API 密钥的不同应用间的使用情况，可在您的 API 请求中使用 channel 参数。通过为应用的不同方面指定不同的 channel 值，您可以精确地确定应用的使用情况。

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

哪些 API 支持使用渠道？

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

我可以使用多少渠道？

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

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

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

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

向您的请求中添加渠道参数，具体如下：

客户端 API

将渠道参数附加到脚本标记的 src 值：

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

Maps Static API 和 Street View Static API

请求网址中包含以下渠道参数：

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

网络服务

请求网址中包含以下渠道参数：

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 Platform 高级计划时一起购买的额度池中的 Maps API 额度。如需详细了解额度以及您的应用如何消耗额度，请参阅使用费率和用量限额。

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

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