付費方案使用情況報表

注意事項：Google 地圖平台付費方案不再開放註冊或提供給新客戶。

本頁面僅適用於使用新版 Google 地圖平台付費方案 (於 2016 年 1 月推出) 的客戶。

您是付費方案客戶，還是舊版授權使用者？
判斷授權版本的方式如下：
> 登入 Google Cloud 支援入口網站，按一下左側的 [地圖：使用情況報表]。
> 查看報表頂端的 ID 格式是否如下所示：
   gme-[company] & proj-[number] ([type])
如果是，代表您使用的是付費方案。
如果不是，代表您擁有的是舊版授權 (Maps API for Work 或 Maps API for Business)。

總覽

付費方案客戶能運用 Google 地圖使用情況報表工具，追蹤自家應用程式的 Google 地圖平台使用情況與 Maps API 抵免額用量。另外，還能針對隨附於 Google 地圖平台付費方案的 API，查看每日及每月相關詳細報表。只要是附有用戶端 ID 或專案 ID 的 API 要求，都可以在報表中看到相關資料。

注意事項：使用情況報表工具所提供的資訊，也就是 Google 計算應用程式用量帳單的依據。

報表類型

要求成功報表

這份報表顯示應用程式內各個 API 的每日或每月要求總數，可用來比較不同時間範圍內的使用情況，進一步掌握趨勢與高峰用量時段。此外，要求成功報表也提供以下資料：

  • 要求錯誤：每日報表會針對各個 API 顯示成功和失敗的要求數 (錯誤)，至於應用程式透過用戶端 ID 存取的網路服務 API，報表中則會顯示錯誤代碼，方便進行疑難排解。
  • 管道資料：如果您在要求中加入管道參數，則產生的「要求成功報表」會顯示 API 要求資料明細，列出使用同樣用戶端 ID 的不同應用程式 (例如外部存取與內部存取)。也就是說，納入管道資料可製作更詳細的應用程式使用情況報表。

Maps API 抵免額報表

這份報表會顯示應用程式內所有 API 加總得出的每日或每月抵免額總用量，可用來判斷應該購買多少抵免額。如要瞭解應用程式使用抵免額的方式，請參閱使用費率和限制。

報表功能

  • 一目瞭然的圖表：每日報表提供的圖表便於查看使用趨勢變化。將滑鼠游標懸停在圖表上，即可查看報表詳細資料。

  • 歷來資料：可查看過去一年內任何時間範圍的報表。
  • 可下載資料：每月要求總數和總抵免額能下載成逗號分隔值格式的檔案 (CSV 檔)，以便透過試算表或商業智慧工具進一步分析資料，或與他人共用。
  • 資料下鑽：按一下每月報表中的每月總計或各欄標題，即可直接存取每日報表資料。例如：

存取使用情況報表

存取 Google 地圖使用情況報表的步驟如下：

  1. 登入 Google Cloud 支援入口網站。
  2. 按一下左側面板中的 [地圖：使用情況報表]。

產生報表

預設報表是過去 12 個月的每月要求成功報表。如要產生其他報表，請使用報表篩選條件：

篩選條件 說明
用戶端 ID
 僅適用於擁有多個用戶端 ID 的客戶。請選取要查看哪個用戶端 ID 的報表。
管道 ID
 僅適用於要求成功報表。請選取要查看哪個管道的使用資料，或選取 [全部顯示] 查看所有管道的使用資料。
起訖時間 請選取報表的日期範圍 (最長可達 1 年)。按一下 [更新] 即可產生新的報表。
報表類型
 請選取 [要求成功] 或 [Maps API 抵免額] 報表。
時間精細程度 請選擇 [每月] 或 [每日] 報表。每月報表也包含每日報表的連結。每日報表會同時顯示成功和失敗的要求，以及錯誤代碼。
API 類型 僅適用於每日報表。請選取要查看哪項 API 的報表。

常見問題

要求成功報表

使用資料需要多久時間才會顯示在報表中？

系統無法提供即時報表資料。針對使用用戶端 ID 的要求，系統會每天處理其使用資料，但由於報表日期是以太平洋標準時間為準，資料可能會延遲一兩天才顯示。此外，使用 API 金鑰的要求資料需要進行額外處理，最多可能需要四天的時間才會顯示在報表中。

Maps JavaScript API 地圖載入量是什麼？這和網頁瀏覽量有何差別？

採用 Google 地圖平台付費方案後，Maps JavaScript API 使用量會依據「地圖載入量」計算；也就是指地圖確實顯示在網頁上的次數。但在採用舊版 Maps API for Business 或 Maps API for Work 授權時，計算 Maps JavaScript API 使用量的依據卻是網頁瀏覽量。詳情請參閱使用費率和限制。

地圖載入量與我網路伺服器上的存取統計資料，為何不相符？

網頁上的地圖載入量次數與您網路伺服器記錄中該網址的命中次數不同，可能原因如下：

  • 網頁上的地圖使用情況可能不同：每當在網頁上建立 google.maps.Map 物件，就會產生一次地圖載入。比較地圖載入量報表與網路伺服器存取統計資料時，請仔細分析各個網頁上的地圖使用情況，找出造成差異的原因，例如：
    • 網頁內有多個地圖，因此建立了多個地圖物件。
    • 網頁未顯示地圖，但仍建立了地圖物件。舉例來說，如果在隱藏的 HTML div 元素中加入地圖物件，就會發生此情況。
    • 網頁要求使用者採取行動 (例如點擊按鈕) 以顯示地圖。如果使用者未採取動作，就不會建立地圖物件。
    • 網頁不含任何地圖，因此未建立地圖物件。
  • 時區不同：報表資料來自設為太平洋時區的記錄。請依太平洋時區的伺服器記錄進行分析，避免因採用當地時區記錄造成資料偏差。
  • 快取 HTML：未快取地圖載入量。使用者重新載入網頁時，會產生另一次地圖載入，以取得工作階段符記。不過，在此情況下，瀏覽器可能會直接從快取載入 HTML，導致地圖載入量次數高於伺服器記錄的命中次數。
Distance Matrix API 要求數為何會高於預期？

Distance Matrix API 報表顯示的是元素 (起點-目的地組合) 數量，而非要求數。如要進一步瞭解元素，請參閱《開發人員指南》。

要求錯誤

如何查看應用程式的要求錯誤？

產生每日要求成功報表，然後從「API 類型」清單中選取需要的 API。系統會透過圖表及表格顯示應用程式的成功和失敗要求數。針對應用程式需要以用戶端 ID 存取的網路服務 API，系統還會顯示要求回傳的狀態碼：

狀態碼代表的意義

使用情況報表工具會針對應用程式以用戶端 ID 存取的網路服務 API，顯示相關狀態碼。您可以在開發人員指南中參閱各個 API 的狀態碼說明：

Geolocation API、Places API 和 Roads API 一律須使用 API 金鑰存取。如要進一步瞭解這類 API，以及應用程式必須透過金鑰存取的其他 API，請至 Developers Console 參閱狀態碼說明。

要求錯誤是否會耗用 Maps API 抵免額？

不會。收到錯誤代碼的要求不會耗用抵免額，但收到 OK 或 ZERO_RESULTS 程式碼的要求就會使用抵免額。

管道資料

管道是什麼？

如要針對使用同一組用戶端 ID 或 API 金鑰的不同應用程式，追蹤相關使用情況，可以在 API 要求中加入 channel 參數。只要為應用程式的不同層面設定相應的 channel 值，就可以精確判斷應用程式的使用情況。

舉例來說，外部網站可能會使用設為 customer 的 channel 來存取 API，而內部行銷部門則可能使用設為 mkting 的 channel。報表將會按照這些管道值，提供精細的 API 使用情況。

哪些 API 支援管道報表功能？

管道報表功能適用於採用 Maps JavaScript API、Maps Static API、Street View Static API 和 Google 地圖平台網路服務的應用程式。Geolocation API、Places API、Roads API 和 Maps Mobile SDK 不支援管道報表功能。

可以使用多少個管道？

每組用戶端 ID 或 API 金鑰最多可使用 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>

Maps Static API 與 Street View Static 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

網路服務

在要求網址中加入此管道參數：

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

Maps API 抵免額報表

Maps API 抵免額是什麼？

每次應用程式向 API 發出要求，就會耗用您透過 Google 地圖平台付費方案購買的 Maps API 抵免額配額。如要進一步瞭解抵免額及應用程式使用抵免額的方式，請參閱使用費率和限制。

抵免額資料需要多久時間才會顯示在報表中？

Google 地圖使用情況報表的抵免額使用資料，最多可能需要 3 天的處理時間才會顯示在報表中。