Google Maps APIs for Work Usage Dashboard

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

概览

Google Maps APIs for Work Usage Dashboard 提供详细的报告,可帮助您监控 Maps APIs for Work 应用的使用情况和运行状况。

使用客户端 ID 的所有请求均可获取报告数据。

通过 Usage Dashboard,您可以快速、轻松地查看应用的以下信息:

  • 网页浏览量、客户端服务以及网络服务使用情况
  • 网络服务的每秒查询数 (QPS) 使用情况
  • 按网域查看网页浏览量和网络服务使用情况
  • 网络服务的请求成功率和出现的错误

您可以为过去一年中的任意时间段创建报告,并将数据导出到一个文件以供进一步分析和共享。 所有报告显示使用相同 Maps APIs for Work 客户端 ID 的一个或多个应用的数据。

报告的好处

Google Maps APIs for Work Usage Dashboard 中提供的报告对开展应用开发、营销和采购等工作很有帮助。

例如,利用报告执行以下操作:

  • 对比不同时段的使用情况,发现使用趋势和确定使用高峰时间。

  • 确定要购买的网页浏览量和 QPS 数量。

  • 查看网域中的网页浏览量或客户端服务请求数,从品牌、目标受众和其他因素方面对比使用情况。

  • 检查应用是否运行正常,并进行问题排查。

报告中包含哪些内容

数据 客户端/网站 包含的 API/服务
网页浏览量 客户端 JavaScript、Static Maps、街景
网页浏览量(按网域) 客户端 JavaScript、Static Maps、街景
服务请求次数 客户端 Geocoding、Directions、Elevation
服务请求次数 网站 Geocoding、Directions、Distance Matrix、Elevation、Time Zone
服务请求次数(按网域) 客户端 Geocoding、Directions、Elevation
每秒请求数 (QPS) 网站 Geocoding、Directions、Distance Matrix、Elevation、Time Zone
服务请求成功率 网站 Geocoding、Directions、Elevation、Time Zone
服务请求错误 网站 Geocoding、Directions、Distance Matrix、Elevation、Time Zone

注意: Usage Dashboard 不包含 Google Places API、Google Maps Geolocation API、Google Maps Roads API 以及 Google Maps Mobile SDK for Work 的报告。

登录 Usage Dashboard

首次登录

在首次登录 Usage Dashboard 之前,您需要将 Google 帐号与 Usage Dashboard 相关联。 如果还没有 Google 帐号,请参阅本文查看创建说明。

  1. 登录 Google Cloud Support Portal
  2. 在左侧面板中,点击 Maps: Usage Report
  3. 选择 Access the new Usage Dashboard
  4. 根据提示选择 Google 帐号并根据需要登录一个帐号。
  5. 在出现 Usage Dashboard 请求访问 Google 帐号的消息时,点击 Approve。 此操作会批准将您的 Google 帐号与 Support Portal 帐号相关联。

您现在可以查看 Usage Dashboard 了。

注意: 如果您无法访问 Usage Dashboard,请联系支持

初始化设置后登录

将 Google 帐号与 Usage Dashboard 关联后,您可以直接通过以下网址访问 Usage Dashboard:

https://maps-dashboard.appspot.com

如果尚未登录 Google 帐号,请使用与 Usage Dashboard 关联的帐号登录。

使用报告

查看报告图表

Google Maps APIs for Work Usage Dashboard 提供图表形式的报告,帮助您直观查看一段时间以来的使用趋势。 如需在报告中查看每个 API 的数据,只需将鼠标指针悬停在图表上即可。 例如:

更改报告的日期范围

报告的默认日期范围为 7 天,但您可以轻松自定义过去一年内的任意报告日期范围。 (但是,Dashboard 标签中的报告的日期范围固定)

注意:Web Services 标签中,您可以选择 3 天或更短时间的日期范围,深入查看应用在每小时的请求成功率数据。

要更改日期范围,请执行以下操作:

  1. Page ViewsClient ServicesWeb Services 标签中,点击 Calendar 图标 日历图标的图片
  2. 点击数据字段,选择开始日期与结束日期。
  3. 点击对勾按钮 对勾按钮图像

新的数据范围会应用至除 Dashboard 标签之外的所有标签中的数据。

注: Usage Dashboard 中显示的所有纯日期时间戳(这种日期不显示当天具体时间)以太平洋时区表示。

如果选择的是较短日期范围,Web Services 标签中将以您的本地时区显示更加准确的时间戳(精确到小时、分或秒)。

导出并分析报告数据

如果您希望使用其他工具分析报告数据,或与他人分享报告数据,可在 Page ViewsClient ServicesWeb Services 标签中将数据导出为逗号分隔值 (CSV) 文件。

例如,您可以在电子表格程序(例如 Google 表格)、分析平台或业务情报工具中打开数据文件,从而分析使用趋势、根据网站整体流量对比使用情况、预估未来使用量等。

要导出数据,请执行以下操作:

  1. (可选)更改报告的日期范围。
  2. 在报告面板的左下角,点击 CSV 下载按钮图像
  3. 保存文件。

网页浏览量报告。

查看月数据和年数据的快照

Dashboard 标签中,“Page View Consumption”面板上会显示应用的以下信息:

  • 过去一年的总网页浏览量
  • 月平均网页浏览量
  • 日平均网页浏览量

提示: 要计算需为接下来 12 个月购买多少网页浏览量,请用 12 乘以月平均投放率。

在“Total Request”面板中,您将看到展示应用在过去 30 天的网页浏览量的图表。

查看页面浏览量使用情况详情

点击 Page Views 标签。 “Total Requests”面板显示选定日期范围内每个日期的网页浏览量请求总数。 您可以在右侧面板的图表中看到数据。 您可以选择更改报告的日期范围,并导出数据进行进一步分析。

查看网页浏览量(按网域)

点击 Page Views 标签。 “By Authorized Domain”面板显示选定日期范围内每个网域和每个 API 的网页浏览量请求总数。

如果您已为应用的请求指定了渠道参数,则您将看到按网域和渠道细分的使用情况数据。

注意: 该报告会针对请求 Google Maps APIs 数据的给定客户端 ID,显示在 Google Cloud Support Portal 中注册的所有网域。

您可以选择更改报告的日期范围,并导出数据进行进一步分析。

客户端服务报告

查看客户端总使用量

点击 Client Services 标签。 对于选定日期范围内的每个日期,“Client-Side Services Usage”面板会显示应用的 JavaScript 实现所发出的请求总数。

您可以在右侧面板的图表中看到数据。

您可以选择更改报告的日期范围,并导出数据进行进一步分析。

查看客户端使用情况(按网域)

点击 Client Services 标签。 “By Authorized Domain”面板显示选定日期范围内每个网域的客户端服务请求数。

如果您已为应用的请求指定了渠道参数,则您将看到按网域和渠道细分的使用情况。

注意: 该报告会针对给定客户端 ID,显示在 Google Cloud Support Portal 中注册的所有网域。

您可以选择更改报告的日期范围,并导出数据进行进一步分析。

网络服务报告

查看每秒查询数 (QPS) 数据

点击 Web Services 标签。 “Queries Per Second”面板显示选定日期范围内每个 API 的以下数据:

  • 应用使用的平均 QPS
  • 应用使用的最大 QPS
  • 应用在 99% 的时间内使用的 QPS

请注意,对于 Distance Matrix API,报告会显示每秒的元素数

(来源-目标位置对)而不是请求数。

您可以选择更改报告的日期范围。

提示: 使用 QPS 数据确定需购买多少 QPS。

查看网络服务使用情况详情。

点击 Web Services 标签。 “Total Requests”面板显示选定日期范围内每个日期的网络服务请求总数。 请注意,对于 Distance Matrix API,报告会显示每天的元素数

(来源-目标位置对)而不是请求数。

您可以选择更改报告的日期范围,并导出数据进行进一步分析。

注意: 右侧面板显示应用的网络服务请求的成功率和应用的请求已收到的所有错误。

详情请参阅“应用运行状况报告”。

应用运行状况报告

获取应用运行状况的快照

Dashboard 标签上,您将在“Application Status”面板中看到应用性能在过去 2 天内的快照。 以下图标用于指示应用对 Google Maps APIs 数据的网络服务请求的成功率:

Icon 说明

良好:至少 95% 的请求成功。

警告:只有 80-94% 的请求成功。

严重警告:不到 80% 的请求成功。

无请求:您的应用尚未使用此 API。

将鼠标指针悬停在 API 上方即可查看更多信息。

检查网络服务请求的成功率

点击 Web Services 标签。 “% Request Success”面板显示选定日期范围内应用的网络服务请求的成功率。

您可以选择更改报告的日期范围,并导出数据进行进一步分析。

检查网络服务请求错误

点击 Web Services 标签。 如果您的应用的网络服务在选定日期范围内的成功率低于 100%,则您将可以在“% Request Success”面板中的图表下查看应用已收到的所有错误代码。

您可以选择更改报告的日期范围。 要查看使用分钟级时间戳的每小时数据,请选择 3 天或更短的时间范围。 要进一步分析并解决错误,请将数据导出至一个文件。

Usage Dashboard 会显示您的应用在请求 Google Maps APIs 网络服务时可能收到的以下错误类型。 有关解决方案,请参阅 Developers 网站上的 Google Maps APIs 网络服务部分

错误代码 说明
OVER_DAILY_LIMIT 您的应用发出的请求已超过每日限制。 发生此错误时,网络服务会停止返回数据,直到获得更多使用量。
OVER_QPS_LIMIT 应用的网络服务每秒查询数 (QPS) 已超过每秒限制。 发生此错误时,网络服务会停止返回数据,直到获得更多使用量。
INVALID_SIGNATURE 应用发送的请求的数字签名无效。 有关签名以及签名生成方式的详情,请参阅身份验证和签名页面上的 数字签名部分
INVALID_REQUEST 网络服务无法解析应用发送的请求。 此错误通常会在请求缺少信息的情况下出现。
INTERNAL_ERROR 处理应用的请求时出错,但网络服务未返回错误原因。

支持与反馈

获取技术支持

如需有关 Google Maps APIs for Work Usage Dashboard 的帮助,您可以在 Google Cloud Support Portal 中创建案例。

  1. 登录 Google Cloud Support Portal
    注:如果您没有登录凭据,可以请求访问门户。
  2. 点击 Cases 标签。
  3. 点击 Create New Case
  4. 对于 Product Name,点击 My product isn’t listed。 然后从下拉列表中选择 Google Maps
  5. 对于 Group 和案例 Components,选择 Other
  6. 设置 Priority(根据指定优先级中的说明)。
  7. 在说明中添加问题摘要以及重现问题的步骤。 确保表明您的问题与 Google Maps APIs for Work Usage Dashboard 有关。

向我们发送反馈

您可以提出功能建议、报告问题或发送关于 Google Maps APIs for Work Usage Dashboard 的反馈。 尽管我们无法单独回复您的反馈,但我们将利用您的反馈提升 Usage Dashboard 的使用体验。

  1. 在任意 Dashboard 标签的右下角,点击 Send Feedback 按钮 反馈按钮图像
  2. 按照屏幕上的说明操作。