Places SDK for Android 用量與計費方式

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

錯誤:9005 PLACES_API_RATE_LIMIT_EXCEEDED

Places SDK for Android 採即付即用定價模式。適用於 Places SDK for Android 的 Places SDK for Android 要求會依 SKU 計費。除了整體 Google 使用條款以外,Places SDK for Android 也有使用限制。運用 Google Cloud Console 提供的工具管理費用與用量

Places SDK for Android 的計費方式

Places SDK for Android 採即付即用定價模式。Google 地圖平台 API 和 SDK 是按 SKU 計費。系統會追蹤每個 SKU 的用量,而任何一個 API 或 SDK 可能會有多個產品 SKU。費用計算方式如下:

SKU 用量 × 每次使用的價格

您可以使用定價和用量計算工具估算每個 API 或 SDK 的使用費。針對符合條件的 Google 地圖平台 SKU,每個帳單帳戶每個月都能獲得 $200 美元的 Google 地圖平台抵免額,這筆抵免額會自動套用到符合條件的 SKU1

Places SDK for Android 的定價

關於自動完成工作階段

Autocomplete 工作階段內含一些 Autocomplete 要求 (在使用者輸入時擷取地點相關建議),以及最多一個 Places Details 要求 (在使用者選取特定地點時擷取該地點的相關詳細資料)。系統會傳遞相同的工作階段符記給 Autocomplete 及後續的 Place Detail 要求。工作階段從第一個 Autocomplete 要求開始 (通常在使用者開始輸入時觸發)。使用者選取其中一個 Autocomplete 建議時,系統會發出 Places Details 呼叫。如果使用者未選取任何建議,系統就不會進行 Places Details 呼叫。

使用者選取地點 (即發出 Places Details 呼叫) 之後,您必須使用新的工作階段符記來啟動新的工作階段。

Autocomplete 工作階段可透過下列 API 產生:

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

使用工作階段的 Autocomplete 要求和 Places Details 要求會依不同的 SKU 計費。

關於地點介面集資料 SKU

一或多個資料 SKU 的觸發原因如下:

  • Android:每次要求 fetchPlace()findCurrentPlace()
  • iOS:每次呼叫 fetchPlaceFromPlaceID:findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • 網路服務:提出每個地點介面集要求時 (視要求中指定的欄位而定)

除了地點介面集要求的費用,資料要求「也會」產生費用。資料費用一律隨地點介面集要求產生。


SKU:Basic Data

您可以使用 Place Details 或 Find Place 要求中的欄位參數,將回應限制為僅限指定的欄位。地點介面集要求的基本費用已包含「Basic」類別中的欄位,因此不會產生任何額外費用。但要求以下任一欄位都會觸發 Basic Data SKU:

Android

address_componentadr_addressbusiness_statusformatted_addressgeometryiconicon_mask_base_uriicon_background_colornamepermanently_closedphototypeurlutc_offsetvicinity

iOS

GMSPlaceFieldFormattedAddressGMSPlaceFieldBusinesssStatusGMSPlaceFieldIDGMSPlaceFieldCoordinateGMSPlaceFieldNameGMSPlaceFieldPhotosGMSPlaceFieldPlusCodeGMSPlaceFieldTypesGMSPlaceFieldViewport

網路服務

address_componentadr_addressbusiness_statusformatted_addressgeometryiconnamepermanently_closedphotoplace_idplus_codetypeurlutc_offsetvicinity

每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
地點介面集要求費用
+ 0.00 美元
地點介面集要求費用
+ 0.00 美元
地點介面集要求費用
+ 0.00 美元

SKU:Contact Data

您可以使用 Place Details 或 Find Place 要求中的欄位參數 (適用於網路服務),或是 Place.Field 的陣列 (適用於 Android 或 iOS),將回應限制為僅限指定的欄位。「Contact」類別中的欄位會產生額外費用。要求以下任一欄位都會觸發 Contact Data SKU:

Android

OPENING_HOURSPHONE_NUMBERWEBSITE_URI

iOS

GMSPlaceFieldOpeningHoursGMSPlaceFieldPhoneNumberGMSPlaceFieldWebsite

網路服務

formatted_phone_numberinternational_phone_numberopening_hourswebsite

每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
地點介面集要求費用
+ 每次 0.003 美元
(+ 每 1,000 次 3.00 美元)
地點介面集要求費用
+ 每次 0.0024 美元
(+ 每 1,000 次 2.40 美元)
聯絡銷售人員洽詢高用量定價資訊

SKU:Atmosphere Data

您可以使用 Place Details 或 Find Place 要求中的欄位參數,將回應限制為僅限指定的欄位。「Atmosphere」類別中的欄位會產生額外費用。要求以下任一欄位都會觸發 Atmosphere Data SKU:

  • Android:PRICE_LEVELRATINGUSER_RATINGS_TOTAL
  • iOS:GMSPlaceFieldPriceLevelGMSPlaceFieldRatingGMSPlaceFieldUserRatingsTotal
  • JavaScript:請參閱欄位 (地點詳細資料)
  • 網路服務curbside_pickupdeliverydine_inprice_levelratingreviewtakeoutuser_ratings_total
每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
地點介面集要求費用
+ 每次 0.005 美元
(+ 每 1,000 次 5.00 美元)
地點介面集要求費用
+ 每次 0.004 美元
(+ 每 1,000 次 4.00 美元)
聯絡銷售人員洽詢高用量定價資訊

SKU:Autocomplete – Per Request

針對以下任何不含工作階段符記的呼叫或要求,系統會視為 Autocomplete – Per Request SKU 來計費:

針對從無效 Autocomplete 工作階段發出的呼叫 (例如重複使用工作階段符記的工作階段),系統也會視為 Autocomplete – Per Request SKU 來計費。

針對從 Maps JavaScript API Place Autocomplete 小工具發出的 Autocomplete 要求,如果呼叫來自無效的 Autocomplete 工作階段,系統會視為 Autocomplete – Per Request SKU 來計費。當使用者在小工具中輸入多個不同的地址,或將不同地址複製貼到小工具中,且不一定會選取自動預測的建議項目,就有可能會發生這種情況。

每月用量範圍
(每次要求的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
每次 0.00283 美元
(每 1,000 次 2.83 美元)
每次 0.00227 美元
(每 1,000 次 2.27 美元)
聯絡銷售人員洽詢高用量定價資訊

SKU:Autocomplete without Place Details – Per Session

針對不含 Place Details 要求的 Autocomplete 工作階段 (在工作階段起始的幾分鐘內),系統會視為 Autocomplete without Place Details – Per Session SKU 來計費。

每月用量範圍
(每個工作階段的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
每次 0.017 美元
(每 1,000 次 17.00 美元)
每次 0.0136 美元
(每 1,000 次 13.60 美元)
聯絡銷售人員洽詢高用量定價資訊

範例

如果您的應用程式在單一工作階段中發出下列兩個呼叫:

Android

iOS

網路服務

按 SKU 查看帳單時,其中將列出下列 SKU:

  • Autocomplete without Place Details – Per Session (價格為每工作階段 0.017 美元起)

SKU:Autocomplete (included with Place Details) – Per Session

針對包含下列任一項目的 Autocomplete 工作階段,系統會視為 Autocomplete (included with Place Details) – Per Session SKU 來計費:

  • Android:呼叫 fetchPlace()
  • iOS:呼叫 fetchPlaceFromPlaceID:
  • 網路服務:Place Details 要求

Autocomplete 要求本身免付費,但針對後續的 Place Details 呼叫,系統會根據一般 Place Details 定價計費。

Place Details 要求會產生資料 SKU (BasicContact 和/或 Atmosphere),視要求中指定的欄位而定。

如果您未在 Place Details 要求中指定欄位,則所有資料 SKU (Basic、Contact 和 Atmosphere) 都會觸發。

對於 Autocomplete 工作階段期間的 Place Details ID 重新整理要求 (僅指定 place_id 欄位的要求),系統會視為 SKU:Autocomplete without Place Details – Per Session 來計費。

每月用量範圍
(每個工作階段的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
$0.00 美元 $0.00 美元 $0.00 美元

範例

如果您的應用程式在單一工作階段中發出下列三個呼叫:

Android

iOS

網路服務

按 SKU 查看帳單時,其中將列出下列 SKU:

  • Autocomplete (included with Place Details) – Per Session (以 0.00 美元計費)
  • Place Details (價格為每工作階段 0.017 美元起)
  • Basic Data (以 0.00 美元計費)

SKU:Place Details

Place Details 呼叫的計費方式如下:

每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
每次 0.017 美元
(每 1,000 次 17.00 美元)
每次 0.0136 美元
(每 1,000 次 13.60 美元)
聯絡銷售人員洽詢高用量定價資訊

下列 API 會產生 Place Details SKU:

使用網路 API 和服務時,無論是否提供工作階段符記,系統都會視為 Place Details SKU 來計費。

Place Details 呼叫或要求也會產生資料 SKU (BasicContact 和/或 Atmosphere),視呼叫或要求中指定的欄位而定。如果在 Place Details 呼叫或要求中指定任何欄位,系統就會觸發所有資料 SKU,並向您收取 Places Details 呼叫或要求的費用,以及所有資料的費用。

示例

  1. 進行下列其中一項呼叫或要求:
    • 行動裝置:在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:,且只指定 ADDRESS 欄位
    • Web API 或服務:發出 Place Details 要求,且只指定地址欄位:getPlaceDetails(fields: formatted_address)
    按 SKU 查看帳單時,其中將列出下列 SKU:
    • Place Details (價格為每工作階段 0.017 美元起)
    • Basic Data (以 0.00 美元計費)
  2. 進行下列其中一項呼叫或要求:
    • 行動裝置:在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:,且只指定 PHONE_NUMBER 欄位
    • Web API 或服務:發出 Place Details 要求,並指定電話號碼欄位:getPlaceDetails(fields: formatted_phone_number)
    按 SKU 查看帳單時,其中將列出下列 SKU:
    • Place Details (價格為每工作階段 0.017 美元起)
    • Contact Data (價格為每次要求 0.003 美元起)
  3. 進行下列其中一項呼叫或要求:
    • 行動裝置:在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:,且指定所有欄位
    • Web API 或服務:發出 Place Details 要求,且指定所有欄位 (這是您未指定任何欄位時,這類要求將採用的預設值):getPlaceDetails()
    按 SKU 查看帳單時,其中將列出下列 SKU:
    • Place Details (價格為每工作階段 0.017 美元起)
    • Basic Data (以 0.00 美元計費)
    • Contact Data (價格為每次要求 0.003 美元起)
    • Atmosphere Data (價格為每次要求 0.005 美元起)

SKU:尋找目前所在地點

針對向 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) 發出的呼叫,系統會視為 Find Current Place 來計費。

每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
每次 0.030 美元
(每 1,000 次 30.00 美元)
每次 0.024 美元
(每 1,000 次 24.00 美元)
聯絡銷售人員洽詢高用量定價資訊

findCurrentPlace() 呼叫 (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 呼叫 (iOS) 也會產生資料 SKU (BasicContact 和/或 Atmosphere),視呼叫中指定的欄位而定。指定資料欄位,將回應限制為僅限這些欄位。系統會向您收取 Find Current Place 呼叫及相關要求資料的費用。

示例

  1. 您呼叫 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS),且只指定 ADDRESS 欄位。按 SKU 查看帳單時,其中將列出下列 SKU:
    • Find Current Place (價格為每次要求 0.030 美元起)
    • Basic Data (以 0.00 美元計費)
  2. 您呼叫 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS),並指定 PHONE_NUMBER 欄位。按 SKU 查看帳單時,其中將列出下列 SKU:
    • Find Current Place (價格為每次要求 0.030 美元起)
    • Contact Data (價格為每次要求 0.003 美元起)
  3. 您呼叫 findCurrentPlace() (Android) 或 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS),並指定全部三個資料類型值區的欄位。按 SKU 查看帳單時,其中將列出下列 SKU:
    • Find Current Place (價格為每次要求 0.030 美元起)
    • Basic Data (以 0.00 美元計費)
    • Contact Data (價格為每次要求 0.003 美元起)
    • Atmosphere Data (價格為每次要求 0.005 美元起)

SKU:Place Photo

針對下列項目,系統會視為 Place Photo SKU 來計費:

如果是 JavaScript 服務,叫用 PlacePhoto.getUrl() 方法並不會產生帳單費用,除非將網址實際用於取得像素資料。

每月用量範圍
(每次呼叫的價格)
0–100,000 次 100,001–500,000 次 500,000 次以上
每次 $0.007 美元
(每 1,000 次 $7.00 美元)
每次 $0.0056 美元
(每 1,000 次 $5.60 美元)
聯絡銷售人員洽詢高用量定價資訊

使用條款限制

如需使用條款相關資訊,請參閱《Google 地圖平台服務條款》的「授權限制」部分

管理使用成本

您可以針對傳送至任何可計費 API 的所有要求設定每日配額限制,藉此管理 Google 地圖平台 API 的使用成本。系統會在太平洋時間凌晨 12 點重設每日配額。

如要查看或變更 Places SDK for Android 的配額限制,請按照下列步驟操作:

  1. 在 Cloud Console 中,開啟「Google 地圖平台配額」頁面
  2. 按一下 API 下拉式選單,然後選取「Places SDK for Android」
  3. 如要查看配額限制,請向下捲動至「要求」資訊卡。
    表格會顯示配額名稱和限制。
  4. 如要變更配額限制,請按一下該限制的「編輯」圖示。
    在隨即顯示的對話方塊中,於「配額限制」欄位中依需求輸入可計費的每日配額限制。如果 Google 已指定最高配額限制,該數字就是您能指定的上限。接著選取「儲存」

假使您的 API 用量在某天達到可計費配額上限,則在該天的剩餘時間內,應用程式將無法存取 API。


  1. 印度使用者必須先建立 Google Cloud Platform 帳單帳戶,才能建立 Google 地圖平台帳單帳戶,以便取得 Google 地圖平台抵免額。