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 和服務。 要求數是指 (指定時間範圍的) 要求數量。錯誤是指導致錯誤的要求數量。延遲時間 (媒介延遲時間與百分位數) 則是指這些要求的延遲時間。
如要存取「API 和服務」資訊主頁，請按照下列步驟操作：
- 在 Cloud 控制台開啟「專案選取器」頁面：
- 選取所需的專案，「API 和服務」資訊主頁隨即顯示。
如未看到這個頁面，請選取選單按鈕
，然後選取「API 和服務」。
詳情請參閱「監控您的 API 用量」一文。
Google 地圖「總覽」頁面
Google 地圖總覽頁面會列出已啟用的 API 和最近 30 天的用量要求，並以表格呈現，也會以圖表形式顯示 API 提出的要求。「帳單」圖表則會顯示您目前的帳單和最近 3 個月的總用量資料。
如要存取 Google 地圖平台的「總覽」頁面，請按照下列步驟操作：
- 在 Cloud 控制台開啟「Google 地圖平台」頁面：
- 選取左選單中的「總覽」。
Google 地圖平台 API 頁面
Google 地圖的「API」頁面中有兩個表格。「已啟用的 API」表格會顯示每個已啟用 API 在最近 30 天內的要求數量、錯誤數量，及平均延遲時間。「其他 API」表格則會列出尚未啟用的 API。
如要存取 Google 地圖平台的「API」頁面，請按照下列步驟操作：
- 在 Cloud 控制台開啟「Google 地圖平台」頁面：
- 選取左選單中的「API」。
Google 地圖「指標」頁面
Google 地圖「指標」頁面會顯示三種圖表：「流量」、「錯誤」和「延遲時間中位數」。圖表中的用量資料可按照回應代碼類別、API、API 方法、憑證、平台和網域分類。
「指標」頁面的圖表下方有個 API 表格，針對您選取的 API 列出要求、錯誤及延遲時間。
使用頂端的 API 下拉式選單和右側窗格中的分組與篩選選項，就能選取特定或多個 API、憑證、回應代碼類別、平台類型和/或網域。此外，您也可以選取要顯示什麼時間範圍 (從 1 小時到最近 30 天) 以及有多精細 (每秒或每天) 的用量指標。
下圖顯示在「Grouped by」(分組依據) 下拉式清單中選擇「Platform]」(平台) 和「Domain」(網域) 分組時，單一 API 的「Platform]」(平台) 和「Domain」(網域) 篩選器：
如要存取 Google 地圖平台 API 的「指標」頁面，請按照下列步驟操作：
- 在 Cloud 控制台開啟「Google 地圖平台」頁面：
- 選取左選單中的「指標」。
「回應代碼」圖表
「Traffic by response code」(依回應碼區別的流量) 和「Error by response code」(依回應碼區別的錯誤) 圖表會依據 HTTP 回應代碼類別區分用量。下表列出 Google 地圖平台 API 回應狀態與 HTTP 回應代碼類別的對應關係：
| Maps API 狀態 | HTTP 回應代碼類別 - 用量報表 (2xx、3xx、4xx、5xx) |
附註 |
|---|---|---|
| OK | 2xx | 成功的回應。 此為可計費的要求，因此會耗用配額。 |
| OK | 3xx | 成功的回應。 此為可計費的要求，因此會耗用配額。 舉例來說，成功的地點相片要求回傳了所參照圖片的 302 重新導向回應。 |
| DATA_NOT_AVAILABLE | 4xx(1) | 成功的回應，表示您輸入的地點沒有可用的資料。 此為可計費的要求，因此會耗用配額。 |
| ZERO_RESULTS | 4xx(1) | 成功的回應，未傳回任何結果。 此為可計費的要求，因此會耗用配額。 |
| NOT_FOUND | 4xx(1) | 如果是用於回應 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 | 表示因下列伺服器錯誤而無法處理要求：內部錯誤、服務超載、無法使用、逾時等。 |
1 為了讓回報的錯誤代碼更加一致，Google 地圖平台 API 目前正著手進行遷移：1) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 4xx：DATA_NOT_AVAILABLE、NOT_FOUND、ZERO_RESULTS - 狀態；2) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 4xx：REQUEST_DENIED、OVER_DAILY_LIMIT、OVER_QUERY_LIMIT、dailyLimitExceeded、rateLimitExceeded、userRateLimitExceeded；3) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 5xx：UNKNOWN_ERROR。轉換期間，這兩種回應代碼都會顯示。Maps API 回應中傳回的回應代碼不會變更。您可以確認 Google 地圖平台指標中 4xx 和/或 5xx 的編號變大是否與上述遷移作業有關，方法是在 Metrics Explorer 中查看有哪個回應代碼的編號實際上變大 (進一步瞭解如何在 Google 地圖平台使用 Google Cloud Monitoring)。 |
||
如要進一步瞭解狀態碼和錯誤訊息，請視需要參閱相關 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 流量。
這個頁面只顯示會耗用配額的要求，像是成功的要求 (OK、ZERO_RESULTS、DATA_NOT_AVAILABLE)，以及導致伺服器錯誤的要求 (NOT_FOUND、INVALID_REQUEST/INVALID_VALUE (參數值無效)、UNKNOWN_ERROR)。
導致用戶端錯誤的要求不會耗用配額，也不會顯示在這個頁面上；這類錯誤包括驗證/授權/無效引數錯誤 (REQUEST_DENIED、OVER_QUERY_LIMIT、INVALID_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 地圖平台 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 次地圖載入 |
| 路徑介面集 | |
| Routes API (Compute Routes) | 1 個要求 |
| Routes API (Compute Route Matrix) | 1 個元素 (出發地-目的地組合) |
| Directions API | 1 個要求 |
| Distance Matrix API | 1 個元素 (出發地-目的地組合) |
| Roads API | 1 個要求 |
| 地點介面集 | |
| Places API | 1 個要求 |
| Address Validation API | 1 個要求 |
| Geocoding API | 1 個要求 |
| Geolocation API | 1 個要求 |
| Time Zone API | 1 個要求 |
帳單報表
查看帳單報表
您可以在 Google Cloud 控制台中查看 Google 地圖平台產品的使用帳單報表 (請參閱「帳單」)。
如要存取帳單報表，請按照下列步驟操作：
- 在 Cloud 控制台開啟「專案選取器」頁面：
- 選取專案。
- 選取選單按鈕 ，然後選取「帳單」。
- 如果您有多個帳單帳戶，請選取「前往連結的帳單帳戶」，開啟已連結帳單帳戶的「總覽」頁面。
- 選取左選單中的「報表」，即可開啟已連結帳單帳戶的帳單「報表」頁面。
如何解讀帳單報表圖表
帳單報表會以堆疊折線圖的形式顯示累計的費用。預設檢視畫面會顯示當月依專案 (所有產品) 分類的每日用量費，包含已套用的任何用量抵免額，以及當月全月的預測總費用。圖表中所有折線 (以及摘要表格中的資料列) 都有對應的專案，並依據費用由高至低排列。進一步瞭解如何解讀帳單報表圖表。
提示：依據 SKU 分析用量與費用
如要更精確瞭解即付即用定價模式的詳細資訊，以及這個模式如何影響導入項目，請依據 SKU 查看用量與費用。
如要將報表資料檢視變更為依 SKU 顯示明細項目，請按照下列步驟操作：
- 在圖表右側的面板中，展開「分組依據」篩選器。
- 選取「SKU」。
其他可用的帳單報表篩選器包括「時間範圍」、「專案」、「產品」、「SKU」，以及可依 API 要求來源進行篩選的「位置」。
除了以產品分類使用來源，您也可以依照任何列出的值將帳單報表分組。與 Google 地圖平台 API 相關的三個鍵分別是 goog-maps-api-key-suffix (API 金鑰的最後四個字元)、goog-maps-platform-type (平台：Android、iOS、JavaScript 或網路服務)，以及 goog-maps-channel (API 查詢中的既定數字管道值)。 進一步瞭解如何篩選及分組。
只要取消勾選右側面板的「在費用中納入抵免額」核取方塊，即可變更圖表檢視畫面，在計算費用時排除用量抵免額。
監控及限制耗用量
為方便您規劃預算及控管費用，建議您執行以下操作：
- 設定預算快訊，掌握實際支出的累計情況。請注意，設定預算並不會限制 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 這個鍵。
如何依 SKU 和管道篩選帳單報表
- 使用「Group by」(分類依據) SKU 篩選器。
- 選取「標籤」插入點。
- 選取「索引鍵」下拉式選單，然後選取「goog-maps-channel」。
- 選取「值」下拉式選單，然後選取要篩選的數值管道。
按照標籤鍵 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 地圖平台：回應狀態和報表
下表列出 Maps API 狀態、Maps API 回應中傳回的 HTTP 回應代碼，以及用量報表中的 HTTP 回應代碼類別之間的對應關係，並指出對應的要求是否顯示在用量、配額和帳單報表中。
Google 地圖平台指標中的用量報表提供 HTTP response code class 精細程度。如要查看更精細的報表，請參閱「Google 地圖平台用量監控」功能的「回應狀態碼」部分。
| Maps API 回應中提供的回應代碼 | 用量報表提供 | 回報給 | |||
|---|---|---|---|---|---|
| Maps API 狀態 | HTTP 回應代碼 | HTTP 回應代碼類別 | 用量 | 配額 | 帳單 |
| OK | 200、 204、 302 |
2xx、 3xx |
是 | 是 | 是 |
| DATA_NOT_AVAILABLE、 NOT_FOUND、 ZERO_RESULTS |
200 | 4xx1 | 是 | 是 | 是 |
| NOT_FOUND (Street View Static、Geolocation 和 Roads API)、 ZERO_RESULTS (Street View Static API) |
404 | 4xx | 是 | 是 | 是 |
| INVALID_REQUEST (參數值無效)、 MAX_ROUTE_LENGTH_EXCEEDED、 MAX_WAYPOINTS_EXCEEDED 等 |
200/400 | 4xx | 是 | 是 | 是 |
| INVALID_REQUEST (參數無效/遺失、要求剖析錯誤) | 200/400 | 4xx | 是 | 否 | 否 |
| REQUEST_DENIED | 200/400/403 | 4xx1 | 是 | 否 | 否 |
| OVER_DAILY_LIMIT、 OVER_QUERY_LIMIT、 RESOURCE_EXHAUSTED、 dailyLimitExceeded、 rateLimitExceeded、 userRateLimitExceeded |
200/403、 429 |
4xx1 | 是 | 否 | 否 |
| UNKNOWN_ERROR | 200/500、 503 |
5xx1 | 是 | 是 | 否 |
1 為了讓回報的錯誤代碼更加一致，Google 地圖平台 API 目前正著手進行遷移：1) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 4xx：DATA_NOT_AVAILABLE、NOT_FOUND、ZERO_RESULTS - 狀態；2) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 4xx：REQUEST_DENIED、OVER_DAILY_LIMIT、OVER_QUERY_LIMIT、dailyLimitExceeded、rateLimitExceeded、userRateLimitExceeded；3) 將下列 Maps API 狀態從 HTTP 回應代碼類別 2xx 改為 5xx：UNKNOWN_ERROR。轉換期間，這兩種回應代碼都會顯示。Maps API 回應中傳回的回應代碼不會變更。您可以確認 Google 地圖平台指標中 4xx 和/或 5xx 的編號變大是否與上述遷移作業有關，方法是在 Metrics Explorer 中查看有哪個回應代碼的編號實際上變大 (進一步瞭解如何在 Google 地圖平台使用 Google Cloud Monitoring)。 |
|||||
參與報表
如果使用 Locator Plus，數據分析資訊主頁可協助您根據資料進行分析並產生洞察資訊，清楚掌握購物者與店家搜尋器的互動成效。您可以評估逐週成效，包括瀏覽次數、與 Place Search 和 Place Details 互動的次數，以及整體參與度。此外，資訊主頁還提供重要的基準，方便您瞭解自己的實作方式與其他零售商的差異。
- 前往 Google Cloud 控制台的 Locator Plus。
- 前往 Google Cloud 控制台的「參與報表」區段，查看數據分析資訊主頁。
您可以運用基準化報表，將自己的資料與業界匯總資料 (來自其他公司提供的自家資料) 進行比較。這項比較可提供寶貴的背景資訊，有助於設定有意義的目標、洞悉業界趨勢，以及瞭解您與競爭對手的表現差異。
如要查看基準化資料，系統會以匿名方式將您的參與資料納入 Google 基準。如果不希望在基準化報表中以匿名方式查看及納入您的參與資料，請提交支援單。支援單通常會在 3 天內獲得解決。