配額與報告

本頁面僅適用於舊版 Maps APIs for Work 或 Maps API for Business 授權的客戶。本頁面不適用於 2016 年 1 月推出之新版 Google Maps APIs Premium Plan 的客戶。

配額

Google Maps APIs for Work 套件用戶端 API 請求頁面檢視會占用您所購買的配額。 頁面檢視數的定義為:

  • 將 Google Maps JavaScript API 載入頁面的單次動作。
  • 針對 Google Street View Image API 影像或 Google Static Maps API 影像的單次要求。

  • 將 Google Earth API 載入頁面的單次動作。

使用者和地圖的互動(例如平移、縮放,或變更地圖類型)不會產生額外的頁面檢視。

如果將 API 載入頁面(即使您當時並未使用 API 來顯示地圖),就會產生一次頁面檢視。 因此,不建議您納入會在頁面範本中載入 API 的 <script> 標記,而建議僅回應選擇性的使用者活動顯示地圖,在頁面上非同步載入 API。

當您用完所有購買的配額時,需要立即更新您的授權。

報告

您可以用兩種不同方式來分析使用統計資料:

  • 要取得 Google Maps APIs for Work 使用量詳細資訊,由於其涉及計費,請存取 Google Cloud Support Portal 之「Maps:

Usage Report」標籤提供的報告。

使用量報告

Google Cloud Support Portal 提供 Google Maps JavaScript API 和 Google Maps Image API 的詳細報告。

登入入口網站後,在左方瀏覽面板中,按一下 [Maps:Usage Report]。 您可以依照管道和日期範圍來進行篩選。

這些報告中的資料和 Google 根據使用量決定您的計費時使用的資料相同。

管道報告

要追蹤使用相同用戶端編號之不同應用程式的使用量,您可以在要求中提供選擇性的 channel 參數。 透過為應用程式的不同層面指定不同的 channel 值,您可以精確地判斷應用程式的使用情形。

例如,您對外的網站可能會使用設為 customerchannel 存取 API,而內部行銷部門則使用設為 mktingchannel

您的報告會依照這些 channel 值提供使用量明細。

管道報告適用於使用 Google Maps JavaScript API、Image API 或任何 Google Maps APIs Web 服務 的應用程式。

channel 參數必須使用下列格式:

  • 必須為 ASCII 英數字串。
  • 允許句點 (.)、底線 (_) 和連字號 (-) 字元。
  • channel 參數不區分大小寫;大寫、大小寫混用、小寫 channel 參數都會合併成相對應的小寫。 例如,CUSTOMER 管道上的使用量會和 customer 管道上的使用量合併。

  • channel 值必須是指派給各應用程式實例的靜態值,而不得動態產生。 例如,您不得使用 channel 值來追蹤個別使用者。

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

channel 參數必須附加到 script 標記的 src 值:

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

針對 Google Maps APIs for Work 的數據分析

透過針對 Google Maps APIs for Work的數據分析,您可以了解人們如何與您的地圖互動,以便根據實際使用統計資料來改善您的應用程式。

針對 Google Maps APIs for Work 的數據分析能夠回答下列問題:

  1. 哪種縮放層級和地圖類型最常用?
  2. 使用者針對哪些國家/地區要求地理編碼結果?
  3. JavaScript 服務的使用頻率?

啟用數據分析不會對您的程式碼造成任何變更,且所有資料會以匿名方式彙總,以保護使用者隱私。

Google Maps JavaScript API 和相關的服務可以使用報告。

此 *Zoom Interactions* 報告顯示,針對與此用戶端編號關聯的網站,大多數使用者使用 4 到 7 之間的縮放層級。

存取數據分析

請造訪 Google Cloud Support Portal, 並從「Resources」清單中選擇 [Maps:Analytics]。 如果您的帳戶與多個用戶端編號相關聯,系統會要求您選擇每次存取數據分析時,想要使用的用戶端編號和管道。

為您的用戶端編號啟用數據分析

根據預設,數據分析是停用的,必須針對各個用戶端編號啟用。 第一次嘗試存取各用戶端編號的報告時,系統會要求您確認您想啟用數據分析。 完成此程序後,可能要等最多 5 分鐘,數據分析才會開始記錄資料。

除非您打算利用管道功能,且目前尚未在載入 JavaScript 程式庫時指定管道,否則不需要修改現有的程式碼。