Google Maps APIs for Work 使用量資訊主頁

本頁面僅適用於舊版 Maps APIs for Work 或 Maps API for Business 授權的客戶。本頁面不適用於 2016 年 1 月推出之新版 Google Maps APIs Premium Plan 的客戶。

總覽

「Google Maps APIs for Work 使用量資訊主頁」提供詳細的報告,協助您監視您的 Maps APIs for Work 應用程式使用量與健全狀態。

使用用戶端編號的所有要求都可以取得報告資料。

有了「使用量資訊主頁」,您可以快速又輕鬆地檢視您應用程式的以下資料:

  • 頁面檢視、用戶端服務,以及 Web 服務使用量 + Web 服務的每秒查詢數 (QPS) 使用量 + 依照網域的頁面檢視與 Web 服務使用量 + Web 服務的要求成功率與錯誤

您可以針對過去一年的任何時段產生報告,並將資料匯出到檔案供日後分析與共用。 所有報告會顯示使用同一 Maps APIs for Work 用戶端編號的一或多個應用程式的資料。

報告的好處

可在「Google Maps APIs for Work 使用量資訊主頁」中取得的報告,對於應用程式開發、行銷和採購之類的目的很實用。

例如,可使用報告進行下列工作:

  • 比較不同時段的使用量,以找出趨勢和尖峰使用時間。

  • 決定要購買多少頁面檢視與每秒查詢數。

  • 檢視您網域中的頁面檢視或用戶端服務要求,以按照品牌、目標對象和其他因素做比較。

  • 檢查您的應用程式是否正常運作並疑難排解問題。

報告中包含什麼

資料 用戶端/Web 包含的 API/服務
頁面檢視 用戶端 JavaScript、靜態地圖、街景服務
按照網域的頁面檢視 用戶端 JavaScript、靜態地圖、街景服務
服務要求 用戶端 Geocoding、Directions、Elevation
服務要求 Web Geocoding、Directions、Distance Matrix、Elevation、Time Zone
按照網域的服務要求 用戶端 Geocoding、Directions、Elevation
每秒查詢數 (QPS) Web Geocoding、Directions、Distance Matrix、Elevation、Time Zone
服務要求成功率 Web Geocoding、Directions、Elevation、Time Zone
服務要求錯誤 Web Geocoding、Directions、Distance Matrix、Elevation、Time Zone

注意: 「使用量資訊主頁」不包括Google Places API、Google Maps Geolocation API、Google Maps Roads API 和 Google Maps Mobile SDK for Work 的報告。

登入使用量資訊主頁

第一次登入

在您第一次登入「使用量資訊主頁」之前,必須將您的 Google 帳戶連結到「使用量資訊主頁」。 如果還沒有 Google 帳戶,請參閱此文章取得建立帳戶的操作說明。

  1. 登入 Google Cloud Support Portal
  2. 在左側面板上,按一下 [Maps:Usage Report]。
  3. 選取 [Access the new Usage Dashboard]
  4. 遵照提示,選取 Google 帳戶,若有必要請登入。
  5. 在要求權限以便「使用量資訊主頁」存取您的 Google 帳戶的訊息中,按一下 [Approve]。 這個核准會將您的 Google 帳戶連結至您的支援入口網站帳戶。

現在您可以看到「使用量資訊主頁」。

注意: 如果無法存取「使用量資訊主頁」,請聯絡支援

初始設定之後登入

在將您的 Google 帳戶連結到「使用量資訊主頁」之後,您可在下列位置直接存取「使用量資訊主頁」:

https://maps-dashboard.appspot.com

如果尚未登入 Google 帳戶,請使用您連結到「使用量資訊主頁」的帳戶登入。

使用報告

檢視報告圖形

「Google Maps APIs for Work 使用量資訊主頁」提供圖形報告,可協助您以視覺方式了解隨著時間的使用量趨勢。 要檢視報告中每個 API 的資料,只要將滑鼠指標懸停在圖形上即可。 例如:

變更報告的日期範圍

報告的預設日期範圍是 7 天,不過您可以輕鬆自訂過去一年內任意日期範圍的報告。 (不過,[Dashboard] 標籤上的報告有固定的日期範圍。)

注意:[Web Services] 標籤上,您可以更進一步向下尋找,藉著選取 3 天或更短的日期範圍,查看您應用程式要求成功率的每小時資料。

若要變更日期範圍:

  1. [Page Views][Client Services][Web Services] 標籤上,按一下 [Calendar] 圖示日曆圖示的影像
  2. 按一下日期欄位,選取開始日期和結束日期。
  3. 按一下勾選標記按鈕勾選標記按鈕的影像

新的日期範圍就會套用到所有標籤的資料上,但 [Dashbord] 標籤除外。

注意: 「使用量資訊主頁」中顯示的所有僅限日期時間戳記(不表示一天中時間的日期)會以太平洋時間時區來表示。

當選擇較短日期範圍時,[Web Services] 標籤顯示的更精確時間戳記(有小時、分鐘或秒鐘)會以您當地時區來表示。

匯出與分析報告資料

如果您要在其他工具中分析報告資料,或與他人共用,可以將 [Page Views][Client Services][Web 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 資料之指定用戶端編號的 Google Cloud Support Portal 內註冊的所有網域。

或者,也可以變更報告的日期範圍並匯出資料,供進一步分析之用。

用戶端服務報告

檢視用戶端使用量總量

按一下 [Client Services] 標籤。 針對所選日期範圍內的每個日期,[Client-Side Services Usage] 面板會顯示您應用程式 JavaScript 實作所做的要求總數。

在右側面板中,您會在圖形上看到資料。

或者,也可以變更報告的日期範圍並匯出資料,供進一步分析之用。

按照網域檢視用戶端使用量

按一下 [Client Services] 標籤。 [By Authorized Domain] 面板會顯示所選日期範圍,您每個網域的用戶端服務要求。

如果您已指定應用程式要求的管道參數,您會看到使用量區分成網域和管道。

注意: 該報告會顯示指定用戶端編號的 Google Cloud Support Portal 內註冊的所有網域。

或者,也可以變更報告的日期範圍並匯出資料,供進一步分析之用。

Web 服務報告

檢視每秒查詢數 (QPS) 資料

按一下 [Web Services] 標籤。 [Queries Per Second] 面板會顯示所選日期範圍每個 API 的下列資料:

  • 您應用程式使用的平均每秒查詢數
  • 您應用程式使用的最高每秒查詢數
  • 您應用程式 99% 時間所使用的每秒查詢數

請注意,針對 Distance Matrix API,該報告會顯示每秒元素

每秒(起點與目的地組合)數,而非要求數。

視需要變更報告的日期範圍。

提示: 使用每秒查詢數資料來決定要購買多少每秒查詢數。

檢視 Web 服務使用量詳細資料

按一下 [Web Services] 標籤。 [Total Requests] 面板會顯示所選日期範圍內,每個日期的 Web 服務要求總數。 請注意,針對 Distance Matrix API,該報告會顯示每日元素

每天(起點與目的地組合)數,而非要求數。

或者,也可以變更報告的日期範圍並匯出資料,供進一步分析之用。

注意: 右側面板會顯示您應用程式 Web 服務要求的成功率,以及應用程式的要求所收到的所有錯誤。

如需詳細資料,請參閱「應用程式健全狀態報告」。

應用程式健全狀態報告

取得您應用程式健全狀態的快照

[Dashboard] 標籤上,可以在 [Application Status] 面板內找到您應用程式過去 2 天的效能快照。 下列圖示表示您應用程式針對 Google Maps APIs 資料的 Web 服務要求成功率:

圖示 描述

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

警告:介於 80-94% 的要求成功。

警示:低於 80% 的要求成功。

無要求:您的應用程式未使用此 API。

將滑鼠游標懸停在 API 上可檢視更多資訊。

查看 Web 服務要求的成功率

按一下 [Web Services] 標籤。 [% Request Success] 面板中的圖形會顯示您應用程式在所選日期範圍內的 Web 服務要求成功率。

或者,也可以變更報告的日期範圍並匯出資料,供進一步分析之用。

檢查 Web 服務要求錯誤

按一下 [Web Services] 標籤。 如果您應用程式在所選日期範圍的 Web 服務成功率低於 100%,在 [% Request Success] 面板中的圖形下方,您會看到您應用程式已收到的所有錯誤程式碼。

視需要變更報告的日期範圍。 要檢視帶分鐘層級時間戳記的每小時資料,請選取 3 天或更短的日期範圍。 要進一步分析及疑難排解錯誤,請將資料匯出到檔案。

[Usage Dashboard] 會顯示您應用程式在要求 Google Maps APIs Web 服務時可能收到的下列錯誤類型。 如需解決方案,請參閱「開發人員」網站的 Google Maps APIs Web 服務部分

錯誤代碼 描述
OVER_DAILY_LIMIT 您應用程式的要求已超過每日限制。 發生此錯誤時,Web 服務會停止傳回資料,直到允許更多使用量為止。
OVER_QPS_LIMIT 您應用程式針對 Web 服務的每秒查詢數 (QPS) 已超過每秒限制。 發生此錯誤時,Web 服務會停止傳回資料,直到允許更多使用量為止。
INVALID_SIGNATURE 您應用程式的要求有無效的數位簽章。 如需有關簽章及如何產生簽章的詳細資訊,請參閱驗證與授權頁面上的 數位簽章一節
INVALID_REQUEST Web 服務無法剖析您應用程式的要求。 通常在要求遺失資訊時,會發生此錯誤。
INTERNAL_ERROR 處理您應用程式的要求時發生錯誤,但是 Web 服務並未傳回原因。

支援與意見回饋

取得技術支援

如果您需要有關「Google Maps APIs for Work 使用量資訊主頁」的說明,可以在 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 使用量資訊主頁」有關。

傳送意見回饋給我們

您可以建議功能、報告問題,或傳送有關「Google Maps APIs for Work 使用量資訊主頁」的其他意見回饋。 雖然我們無法親自回覆,不過我們會使用您的意見回饋來改進「使用量資訊主頁」的使用體驗。

  1. 在任一個 [Dashboard] 標籤右下角,按一下 [Send Feedback] 按鈕 意見回饋按鈕的影像
  2. 遵照螢幕上的操作說明進行。