Google Maps 使用量報告

本頁僅適用於 2016 年 1 月推出的新版 Google Maps APIs Premium Plan 之客戶。

擁有舊版 Maps APIs for Work 或 Maps API for Business 授權嗎?請參閱我們的 Maps APIs for Work 授權指南。若要判斷您是否擁有舊的授權:在 Google Cloud Support Portal 中,按一下左側的 [Maps:Usage Report]。如果報告頂端的 ID 屬於下列格式,則您擁有新的 Premium Plan:
gme-[company] & proj-[number] ([type])
反之,則您擁有舊的授權。

總覽

Google Maps 使用量報告工具可協助追蹤您應用程式的 Google Maps APIs 使用量及其消耗的 Maps APIs Credits。使用此工具,您可檢視所有 API (包括您的 Google Maps APIs Premium Plan)上詳細的每日與每月報告。報告資料適用於包括用戶端編號或專案 ID 的 API 要求。

注意:Usage Reports 工具提供的資訊,與 Google 用來確定您應用程式使用量以便計費的資訊相同。

報告類型

成功要求報告

此報告顯示您的應用程式針對每個 API 的每日或每月要求總數。使用此報告可比較不同時段的使用量,以找出趨勢和尖峰使用時間。此外也可以使用成功要求報告來檢視下列資料:

  • 要求錯誤:針對每個 API,每日報告也會顯示成功與未成功要求(錯誤)的數量;針對您應用程式使用用戶端編號存取的 Web 服務 API,該報告也會顯視錯誤代碼,這對疑難排解很有用。
  • 管道資料:如果您在要求中包括 channel 參數,您可以產生一個成功要求報告,其中顯示使用相同用戶端編號的不同應用程式之間您應用程式的 API 要求分類細項(例如外部存取與內部存取)。藉著使用管道,您可以產生關於您應用程式使用狀況的更詳細資料報告。

Maps APIs Credits 報告

此報告會顯示您應用程式針對所有 API 的每日或每月額度消耗總數。您可以使用此報告來決定要購買多少額度。如需有關您應用程式如何消耗額度的資訊,請參閱使用費用與限制

報告功能

  • 容易閱讀的圖形:每日報告提供圖形,可協助您以視覺方式了解隨著時間的使用趨勢。藉著將游標懸停在圖形上,您可以檢視報告詳細資料。

  • 歷史資料:檢視過去一年內任何時段的報告。
  • 可下載資料:將每月要求與額度總數下載為以逗號分隔值 (CSV) 檔案,以便使用試算表或商業智慧工具進一步分析,或與他人共用資料。
  • 資料深入探查:按下報告中的每月總計或欄標題,可直接從每月報告存取每日報告。例如:

    <img src="/maps/premium/reports/images/usage_rep_mo_total.png" width="200px" /" style="float: left; width:30%; margin-right:1%; margin-bottom:0.5em;"><img src="/maps/premium/reports/images/usage_rep_mo_heading.png" width="200px" /" style="float: left; width:30%; margin-right:1%; margin-bottom:0.5em;">

存取使用量報告

若要存取 Google Maps 使用量報告:

  1. 登入 Google Cloud Support Portal
  2. 在左側面板中按一下 [Maps:Usage Report]。

產生報告

預設報告是過去 12 個月的每月成功要求報告。要產生不同報告,請使用報告篩選器:

篩選器 描述
用戶端編號
僅當您有多個用戶端編號時適用。選取您要檢視報告的用戶端編號。
管道 ID
僅適用於成功要求報告。選取您要檢視使用量資料的管道。或選取 [Show all] 來檢視所有管道的使用量資料。
開始 / 結束 選取報告的日期範圍,最多 1 年。按一下 [Update] 產生新報告。
報告類型
選取成功要求Maps APIs Credits 報告。
選取時間精細度 選擇每月每日報告。每月報告也包含每日報告的連結。每日報告會顯示成功與未成功要求,以及錯誤代碼。
API 類型 僅適用於每日報告。選取您要檢視報告的 API。

常見問題

成功要求報告

在報告上顯示使用量資料需要多久時間?

報告資料不是即時提供的。使用用戶端編號之要求的使用量資料,其處理是以每日為準。由於報告日期是根據太平洋標準時間,因此可能會延遲 1 或 2 天。使用 API 金鑰之報告的資料需要額外處理,因此最多可能需要 3 天時間才會顯示在報告中。

Google Maps JavaScript API 地圖載入是什麼?它們與頁面檢視有何不同?

使用 Google Maps APIs Premium Plan,Google Maps JavaScript API 使用量是由地圖載入決定的;也就是地圖實際顯示在頁面上時。地圖載入與頁面檢視不同,後者用來計算有舊版 Maps API for Business 或 Maps APIs for Work 授權的 Maps JavaScript API 使用量。如需詳細資訊,請參閱使用費用與限制

地圖載入數為什麼與我們網頁伺服器上的存取統計資料不符?

頁面上的地圖載入數與您網頁伺服器記錄檔中該網址點擊數之所以不同,可能有幾個原因:

  • 地圖使用量可能因頁面而異:當頁面上建立 google.maps.Map 物件時,就會產生一個地圖載入。在將地圖載入報告與您網頁伺服器的存取統計資料比較時,請仔細分析您每個網頁上的地圖使用量,尋找導致差異的原因,例如:
    • 某個頁面有一個以上的地圖,因此建立了多個 Map 物件。
    • 某個頁面不顯示地圖,但依然建立 Map 物件。例如,如果 Map 物件附加到隱藏的 HTML div 元素,就會發生此情況。
    • 某個頁面需要使用者採取行動(例如按一下按鈕)才會顯示地圖。如果使用者未採取行動,就不會建立 Map 物件。
    • 某個頁面沒有任何地圖,因此不會建立 Map 物件。
  • 時區不同:報告是從設定為太平洋時區的記錄檔衍生出來的。您可以按照太平洋時區來分析您的伺服器記錄檔,以減少由於登入您當地時區所導致的差距。
  • HTML 已快取:地圖載入並未快取。如果使用者重新載入您的頁面,該動作會產生另一個地圖載入以取得工作階段符記。不過,在此情況下,瀏覽器可能從快取載入 HTML,導致地圖載入數高於您伺服器記錄檔中的點擊數。
為什麼 Google Maps Distance Matrix API 的要求高於預期?

Google Maps Distance Matrix API 報告顯示的是元素(起點與目的地組合)數,而非要求數。如需有關元素的詳細資料,請參閱開發人員指南

要求錯誤

如何檢視我應用程式的要求錯誤?

產生一個成功要求每日報告,然後從 [API type] 清單選擇 API。您會看到一份圖形和表格,其中顯示您應用程式所做的成功與未成功要求數;對於您應用程式使用用戶端編號存取的 Web 服務 API,您也會看到那些要求所傳回來的狀態碼:

狀態碼有什麼意義?

使用量報告工具會顯示您應用程式使用用戶端編號存取之 Web 服務 API 的狀態碼。您可以在每個 API 的開發人員指南中找到這些程式碼的描述:

Geolocation API、Places API 和 Roads API 一律需要 API 金鑰。針對您應用程式使用金鑰存取的這些及其他 API,請查看您的 Developers Console 以取得狀態碼。

錯誤是否會消耗 Maps APIs Credits?

否,收到錯誤代碼的要求不會消耗額度。不過,收到 OKZERO_RESULTS 程式碼的要求會消耗額度。

管道資料

管道是什麼?

若要追蹤使用相同用戶端編號的不同應用程式的使用量,可以在您的 API 要求中使用 channel 參數。藉由指定不同 channel 值給應用程式的不同層面,您可以精確地判斷應用程式的使用情形。

例如,您的外部網站可能使用設為 customerchannel 來存取 API,而您的內部行銷部門則可能使用設為 mktingchannel。您的報告會根據這些管道值來區分 API 的使用量。

哪一個 API 支援管道?

管道報告適用於使用 Maps JavaScript API、Static Maps API、Street View Image API 和 Google Maps APIs Web 服務的應用程式。管道不適用於 Geolocation API、Places API、Roads API 和 Maps Mobile SDK。

我可以使用多少管道?

每個用戶端編號可使用最多 2,000 個不同的管道。

如何為我的應用程式要求設定管道?

確認您要求中的 channel 值符合下列需求:

  • 必須為 ASCII 英數字串。
  • 可包含句點 (.)、底線 (_) 和連字號 (-) 字元。
  • 不區分大小寫:大寫和大小寫混合的 channel 參數會合併至小寫參數。例如,CUSTOMER 管道的使用量會與 customer 管道的使用量合併。
  • 必須為靜態並指派給各應用程式實例(不能動態產生)。例如,您不能使用管道值來追蹤個別使用者。

將管道參數新增到您的要求,如下所示:

用戶端 API

將管道參數附加到您指令碼標記的 src 值:

<script src="https://maps.googleapis.com/maps/api/js?v=3
&client=gme-yourclientid
&channel=your_channel"></script>

靜態地圖與街景服務 API

在要求網址中包含此管道參數:

https://maps.googleapis.com/maps/api/staticmap
?center=15.800513,-47.91378
&zoom=11
&size=300x300
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Web 服務

在要求網址中包含此管道參數:

https://maps.googleapis.com/maps/api/geocode/json
?address=101+Main+St
&client=gme-yourclientid
&channel=your_channel
&signature=your_signature

Maps APIs Credits 報告

Maps APIs Credits 是什麼?

您的應用程式對 API 的要求會從您與 Google Maps APIs Premium Plan 一起購買的額度集區中消耗 Maps APIs Credits。 如需有關額度和您應用程式如何消耗它們的詳細資訊,請參閱使用費用與限制

額度資料顯示在報告上需要多久時間?

Google Maps 使用量報告的額度消耗資料需要處理,最多可能需要 3 天時間才會顯示在報告上。