Places API 用量與計費

關於欄位遮罩

對於 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版),請在 API 要求中使用 FieldMask 標頭,指定要在回應中傳回的欄位清單。然後,系統會依據要求適用的最高 SKU 向您收費。也就是說,如果您在 Essentials 和 Pro SKU 中都選取了欄位,系統會根據 Pro SKU 向您收費。

使用欄位遮蓋是良好的設計做法,可確保您不會要求不必要的資料,有助於避免不必要的處理時間和帳單費用。

關於 Autocomplete (新版) 工作階段

Autocomplete (新版) 工作階段包含一或多個 Autocomplete (新版) 要求,以及一個 Place Details (新版) 要求或地址驗證要求。系統會將相同的工作階段符記傳遞給 Autocomplete (新版) 要求,以及後續的 Place Details (新版) 要求或地址驗證要求。

工作階段從第一個 Autocomplete (新版) 要求開始。使用者選取其中一個 Autocomplete (新版) 建議時,系統會發出 Place Details (新版) 要求或地址驗證要求。如果工作階段遭到捨棄 (即未提出 Place Details (新版) 要求或地址驗證要求),系統會視為未提供工作階段符記,並據此收取 Autocomplete (新版) 要求費用。

使用者選取地點 (即發出 Place Details (New) 要求或地址驗證要求) 之後,您必須使用新的工作階段符記來啟動新的工作階段。

工作階段符記適用於單一工作階段,不應用於多個工作階段。假如您重複使用工作階段符記,系統會將工作階段視為無效,並依照未提供工作階段符記的情況收取相關要求費用。

Places API 的 SKU 詳細資料和定價

下表列出 Places API 的即付即用 SKU 詳細資料和定價。

類別Places API (新版) SKU 詳細資料SKU 定價
Essentials SKU:Autocomplete Requests 全球價格清單
印度價格清單
Essentials SKU:Autocomplete Session Usage 全球價目表
印度價目表
Essentials SKU:Place Details Essentials (IDs Only) 全球價目表
印度價目表
Essentials SKU:Place Details Essentials 全球價格清單
印度價格清單
Essentials SKU:Text Search Essentials (僅限 ID) 全球價目表
印度價目表
Pro SKU:Nearby Search Pro 全球價格清單
印度價格清單
Pro SKU:Place Details Pro 全球價格清單
印度價格清單
Pro SKU:Text Search Pro 全球價格清單
印度價格清單
Enterprise SKU:Nearby Search Enterprise 全球價格清單
印度價格清單
Enterprise SKU:Nearby Search Enterprise + Atmosphere 全球價格清單
印度價格清單
Enterprise SKU:Place Details Enterprise 全球價格清單
印度價格清單
Enterprise SKU:Place Details Enterprise + Atmosphere 全球價格清單
印度價格清單
Enterprise SKU:Text Search Enterprise 全球價目表
印度價目表
Enterprise SKU:Text Search Enterprise + Atmosphere 全球價目表
印度價目表
Enterprise SKU:Place Details Photos 全球價格清單
印度價格清單
類別Places API (舊版) SKU 詳細資料SKU 定價
Essentials SKU:Autocomplete - Per Request 全球價格清單
印度價格清單
Essentials SKU:Autocomplete (included with Place Details) - Per Session 全球價目表
印度價目表
Essentials

SKU:Basic Data

額外費用:

全球價目表
印度價目表
Essentials SKU:Find Place - ID only 全球價格清單
印度價格清單
Essentials SKU:Place Details Essentials - ID Refresh 全球價格清單
印度價格清單
Essentials SKU:Query Autocomplete - Per Request 全球價格清單
印度價格清單
Pro SKU:Autocomplete without Place Details - Per Session 全球價格清單
印度價格清單
Pro

SKU:Find Place

附加費用:

全球價格清單
印度價格清單
Pro

SKU:Places - Nearby Search

額外費用:

全球價格清單
印度價格清單
Pro

SKU:Places - Text Search

附加費用:

全球價目表
印度價目表
Pro

SKU:Places Details

額外費用:

全球價目表
印度價目表
Enterprise

SKU:Atmosphere Data

附加費用:

全球價格清單
印度價格清單
Enterprise

SKU:Contact Data

額外費用:

全球價格清單
印度價格清單
Enterprise SKU:Place Photos 全球價格清單
印度價格清單

用量限制

如要查看及管理配額和用量限制,請參閱「配額和配額警告」。

  • Places API (新版):每分鐘的頻率限制是每個專案的每個 API 方法。換句話說,每個 API 方法都有獨立配額。

  • Places API (舊版):每分鐘的頻率限制計算方式為:使用相同專案憑證的所有應用程式,其用戶端和伺服器端要求的總和。

Places API 的成本效益策略

本節說明如何最佳化用量,並降低 Places API 相關費用。

使用欄位遮罩

使用欄位遮蓋可確保您不會要求不必要的資料,有助於減少延遲和帳單費用。

對於 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 要求,請使用欄位遮罩指定要在回應中傳回的欄位清單。

系統會根據要求適用的最高 SKU 向您收費。舉例來說,如果您選取 Essentials 和 Pro SKU 的欄位,系統會根據 Pro SKU 向您收費。

搭配 Place Details (新版) 使用工作階段計價模式

如果應用程式每月呼叫量達 100,001 至 500,000 次以上,或使用者在每個工作階段提出超過 12 次自動完成要求,Google 建議搭配 Autocomplete (新版) 使用工作階段。工作階段可簡化計費方式,並提供一致的計費模式,適用於 Autocomplete (New)。

詳情請參閱「自動完成 (新版) 和工作階段定價」。

調整配額

配額限制定義了特定 API 或服務在指定時間範圍內允許的要求數量上限。當專案中的要求數量達到配額上限時,服務就會停止回應要求。

如要修改 API 的配額值,請按照下列步驟操作:

  1. 在 Cloud 控制台中,依序前往「Google Maps Platform」>「配額」。
  2. 選取要修改配額的 API。
  3. 找出要變更的配額值,然後勾選該配額旁邊的核取方塊。
  4. 按一下「編輯」,輸入新的配額值,然後按一下「提交要求」。

查看配額提高要求

如要查看所有配額提高要求 (包括過去和待處理的要求),請按照下列步驟操作:

  1. 在 Cloud 控制台中,依序前往「Google Maps Platform」>「配額」。
  2. 選取要查看配額提高要求的 API。
  3. 按一下「增加要求」。

使用條款限制

如需使用條款相關資訊,請參閱Places API 政策,以及《Google Maps Platform 服務條款》的「授權限制」一節。