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 天內獲得解決。