估算 Google Maps APIs Credits 使用量

本頁僅適用於 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 APIs Premium Plan 中,應用程式向 API 發出的要求會取用您每年購買的 Maps APIs Credits。下列兩個範例將介紹如何為一般的地圖應用程式估算年度 Maps APIs Credits 消耗量:其一是款簡單的房源地圖應用程式,其二為較複雜的店舖尋找程式。

若要估算範例中應用程式的額度消耗量,請考量下列事項:

  • 應用程式的使用者體驗
  • 應用程式使用哪些 API
  • 一些實作細節
  • 應用程式的使用頻率

有了這些資訊後,您便可以估算出應用程式每年所取用的額度。若要讓計算更加輕鬆,您可以使用 Google Maps APIs Premium Calculator

範例 1:房源地圖

使用者體驗

您房地產公司的仲介可在內部網站地圖上檢視公司所有有效房源。仲介可以在地圖上按一下房源的標記,在資訊視窗中查看資料庫裡關於該房地產的詳細資訊,包括負責仲介、房地產地址、面積、房地產相片、街景圖。在資訊視窗中,仲介可以按一下「取得路線」按鈕,選擇公司辦公室位置,然後檢視前往房地產的路線。

使用的地圖 API

API 提供內容
Google Maps JavaScript API 在內部網頁上顯示地圖
Google Street View Image API 在資訊視窗中提供全景圖
Google Maps Geocoding API 使用房地產地址資料庫,提供房源經緯度 (lat/long) 座標。
Google Maps Directions API 提供前往房地產的路線

實作細節

  • 您在美國科羅拉多州擁有 30 間辦公室、約 3,000 名仲介。
  • 您的房地產資料庫一般來說有約 25,000 筆有效房源。
  • 您每天使用 Geocoding Web Service 為房源進行地理編碼。

仲介使用量假設

估計每日約有 3,000 人次造訪內部網站上的房源地圖。對於每次造訪,您估計:

  • 仲介檢視 5 間房地產的資訊視窗。
  • 仲介要求 1 間房地產的路線規劃。

Maps APIs Credits 計算

地圖載入使用量

API 使用量
Maps JavaScript API 1 次地圖載入 × 3,000 名訪客 × 1 額度 = 3,000 額度
Street View Image API 5 次地圖載入 × 3,000 名訪客 × 0.25 額度 = 3,700 額度

地圖載入總量:3,000 + 3,750 = 6,750 次要求/每日 × 365 天 = 2,463,750 額度/每年

Web 服務 API 使用量

API 使用量
Geocoding API 25,000 次地理編碼/每日
Directions API 1 次要求 × 3,000 名訪客 = 3,000 次查詢

每日免費查詢數總量:25,000 + 3,000 = 28,000 每日免費查詢數

日免費查詢數低於每日免費上限 100,000,因此不需額外的額度。

每年所需的 Maps APIs Credits

地圖載入 2,463,750 額度 + Web 服務 0 額度 = 2,463,750 額度

範例 2:店舖尋找程式

使用者體驗

您的客戶可使用您網站上或行動應用程式 (Android/iOS) 中的店舖尋找程式來在特定位置附近尋找最多 50 間的鄰近商店。客戶可輸入目前位置或其他起點地址、搜尋點。客戶開始輸入起點時,應用程式自動顯示一連串符合的地址或地點名稱。當客戶從清單中選擇其中一個地點時,地圖顯示該地點附近 50 間鄰近商店的標記。接著,客戶可以按一下標記來在資訊視窗中查看店舖詳情,包括地址、營業時間(來自您的店舖資料庫)、店舖距離、位置全景圖。客戶可以選擇要取得前往店舖的路線規劃。

使用的地圖 API

API 提供內容
Google Maps JavaScript API 在網站上顯示地圖
Mobile SDK (Android/iOS) 在行動裝置上顯示地圖
Google Street View Image API 在資訊視窗中提供靜態(非互動式)全景圖
Google Maps Geocoding API 使用店舖地址清單,提供店舖經緯度 (lat/long) 座標。
Google Maps Distance Matrix API 提供從起點到資料庫中店舖的距離及所需時間;此資訊顯示在資訊視窗中
Google Maps Directions API 提供前往店舖的路線
Google Places API
JavaScript 程式庫及
Web 服務
  • 地點自動完成可將地址或搜尋點與預先輸入的資料加以比對
  • 地點詳細資料可提供使用者在自動完成結果中選擇的起點地址(或稱為「地點」)

實作細節

以下是會影響使用量預估的幾項實作細節:

  • 您在全球擁有 1,500 家店面
  • 您每 30 天使用 Geocoding Web Service 為 1,500 家店舖位置進行地理編碼。
  • 您使用資料庫的距離功能來搜尋所有經地理編碼過的地址,以取得距訪客所設起點最近的 50 家店舖。
  • 您呼叫 Google Maps Distance Matrix API 來顯示從起點到資料庫中擷取的 50 間鄰近店舖的行車距離及時間。由於您僅計算 50 間店舖的距離,因此每個要求中的元素遠低於上限的 625 個。

客戶使用量假設

每日預估有 2,000 人次造訪店舖尋找程式:約 1,000 人次造訪網站,1,000 人次透過行動裝置造訪。對於每次造訪,您估計:

  • 客戶平均輸入 8 個字元來尋找起點。
  • 客戶搜尋 1 個起點並選擇 1 個起點。
  • 客戶平均點擊 2 個標記來檢視資訊視窗。
  • 客戶取得 1 個位置的路線規劃。

Maps APIs Credits 計算

地圖載入使用量

API 使用量
Maps JavaScript API 1 次地圖載入 × 1,000 名訪客 × 1 額度 = 1,000 額度
Mobile SDK 1 次地圖載入 × 1,000 名訪客 × 1 額度 = 1,000 額度
Street View Image API 2 次地圖載入 × 2,000 名訪客 × 0.25 額度 = 1,000 額度

地圖載入總量:1,000 + 1,000 + 1,000 = 3,000 次要求/每日 × 365 天 = 1,095,000 額度/每年

地圖 JavaScript/Web 服務 API 使用量

API 使用量
Geocoding API 1,500 次地理編碼 = 1,500 次查詢(每月)
Directions API 1 次要求 × 2,000 名訪客 = 2,000 次查詢
Distance Matrix API 1 次要求 × 2,000 名訪客 × 50 間鄰近店舖 = 100,000 個元素

每日免費查詢數總量:2,000 + 100,000 = 102,000 QPD

QPD 超額總量:102,000 - 100,000 免費每查詢數 = 2,000 每日免費查詢數超額 × .25 額度 = 500 額度(每日) / 182,500 額度(每年)

地理編碼每日免費查詢數總量:1,500 × .25 額度 = 375 額度(每月)/ 4,500 額度(每年)

年度超額總量:182,500 + 4,500 = 187,000 額度(每年)

Places API 使用量

API 使用量
Places API 中的地點自動完成 1 搜尋 × 每次 8 字元 × .1 額度 = .8 × 2,000 名訪客 = 1,600 額度
Places API 中的地點詳細資料 1 次要求 × 2,000 名訪客 × 2 額度 = 4,000 額度

Places API 使用量總量:1,600 + 4,000 = 5,600 次要求(每日)/ 2,044,000 額度(每年)

每年所需的 Maps APIs Credits

地圖載入 1,095,000 額度 + 每日免費查詢數超額 187,000 額度 + 地方資訊要求 2,044,000 額度 = 3,326,000 額度