Google 地圖平台報表

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Google 地圖平台報表是一組預先定義的視覺化報表,可讓您輕鬆查看 Google Cloud 控制台中基本的 API 用量、配額和帳單資訊。此外,您還可迅速確認 API 呼叫的數量、查看剩餘的 API 用量配額,並且監控帳單在不同時期的用量變化。

報表類型包括:

  • 用量報表:記錄專案使用與其相關聯的憑證向 Google 地圖平台 API 發出的要求數量。
  • 配額報表:將配額用量記錄在可依照每分鐘要求數分組的圖表中:而在配額用量圖表下方,另有表格顯示所選 API 目前的配額限制。
  • 帳單報表:以堆疊折線圖記錄不同時間的費用。查看當月的配額用量,納入所有已套用的特定用量抵免額,以及當月的全月預測總費用。
  • 參與報表:記錄 Locator Plus 使用者的瀏覽次數、互動次數和參與度。

請參閱下方的回應狀態和報表,當中列出所有的回應狀態和回應代碼,這些狀態和代碼可定義某項要求是否會在「用量」、「配額」和/或「帳單」報表中顯示。

您可以使用 Cloud 控制台,查看 Google 地圖平台的用量、配額和帳單報表。

用量報表

當您的專案使用與專案相關聯的憑證發出 Google 地圖平台 API 要求,系統便會記錄要求數量做為用量依據。納入計算的要求包含成功的要求、導致伺服器錯誤的要求,以及導致用戶端錯誤的要求。憑證包括 API 金鑰和用戶端 ID (用於付費方案和已遷移付費方案的專案)。

用量指標會以表格 (要求、錯誤和延遲時間) 與圖表 (流量、錯誤和延遲時間) 顯示。用於追蹤:

  • 所有 API 的用量指標均可根據時間範圍與 API 進行篩選;您也可以查看依回應代碼、API 與憑證分類的流量、錯誤和延遲時間。
  • 特定 API 的用量指標則可根據時間範圍和 API 的版本、憑證及方法進行篩選;您也可以查看依回應代碼、API 方法、版本和憑證分類的流量、錯誤和延遲時間。

「API 和服務」資訊主頁

API 和服務資訊主頁頁面會針對專案已啟用的所有 API (即 Google 地圖平台 API,以及其他 API 與服務),提供用量指標總覽。

「資訊主頁」頁面提供三張圖表與一個表格。您可以選取時間範圍 (過去 1 小時到最近 30 天) 來篩選圖表與表格中顯示的用量。

「流量」圖表會顯示每個 API 的每秒查詢次數 (QPS) 用量。「錯誤」圖表會顯示每個 API 導致錯誤的要求百分比。「延遲時間」圖表會顯示每個 API 的要求延遲時間中位數。

圖表下方會有表格列出已啟用的 API 和服務。 要求數是指 (指定時間範圍的) 要求數量。錯誤是指導致錯誤的要求數量。延遲時間 (媒介延遲時間與百分位數) 則是指這些要求的延遲時間。

Monitoring API

如要存取「API 和服務」資訊主頁,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟專案選取器頁面:

    專案選取器頁面

  2. 選取所需的專案,「API 和服務」資訊主頁隨即顯示。

    如未看到這個頁面,請選取選單按鈕 選單,然後選取「API 和服務」

詳情請參閱「監控您的 API 用量」一文。

Google 地圖「總覽」頁面

Google 地圖總覽頁面會列出已啟用的 API 和最近 30 天的用量要求,並以表格呈現,也會以圖表形式顯示 API 提出的要求。「帳單」圖表則會顯示您目前的帳單和最近 3 個月的總用量資料。

螢幕截圖中的「總覽」圖表所呈現的表格,列出了過去 30 天內已啟用的 API 和 API 要求。

如要存取 Google 地圖平台的「總覽」頁面,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟「Google 地圖平台」頁面:

    前往「Google 地圖平台」頁面

  2. 選取左選單中的「總覽」

Google 地圖平台 API 頁面

Google 地圖的「API」頁面中有兩個表格。「已啟用的 API」表格會顯示每個已啟用 API 在最近 30 天內的要求數量、錯誤數量,及平均延遲時間。「其他 API」表格則會列出尚未啟用的 API。

API

如要存取 Google 地圖平台的「API」頁面,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟「Google 地圖平台」頁面:

    前往「Google 地圖平台」頁面

  2. 選取左選單中的「API」

Google 地圖「指標」頁面

Google 地圖「指標」頁面會顯示三種圖表:「流量」、「錯誤」和「延遲時間中位數」。圖表中的用量可按照回應代碼、API、API 方法或憑證分類。

「指標」頁面的圖表下方有個 API 表格,當中會列出您所選 API 的要求、錯誤及延遲時間。

使用頂端的 API 下拉式選單和右側窗格中的篩選選項,就能選取特定或多個 API、憑證、回應代碼和/或平台,篩選畫面上顯示的用量指標。此外,您也可以針對畫面上顯示的用量指標,選取時間範圍 (從 1 小時到最近 30 天) 和精細程度 (每秒或每天)。

指標頁面會顯示三種圖表:「流量」、「錯誤」和「延遲時間中位數」。

只有在已選取一個 API 時,「平台」篩選器才會顯示。

如要存取 Google 地圖平台 API 的「指標」頁面,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟「Google 地圖平台」頁面:

    前往「Google 地圖平台」頁面

  2. 選取左選單中的「指標」

「回應代碼」圖表

「依回應碼區別的流量」和「Error by response code」(依回應碼區別的錯誤) 圖表會依據回應代碼類別區別用量。下表列出了 Google 地圖平台 API 回應狀態與回應代碼類別之間的對應關係:

回應狀態 回應代碼類別
(2xx、3xx、4xx、5xx)
附註
OK 2xx 成功的回應。

此為可計費的要求,因此會耗用配額。
OK 3xx 成功的回應。

此為可計費的要求,因此會耗用配額。

舉例來說,成功的地點相片要求回傳了所參照圖片的 302 重新導向回應。
DATA_NOT_AVAILABLE 2xx 成功的回應,表示您輸入的地點沒有可用的資料。

此為可計費的要求,因此會耗用配額。
ZERO_RESULTS 2xx 未傳回任何結果的成功回應。

此為可計費的要求,因此會耗用配額。
NOT_FOUND 2xx 如果是用於回應 Directions API,這表示在要求的出發地、目的地或路線控點中,有至少一個指定地點無法進行地理編碼處理。

如果是用於回應 Places API,則表示在 Google 地點介面集資料庫中找不到該參照位置 (place_id)。

此為可計費的要求,因此會耗用配額。
INVALID_REQUEST (參數值無效)、
MAX_WAYPOINTS_EXCEEDED、
MAX_ROUTE_LENGTH_EXCEEDED 等
4xx 因參數值無效而導致的錯誤。詳情請參閱該 API 回應。

此為可計費的要求,因此會耗用配額。
REQUEST_DENIED 4xx 因驗證錯誤、存取錯誤等原因而導致的用戶端錯誤。詳情請參閱該 API 回應。
OVER_DAILY_LIMIT、
OVER_QUERY_LIMIT、
RESOURCE_EXHAUSTED、
rateLimitExceeded、
dailyLimitExceeded、
userRateLimitExceeded
4xx 在同個允許的時間範圍內提出過多要求,而導致的用戶端錯誤。請稍後再重試該要求。詳情請參閱該 API 回應。
INVALID_REQUEST (參數無效/遺失、要求剖析/驗證錯誤) 4xx 要求無效導致的用戶端錯誤。詳情請參閱該 API 回應。
NOT_FOUND (404) 4xx 若是用於回應 Geolocation API,則表示輸入的內容不足以產生位置預估。

若是用於回應 Roads API,則表示輸入的內容無法正確比對至道路。

此為可計費的要求,因此會耗用配額。
UNKNOWN_ERROR 5xx 表示因下列伺服器錯誤而無法處理要求:內部錯誤、服務超載、無法使用、逾時等。

如要進一步瞭解狀態碼和錯誤訊息,請視需要參閱相關 API 回應說明文件 (例如 Geocoding 回應Directions 回應)。

Google 地圖平台解決方案參數

Google 地圖平台提供多種程式碼範例,有助您快速完成設定並開始使用。 舉例來說,您可以使用 Cloud 控制台中的快速建構工具、依照產業解決方案導入指南進行操作,以及參考程式碼研究室的教學內容。

為瞭解用量情況並找出方式來提升解決方案的效能,Google 在 API 呼叫中加入 solution_channel 查詢參數,藉此收集程式碼範例用量的相關資訊:

  • 解決方案的程式碼範例預設內含 solution_channel 查詢參數。
  • 查詢參數會傳回解決方案的分析資料,做為 Google 提升日後解決方案品質的參考依據。
  • 如想停用此參數,請從程式碼範例中刪除 solution_channel 查詢參數及其參數值。
  • 沒有硬性規定保留參數,移除查詢參數不會影響效能。
  • 查詢參數僅供用來製作程式碼範例用量報表。
  • 查詢參數不是任何 API 相關數據分析和報表的一部分;換句話說,從解決方案程式碼範例中移除參數,並不會導致 Maps JavaScript API 內部報表停用。

「配額」報表

配額設定會限制專案可發出的 Google 地圖平台 API 要求數量。限制要求數量的選項有以下三種:每天、每分鐘和每位使用者每分鐘。只有成功和導致伺服器錯誤的要求才會計入配額。未通過驗證的要求不會占用配額。

在 Cloud 控制台的「配額」頁面中,配額用量會以圖表呈現,並可依每分鐘的要求進行分類。針對已選取的 API,目前的配額限制會顯示在配額用量圖表下方的表格。

使用這個計算機來取得任何 GMP API 產品的每分鐘配額值

Google 地圖「配額」頁面

Google 地圖「配額」頁面會針對您已選取的特定 API,顯示配額限制和配額使用情況。

Google Cloud 控制台上的配額用量圖表會顯示 API 金鑰和用戶端 ID 的總流量。您也可以在 Cloud 控制台上的「指標」圖表中查看用戶端 ID 流量。

這個頁面只顯示會耗用配額的要求,像是成功的要求 (OKZERO_RESULTSDATA_NOT_AVAILABLE),以及導致伺服器錯誤的要求 (NOT_FOUNDINVALID_REQUEST/INVALID_VALUE (參數值無效)、UNKNOWN_ERROR)。

導致用戶端錯誤的要求不會耗用配額,也不會顯示在這個頁面上;這類錯誤包括驗證/授權/無效引數錯誤 (REQUEST_DENIEDOVER_QUERY_LIMITINVALID_REQUEST (參數無效、要求剖析錯誤))。

大多數 Google 地圖平台 API (Maps Static API、Street View Static API、Geocoding API、Directions API、Places API、Time Zone API、Geolocation API 和 Elevation API) 是以要求為配額單位,但以下 API 除外:

  • Distance Matrix API 的配額單位是元素 (起點-目的地組合)。
  • Maps JavaScript API 的配額單位是地圖載入量。
  • Maps SDK for Android 和 Maps SDK for iOS 的配額單位是街景服務要求/全景載入次數 (地圖載入為免付費,不會耗用配額)。

Google Cloud 控制台中 Google 地圖「配額」頁面的螢幕截圖,其中以選取器顯示各個 API 的配額,然後根據相關 API 的既定配額顯示地圖載入量。

如要存取 Google 地圖平台的「配額」頁面,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟「Google 地圖平台」頁面:

    前往「Google 地圖平台」頁面

  2. 選取左選單中的「配額」
  3. 從 API 下拉式清單中選取 API。

配額單位

下表列出 Google 地圖平台 API 的配額單位。

Google 地圖平台 API 配額單位
地圖介面集
Maps SDK for Android 1 張全景
Maps SDK for iOS 1 張全景
Maps Static API 1 個要求
Maps JavaScript API 1 次地圖載入
Street View Static API 1 個要求
Maps Embed API 1 次地圖載入
路徑介面集
Directions API 1 個要求
Distance Matrix API 1 個元素 (出發地-目的地組合)
Roads API 1 個要求
地點介面集
Places API 1 個要求
Geocoding API 1 個要求
Geolocation API 1 個要求
Time Zone API 1 個要求

帳單報表

查看帳單報表

您可以在 Google Cloud 控制台中查看 Google 地圖平台產品的使用帳單報表 (請參閱「帳單」)。

如要存取帳單報表,請按照下列步驟操作:

  1. 在 Cloud 控制台中開啟「專案選取器」頁面:

    專案選取器頁面

  2. 選取專案。
  3. 選取選單按鈕 選單,然後選取「帳單」
  4. 如果您有多個帳單帳戶,請選取「前往連結的帳單帳戶」,開啟已連結帳單帳戶的「總覽」頁面。
  5. 選取左選單中的「報表」,即可開啟已連結帳單帳戶的帳單「報表」頁面。

如何解讀帳單報表圖表

帳單報表會以堆疊折線圖的形式顯示累計的費用。預設檢視畫面會顯示當月依專案 (所有產品) 分類的每日用量費,包含已套用的任何用量抵免額,以及當月全月的預測總費用。圖表中所有折線 (以及摘要表格中的資料列) 都有對應的專案,並依據費用由高至低排列。進一步瞭解如何解讀帳單報表圖表

螢幕截圖中的帳單報表,是以預設的預先設定檢視畫面顯示圖表和表格
圖 1:帳單報表以預設的預先設定檢視畫面顯示圖表和表格。

提示:依據 SKU 分析用量與費用

如要更精確瞭解即付即用定價模式的詳細資訊,以及這個模式如何影響導入項目,請依據 SKU 查看用量與費用。

依 SKU 分類的帳單報表
圖 2:帳單表格依 SKU 顯示使用情形和費用明細項目。
帳單報表篩選器的螢幕截圖
圖 3:帳單報表篩選器。
如要將報表資料檢視變更為依 SKU 顯示明細項目,請按照下列步驟操作:
  1. 在圖表右側的面板中,展開「分組依據」篩選器。
  2. 選取「SKU」

其他可用的帳單報表篩選器包括「時間範圍」、「專案」、「產品」、「SKU」,以及可讓您依照 API 要求來源進行篩選的「位置」

除了以產品分類使用來源,您也可以依照任何列出的值將帳單報表分組。與 Google 地圖平台 API 相關的三個鍵分別是 goog-maps-api-key-suffix (API 金鑰的最後四個字元)、goog-maps-platform-type (平台:Android、iOS、JavaScript 或網路服務),以及 goog-maps-channel (API 查詢中的既定數字管道值)。 進一步瞭解如何篩選及分組

只要取消勾選右側面板中的「Include credits in cost」(在費用中納入抵免額) 核取方塊,即可變更圖表的檢視畫面,讓系統在計算費用時排除使用量抵免額。

監控及限制耗用量

為方便您規劃預算及控管費用,建議您執行以下操作:

  • 設定預算快訊,掌握實際支出的累計情況。請注意,設定預算並不會限制 API 的用量,只會讓您在支出金額接近指定門檻時收到提醒。
  • 限制每日 API 用量,控管可計費 API 的使用費。只要設定「每日要求數」上限,即可限制支出。您可以根據想要支出的金額,利用簡單的公式來算出每日上限。例如:(每月支出/每個 SKU 的價格)/30 = (單一 API 的) 每日要求上限。請注意,由於您導入的功能可能會使用多個可計費 API,因此請視需要調整上述公式。提醒您,Google 地圖平台每月會提供 $200 美元的抵免額,計算時請務必考量這一點。

每個管道的用量追蹤

如要透過數字管道追蹤用量,您必須在 API 要求中加入「channel」參數。唯一可接受的管道值是介於 0 到 999 的數字。以下列舉幾個例子:

  • Geocoding Web Service API
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

直接在「帳單」報表上監控管道用量。管道在「標籤」底下會顯示為 goog-maps-channel 這個鍵。

依標籤篩選
圖 4:依 SKU 和管道篩選
如何依 SKU 和管道篩選帳單報表
  1. 使用「Group by」(分類依據) SKU 篩選器。
  2. 選取「標籤」插入點。
  3. 選取「Key」(鍵) 下拉式選單,然後選取「goog-maps-channel」
  4. 選取「Value」(值) 下拉式選單,然後選取您要篩選的數據管道。

按照標籤鍵 goog-maps-channel 分類,可查看每個管道產生的費用。

您在要求中導入管道使用資料後,可能要過一段時間 (最多 24 小時),資料才會反映在您的帳單報表中。

透過 BigQuery 匯出帳單資料

您也可以將帳單資料匯出至 BigQuery

BigQuery Export 可讓您將整天的 Cloud Billing 詳細資料 (例如使用情形和預估費用資料) 自動匯出至您指定的 BigQuery 資料集。然後透過 BigQuery 存取帳單資料,進行詳細的分析。 如此一來,您就能更進一步掌握 Google 地圖平台用量的來源。

如要開始使用 BigQuery 匯出並查詢資料,您可以試試看下方的範例查詢。 執行這項查詢之前,您必須:

  • 為您的帳戶啟用帳單功能與 BigQuery 帳單匯出功能。
  • 表格格式為 PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID,其中:
    • PROJECT_ID 是您的實際專案 ID (例如「my-project-123456」)。
    • DATASET_NAME 是您已建立的資料集名稱 (例如「SampleDataSet」)。
    • BILLING_ACCOUNT_ID 是帳單帳戶 ID 的參照,開頭字串為「gcp_billing_exportv1」,其中破折號 (-) 替換成底線 (_)。 舉例來說,帳單帳戶 ID 123456-7890AB-CDEF01 會變成 gcp_billing_export_v1_123456_789AB_CDEF01

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

Cloud Billing:

Google 地圖平台:

回應狀態和報表

下表列出回應狀態、HTTP 回應代碼類別及「用量」報表中的 HTTP 回應代碼類別,並指出對應的要求是否顯示在「用量」、「配額」和「帳單」報表中。

回應狀態 HTTP 回應代碼類別
(2xx、3xx、4xx、5xx)
HTTP 回應代碼類別 - 用量報表
(2xx、3xx、4xx、5xx)
用量報表 配額報表 帳單報表
OK 2xx、
3xx
2xx、
3xx
DATA_NOT_AVAILABLE、
NOT_FOUND、
ZERO_RESULTS
2xx 2xx
NOT_FOUND (Street View Static、Geolocation 和 Roads API)、
ZERO_RESULTS (Street View Static API)
4xx 4xx
INVALID_REQUEST (參數值無效)、
MAX_ROUTE_LENGTH_EXCEEDED、
MAX_WAYPOINTS_EXCEEDED
2xx/4xx 4xx
INVALID_REQUEST (參數無效/遺失、要求剖析錯誤) 2xx/4xx 4xx
REQUEST_DENIED 2xx/4xx 4xx
OVER_DAILY_LIMIT、
OVER_QUERY_LIMIT、
RESOURCE_EXHAUSTED、
dailyLimitExceeded、
rateLimitExceeded、
userRateLimitExceeded
2xx/4xx 4xx
UNKNOWN_ERROR 2xx/5xx 5xx

參與報表

如果使用 Locator Plus,數據分析資訊主頁可協助您根據資料進行分析並產生洞察資訊,清楚掌握購物者與店家搜尋器的互動成效。您可以評估逐週成效,包括瀏覽次數、與 Place Search 和 Place Details 互動的次數,以及整體參與度。此外,資訊主頁還提供重要的基準,方便您瞭解自己的實作方式與其他零售商的差異。

  • 前往 Google Cloud 控制台的 Locator Plus
  • 前往 Google Cloud 控制台的「參與報表」部分,查看數據分析資訊主頁。

您可以運用基準化報表,將自己的資料與業界匯總資料 (來自其他公司提供的自家資料) 進行比較。這項比較可提供寶貴的背景資訊,有助於設定有意義的目標、洞悉業界趨勢,以及瞭解您與競爭對手的表現差異。

如要查看基準化資料,系統會以匿名方式將您的參與資料納入 Google 基準。如果不希望在基準化報表中以匿名方式查看及納入您的參與資料,請提交支援單。支援單通常會在 3 天內獲得解決。