Places SDK for Android 用量與計費方式

提醒：如要使用 Places SDK for Android，您必須在所有 API 要求中加入 API 金鑰，並為每個專案啟用結帳功能。

錯誤：9005 PLACES_API_RATE_LIMIT_EXCEEDED

注意：如果 Android 應用程式發生 9005 PLACES_API_RATE_LIMIT_EXCEEDED 錯誤，表示您使用的可能是已淘汰的 Places SDK for Android 版本。Places SDK for Android 的 Google Play 服務版本 (例如 com.google.android.gms:play-services-places) 已於 2019 年 1 月 29 日淘汰，並於 2019 年 7 月 29 日停用。新版 Places SDK for Android 現已推出。建議您盡快更新至新版本。詳情請參閱遷移指南。

Places SDK for Android 採用即付即用定價模式。Places SDK for Android 對 Places SDK for Android 的請求會依 SKU 計費。 除了整體的 Google 使用條款以外，Places SDK for Android 也有專屬用量限制。請使用 Google Cloud 控制台提供的工具管理費用和用量。

Places SDK for Android 的計費方式

Places SDK for Android 3.3.0 以上版本支援兩個 SDK 版本：現有的 Places SDK for Android 和 Places SDK for Android (新版)，也就是 SDK 的下一代版本。如要瞭解這兩個 SDK 版本的主要差異，請參閱「選擇 SDK 版本」。

您選擇的 SDK 版本會控制 Place Details、Text Search 和 Place Photos 的價格。如需詳細的定價資訊，請參閱「Places SDK for Android (新版) 定價」和「Places SDK for Android 定價」。

兩個 SDK 的 Place Autocomplete 和 Current Place 定價相同。

Places SDK for Android (新版) 和 Places SDK for Android 採用即付即用定價模式。Google 地圖平台 API 和 SDK 是按 SKU 計費。系統會追蹤每個 SKU 的用量，單一 API 或 SDK 可能會有多個產品 SKU。費用計算方式如下：

SKU 用量 × 每次使用單價

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

注意： Google 地圖平台 $200 美元抵免額優惠有效期限至 2025 年 2 月 28 日晚上 11 點 59 分 (當地時間)。自 2025 年 3 月 1 日起，每個 API 的免費使用額度將取代 $200 美元的抵免額。詳情請參閱常見問題。

Places SDK for Android 的定價 (新版)

關於欄位遮罩

在要求中使用欄位遮罩 (又稱為「欄位清單」)，指定要在回應中傳回的欄位清單。系統會依據適用於您要求的最高 SKU 收費。也就是說，如果您同時選取「(Basic)」SKU 和「(Advanced)」SKU 中的欄位，系統會根據「(Advanced)」SKU 收費。

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

關於 Autocomplete (新版) 工作階段

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

工作階段會從第一個 Autocomplete (New) 要求開始。使用者選取其中一個 Autocomplete (新版) 建議時，系統會發出 Place Details (新版) 要求或 Address Validation 要求。如果工作階段遭到放棄，也就是沒有提出 Place Details (New) 要求或 Address Validation 要求，系統會針對 Autocomplete (New) 要求收費，因為系統會將其視為未提供工作階段符記。

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

注意： 工作階段權杖可跨專案重疊，但每個專案的權杖不得重複。舉例來說，使用專案 A 的應用程式和使用專案 B 的應用程式可以使用相同的工作階段符記，但使用專案 A 的多個應用程式則無法使用相同的工作階段符記。

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

SKU：自動完成要求

針對傳送至 Autocomplete (新版) API 且未提供工作階段符記的要求，系統會以「Autocomplete Requests」SKU 計費。

您使用工作階段符記，且符合下列任一情況時，系統也會向您收取費用：

• 透過對 Place Details (新版) 提出單一要求，即可終止工作階段，該要求會要求 SKU：Place Details (僅限位置) 定義的任何欄位。
  • 每項 Autocomplete (新版) 要求 (最多 12 項) 都會以 SKU：Autocomplete Requests 計費。
  • 系統會使用 SKU：自動完成工作階段用量，針對後續的每個 Autocomplete (新版) 要求收費。
  注意：如果您在工作階段符記到期前呼叫 SKU：Address Validation Preferred，系統就不會收取 SKU：Place Details (Location Only) 呼叫的費用，而是根據 SKU：Autocomplete Session Usage 計費。
• 呼叫 SKU：Place Details (僅限 ID) 即可放棄或結束工作階段。系統會使用 SKU：自動完成要求 來計費，針對所有 Autocomplete (New) 要求收費。

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

---

SKU：Autocomplete 工作階段使用量

針對傳送至 Autocomplete (新版) API 且包含工作階段符記的每個要求，系統會以 Autocomplete Session Usage SKU 計費。

在下列情況下，系統會向您收取這個 SKU 的費用：

• 系統會在呼叫 SKU：Place Details (僅限位置) 時終止 Autocomplete 工作階段：

  • 每項 Autocomplete (新版) 要求 (最多 12 項) 都會以 SKU：Autocomplete Requests 計費。
  • 系統會使用 SKU：自動完成工作階段用量，針對後續的每個 Autocomplete (新版) 要求收費。

• 自動完成工作階段因呼叫 SKU：Places Details (Basic、Advanced 或 Preferred) 而終止。

  要求 任何欄位的 Place Details 呼叫，會根據 SKU：Place Details (Basic、Advanced 或 Preferred) 計費。

• 自動完成工作階段在呼叫 SKU：Address Validation Preferred 時終止。

  注意：如果您在工作階段符記到期前，先呼叫 SKU：Place Details (Location Only)，然後再呼叫 SKU：Address Validation Preferred，系統就不會向您收取 SKU：Place Details (Location Only) 的費用，而只會針對 SKU：Address Validation Preferred 的呼叫收費。

詳情請參閱「自動完成 (新功能) 和會話定價」。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.00 美元 (每 1,000 次 0.00 美元)	每次 0.00 美元 (每 1,000 次 0.00 美元)	每次 0.00 美元 (每 1,000 次 0.00 美元)

---

SKU：Place Details (IDs only)

注意：如果您選取 Place Details (Location Only) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取 Place Details (Basic) SKU 中的任何欄位，系統會以該費率向您收費。如果您選取任何「Place Details (進階)」SKU 欄位，系統就會以該費率向您收費。如果您選取 Place Details (Preferred) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在 Place Details (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.DISPLAY_NAME、Place.Field.ID、Place.Field.PHOTO_METADATAS、Place.Field.RESOURCE_NAME、

注意事項：

• Place.Field.NAME 欄位已在 Places SDK for Android 4.0 版中淘汰。改用 Place.Field.DISPLAY_NAME。
• RESOURCE_NAME 欄位包含地點資源名稱，格式為 places/PLACE_ID。使用 DISPLAY_NAME 存取地點的文字名稱。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.0 美元 (每 1,000 次 0.00 美元)	每次 0.0 美元 (每 1,000 次 0.00 美元)	每次 0.0 美元 (每 1,000 次 0.00 美元)

---

SKU：Place Details (Location Only)

注意：如果您選取 Place Details (Basic) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取 Place Details (進階) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取 Place Details (Preferred) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在 Place Details (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.ADDRESS_COMPONENTS、ADR_FORMAT_ADDRESS、Place.Field.FORMATTED_ADDRESS、Place.Field.LOCATION、Place.Field.PLUS_CODE、Place.Field.SHORT_FORMATTED_ADDRESS、Place.Field.TYPES、Place.Field.VIEWPORT、

注意：Place.Field.ADDRESS 和 Place.Field.LAT_LNG 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.FORMATTED_ADDRESS 和 Place.Field.LOCATION。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每個 0.005 美元 (每 1,000 個 5.00 美元)	每個 0.004 美元 (每 1,000 個 4.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Place Details (Basic)

注意：如果您選取 Place Details (Advanced) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取 Place Details (Preferred) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在 Place Details (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.ACCESSIBILITY_OPTIONS、Place.Field.BUSINESS_STATUS、Place.Field.GOOGLE_MAPS_URI、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_MASK_URL、Place.Field.PRIMARY_TYPE、Place.Field.PRIMARY_TYPE_DISPLAY_NAME、Place.Field.SUB_DESTINATIONS、Place.Field.UTC_OFFSET、

注意：Place.Field.ICON_URL 和 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.ICON_MASK_URL 和 Place.Field.ACCESSIBILITY_OPTIONS。Place.Field.ACCESSIBILITY_OPTIONS 僅適用於 Place Details (新版)。

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

---

SKU：Place Details (Advanced)

注意：如果您選取 Place Details (Preferred) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在 Place Details (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.CURRENT_OPENING_HOURS、Place.Field.CURRENT_SECONDARY_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.NATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.PRICE_LEVEL、Place.Field.RATING、Place.Field.SECONDARY_OPENING_HOURS、Place.Field.USER_RATING_COUNT、Place.Field.WEBSITE_URI、

注意：Place.Field.PHONE_NUMBER 和 Place.Field.USER_RATINGS_TOTAL 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.INTERNATIONAL_PHONE_NUMBER 和 Place.USER_RATING_COUNT。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.020 美元 (每 1,000 次 20.00 美元)	每個 0.016 美元 (每 1,000 個 16.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Place Details (Preferred)

您可以在 Place Details (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android：Place.Field.ALLOWS_DOGS、Place.Field.CURBSIDE_PICKUP、Place.Field.DELIVERY、Place.Field.DINE_IN、Place.Field.EDITORIAL_SUMMARY、Place.Field.EV_CHARGE_OPTIONS、Place.Field.FUEL_OPTIONS、Place.Field.GOOD_FOR_CHILDREN、Place.Field.GOOD_FOR_GROUPS、Place.Field.GOOD_FOR_WATCHING_SPORTS、Place.Field.LIVE_MUSIC、Place.Field.MENU_FOR_CHILDREN、Place.Field.OUTDOOR_SEATING、Place.Field.PARKING_OPTIONS、Place.Field.PAYMENT_OPTIONS、Place.Field.RESERVABLE、Place.Field.RESTROOM、Place.Field.REVIEWS、Place.Field.SERVES_BEER、Place.Field.SERVES_BREAKFAST、Place.Field.SERVES_BRUNCH、Place.Field.SERVES_COCKTAILS、Place.Field.SERVES_COFFEE、Place.Field.SERVES_DESSERT、Place.Field.SERVES_DINNER、Place.Field.SERVES_LUNCH、Place.Field.SERVES_VEGETARIAN_FOOD、Place.Field.SERVES_WINE、Place.Field.TAKEOUT

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.025 美元 (每 1,000 次 25.00 美元)	每次 0.020 美元 (每 1,000 次 20.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Nearby Search (Basic)

注意：如果您選取附近搜尋 (進階) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取 Nearby Search (Preferred) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.ADDRESS_COMPONENTS、Place.Field.BUSINESS_STATUS、Place.Field.ADDRESS、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_URL、Place.Field.LAT_LNG、Place.Field.PHOTO_METADATAS、Place.Field.PLUS_CODE、Place.Field.PRIMARY_TYPE、Place.Field.PRIMARY_TYPE_DISPLAY_NAME、Place.Field.ID、Place.Field.NAME、Place.Field.TYPES、Place.Field.UTC_OFFSET、Place.Field.VIEWPORT、Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.032 美元 (每 1,000 次 32.00 美元)	每次 0.0256 美元 (每 1,000 次 25.60 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Nearby Search (Advanced)

注意：如果您選取鄰近搜尋 (優先) SKU 的任何欄位，系統就會以該費率向您收費。

您可以在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.CURRENT_OPENING_HOURS、Place.Field.CURRENT_SECONDARY_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.NATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.PRICE_LEVEL、Place.Field.RATING、Place.Field.SECONDARY_OPENING_HOURS、Place.Field.USER_RATING_COUNT、Place.Field.WEBSITE_URI、

注意：Place.Field.PHONE_NUMBER 和 Place.Field.USER_RATINGS_TOTAL 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.INTERNATIONAL_PHONE_NUMBER 和 Place.USER_RATING_COUNT。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.035 美元 (每 1,000 次 35.00 美元)	每次 0.028 美元 (每 1,000 次 28.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Nearby Search (Preferred)

您可以在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android：Place.Field.ALLOWS_DOGS、Place.Field.CURBSIDE_PICKUP、Place.Field.DELIVERY、Place.Field.DINE_IN、Place.Field.EDITORIAL_SUMMARY、Place.Field.EV_CHARGE_OPTIONS、Place.Field.FUEL_OPTIONS、Place.Field.GOOD_FOR_CHILDREN、Place.Field.GOOD_FOR_GROUPS、Place.Field.GOOD_FOR_WATCHING_SPORTS、Place.Field.LIVE_MUSIC、Place.Field.MENU_FOR_CHILDREN、Place.Field.OUTDOOR_SEATING、Place.Field.PARKING_OPTIONS、Place.Field.PAYMENT_OPTIONS、Place.Field.RESERVABLE、Place.Field.RESTROOM、Place.Field.REVIEWS、Place.Field.SERVES_BEER、Place.Field.SERVES_BREAKFAST、Place.Field.SERVES_BRUNCH、Place.Field.SERVES_COCKTAILS、Place.Field.SERVES_COFFEE、Place.Field.SERVES_DESSERT、Place.Field.SERVES_DINNER、Place.Field.SERVES_LUNCH、Place.Field.SERVES_VEGETARIAN_FOOD、Place.Field.SERVES_WINE、Place.Field.TAKEOUT

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.040 美元 (每 1,000 次 40.00 美元)	每次 0.032 美元 (每 1,000 次 32.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Text Search (ID Only)

注意：如果您選取文字搜尋 (基本) SKU 中的任何欄位，系統會以該費率向您收費。如果您選取文字搜尋 (進階) SKU 中的任何欄位，系統就會以該費率向您收費。如果您選取文字搜尋 (優先) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在文字搜尋 (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.DISPLAY_NAME、 Place.Field.ID、 Place.Field.RESOURCE_NAME

注意事項：

• Place.Field.NAME 欄位已在 Places SDK for Android 4.0 版中淘汰。改用 Place.Field.DISPLAY_NAME。
• RESOURCE_NAME 欄位包含地點資源名稱，格式為 places/PLACE_ID。使用 DISPLAY_NAME 存取地點的文字名稱。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.0 美元 (每 1,000 次 0.00 美元)	每次 0.0 美元 (每 1,000 次 0.00 美元)	每次 0.0 美元 (每 1,000 次 0.00 美元)

---

SKU：Text Search (Basic)

注意：如果您選取文字搜尋 (進階) SKU 中的任何欄位，系統會以該費率向您收費。如果您選取文字搜尋 (優先) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在文字搜尋 (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android：Place.Field.ACCESSIBILITY_OPTIONS、Place.Field.ADDRESS_COMPONENTS、Place.Field.ADR_FORMAT_ADDRESS、Place.Field.BUSINESS_STATUS、Place.Field.FORMATTED_ADDRESS、Place.Field.GOOGLE_MAPS_URI、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_MASK_URL、Place.Field.LOCATION、Place.Field.PHOTO_METADATAS、Place.Field.PLUS_CODE、Place.Field.PRIMARY_TYPE、Place.Field.PRIMARY_TYPE_DISPLAY_NAME、Place.Field.SHORT_FORMATTED_ADDRESS、Place.Field.SUB_DESTINATIONS、Place.Field.TYPES、Place.Field.UTC_OFFSET、Place.Field.VIEWPORT、

注意：Place.Field.ADDRESS、Place.Field.ICON_URL、Place.Field.LAT_LNG 和 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.FORMATTED_ADDRESS、Place.Field.ICON_MASK_URL、Place.Field.LOCATION 和 Place.ACCESSIBILITY_OPTIONS。Place.Field.ACCESSIBILITY_OPTIONS 僅適用於 Place Details (新版)。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.032 美元 (每 1,000 次 32.00 美元)	每次 0.0256 美元 (每 1,000 次 25.60 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Text Search (Advanced)

注意：如果您選取文字搜尋 (優先) SKU 中的任何欄位，系統就會以該費率向您收費。

您可以在文字搜尋 (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android： Place.Field.CURRENT_OPENING_HOURS、Place.Field.CURRENT_SECONDARY_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.NATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.PRICE_LEVEL、Place.Field.RATING、Place.Field.SECONDARY_OPENING_HOURS、Place.Field.USER_RATING_COUNT、Place.Field.WEBSITE_URI、

注意：Place.Field.PHONE_NUMBER 和 Place.Field.USER_RATINGS_TOTAL 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.INTERNATIONAL_PHONE_NUMBER 和 Place.USER_RATING_COUNT。

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.035 美元 (每 1,000 次 35.00 美元)	每次 0.028 美元 (每 1,000 次 28.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Text Search (Preferred)

您可以在文字搜尋 (新版) 要求中使用欄位遮罩或欄位清單，將回應限制為僅限指定的欄位。當您僅要求下列欄位時，系統就會觸發這個 SKU：

Android：Place.Field.ALLOWS_DOGS、Place.Field.CURBSIDE_PICKUP、Place.Field.DELIVERY、Place.Field.DINE_IN、Place.Field.EDITORIAL_SUMMARY、Place.Field.EV_CHARGE_OPTIONS、Place.Field.FUEL_OPTIONS、Place.Field.GOOD_FOR_CHILDREN、Place.Field.GOOD_FOR_GROUPS、Place.Field.GOOD_FOR_WATCHING_SPORTS、Place.Field.LIVE_MUSIC、Place.Field.MENU_FOR_CHILDREN、Place.Field.OUTDOOR_SEATING、Place.Field.PARKING_OPTIONS、Place.Field.PAYMENT_OPTIONS、Place.Field.RESERVABLE、Place.Field.RESTROOM、Place.Field.REVIEWS、Place.Field.SERVES_BEER、Place.Field.SERVES_BREAKFAST、Place.Field.SERVES_BRUNCH、Place.Field.SERVES_COCKTAILS、Place.Field.SERVES_COFFEE、Place.Field.SERVES_DESSERT、Place.Field.SERVES_DINNER、Place.Field.SERVES_LUNCH、Place.Field.SERVES_VEGETARIAN_FOOD、Place.Field.SERVES_WINE、Place.Field.TAKEOUT

每月用量範圍 (每次呼叫的價格)
0–100,000 次	100,001–500,000 個	500,000 個以上
每次 0.040 美元 (每 1,000 次 40.00 美元)	每次 0.032 美元 (每 1,000 次 32.00 美元)	請聯絡銷售人員洽詢高用量定價資訊

---

SKU：Place Photo

針對每個 API 要求，系統會視為 Place Photo SKU 來計費。

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

---

Places SDK for Android 的定價

以下價格取自 Google 地圖平台定價頁面。如需印度的定價資訊，請參閱印度定價頁面。

關於 Autocomplete 工作階段

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

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

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

• Places API Place Autocomplete 服務或 Maps JavaScript API Places Autocomplete 服務。您必須將應用程式設計為可提供工作階段符記 (可能需要修改現有的程式碼)。
• Maps JavaScript API Autocomplete 小工具。這些小工具會自動啟用按工作階段計費功能，您不需要變更任何程式碼。

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

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

關於地點介面集資料 SKU

三個地點介面集資料 SKU 如下：Basic Data、Contact Data 和 Atmosphere Data。

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

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

對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也一律會針對這類資料 SKU 收費。舉例來說，對於包含 Basic Data 欄位的 Place Details 要求，系統會同時針對 Basic Data SKU「和」Place Details SKU 收費。

---

SKU：Basic Data

注意：這個 SKU 是資料 SKU；對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。

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

• Android： Place.Field.ACCESSIBILITY_OPTIONS、Place.Field.ADDRESS_COMPONENTS、Place.Field.BUSINESS_STATUS、Place.Field.DISPLAY_NAME、Place.Field.FORMATTED_ADDRESS、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_MASK_URL、Place.Field.ID、Place.Field.LOCATION、Place.Field.PHOTO_METADATAS、Place.Field.PLUS_CODE、Place.Field.TYPES、Place.Field.VIEWPORT 或 Place.Field.UTC_OFFSET。
注意：Place.Field.ADDRESS、Place.Field.ICON_URL、Place.Field.LAT_LNG、Place.Field.NAME 和 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.FORMATTED_ADDRESS、Place.Field.ICON_MASK_URL、Place.Field.LOCATION、Place.Field.DISPLAY_NAME 和 Place.ACCESSIBILITY_OPTIONS。Place.Field.ACCESSIBILITY_OPTIONS 僅適用於 Place Details (新版)。
• iOS：GMSPlaceFieldFormattedAddress、GMSPlaceFieldBusinessStatus、GMSPlaceFieldID、GMSPlaceFieldCoordinate、GMSPlaceFieldName、GMSPlaceFieldPhotos、GMSPlaceFieldPlusCode、GMSPlaceFieldTypes 或 GMSPlaceFieldViewport
• 網路服務：address_component、adr_address、business_status、formatted_address、geometry、icon、name、permanently_closed、photo、place_id、plus_code、type、url、utc_offset、vicinity 或 wheelchair_accessible_entrance

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

---

SKU：Contact Data

注意：這個 SKU 是資料 SKU；對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。

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

• Android： Place.Field.CURRENT_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.SECONDARY_OPENING_HOURS 或 Place.Field.WEBSITE_URI
注意：Place.Field.PHONE_NUMBER 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.INTERNATIONAL_PHONE_NUMBER。
• iOS：GMSPlaceFieldOpeningHours、GMSPlaceFieldPhoneNumber 或 GMSPlaceFieldWebsite
• 網路服務：formatted_phone_number、international_phone_number、opening_hours、current_opening_hours、secondary_opening_hours 或 website

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

---

SKU：Atmosphere Data

注意：這個 SKU 是資料 SKU；對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。

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

• Android： Place.Field.CURBSIDE_PICKUP、Place.Field.DELIVERY、Place.Field.EDITORIAL_SUMMARY、Place.Field.DINE_IN、Place.Field.PRICE_LEVEL、Place.Field.RATING、Place.Field.RESERVABLE、Place.Field.SERVES_BEER、Place.Field.SERVES_BREAKFAST、Place.Field.SERVES_BRUNCH、Place.Field.SERVES_DINNER、Place.Field.SERVES_LUNCH、Place.Field.SERVES_VEGETARIAN_FOOD、Place.Field.SERVES_WINE、Place.Field.TAKEOUT或Place.Field.USER_RATING_COUNT
  
  注意：Place.Field.USER_RATINGS_TOTAL 欄位已在 Places SDK for Android 4.0 版中淘汰。請改用 Place.Field.USER_RATING_COUNT。
• iOS：GMSPlaceFieldPriceLevel、GMSPlaceFieldRating、GMSPlaceFieldUserRatingsTotal、GMSPlaceFieldTakeout、GMSPlaceFieldDelivery、GMSPlaceFieldDineIn、GMSPlaceFieldCurbsidePickup、GMSPlaceFieldReservable、GMSPlaceFieldServesBreakfast、GMSPlaceFieldServesLunch、GMSPlaceFieldServesDinner、GMSPlaceFieldServesBeer、GMSPlaceFieldServesWine、GMSPlaceFieldServesBrunch 或 GMSPlaceFieldServesVegetarianFood。
• JavaScript：請參閱欄位 (Place Details)
• 網路服務：curbside_pickup、delivery、dine_in、editorial_summary、price_level、rating、reservable、reviews、serves_beer、serves_breakfast、serves_brunch、serves_dinner、serves_lunch、serves_vegetarian_food、serves_wine、takeout 或 user_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 計費：

• Android： findAutocompletePredictions()
• iOS：findAutocompletePredictionsFromQuery:
• JavaScript：Maps JavaScript API Place Autocomplete 服務
• 網路服務：Places API Place Autocomplete 服務

針對從無效 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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par" ...
• placesClient?.findAutocompletePredictions(fromQuery: "paris" ...

網路服務

• Place Autocomplete 要求 (input=”par”, session_token: XYZ)
• Place Autocomplete 要求 (input=”paris”, session_token: XYZ)

按 SKU 查看帳單時，其中將列出下列 SKU：

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

---

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

注意：這個 SKU 會顯示在帳單報表中，但不會顯示在 Google Cloud 控制台的「帳單」>「定價」頁面上。

針對包含下列任一項目的 Autocomplete 工作階段，系統會以 Autocomplete (included with Place Details) – Per Session SKU 計費：

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

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

Place Details 要求會產生資料 SKU (Basic、Contact 和/或 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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (附帶 FetchPlaceRequest，包含地點 ID 和 ADDRESS 欄位)

iOS

• placesClient?.findAutocompletePredictions(fromQuery: "par" ...
• placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
• fetchPlaceFromPlaceID：(包含地點 ID 和 GMSPlaceFieldFormattedAddress 欄位)

網路服務

• Places Autocomplete 要求 (input=”par”, session_token: XYZ)
• Places Autocomplete 要求 (input=”paris”, session_token: XYZ)
• Places Details (place_id, session_token: XYZ, fields:formatted_address)

按 SKU 查看帳單時，其中將列出下列 SKU：

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

---

SKU：Places Details

「地點詳細資料」呼叫的計費方式如下：

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

下列 API 會產生 Places Details SKU：

• Android：Places SDK for Android (fetchPlace())
• iOS：Places SDK for iOS (fetchPlaceFromPlaceID:)
• JavaScript：Maps JavaScript API Place Details 服務 (getDetails)
• JavaScript：Maps JavaScript API Place Autocomplete 小工具 (getPlace)
• JavaScript：Maps JavaScript API Place SearchBox 小工具：如果使用者選取地點結果 (圖示為圖釘)，「而不是」查詢 (圖示為放大鏡)，系統會呼叫 getPlaces() 方法，請見下圖：

  

  使用者在搜尋框內輸入「pizza」(披薩) 後，您可以在搜尋框小工具顯示的結果中看到「Pizza Autentico」(Autentico 披薩店) 旁邊有圖釘圖示，代表這是地點結果 (而不是查詢)。

• 網路服務：Places API Place Details 服務

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

Place Details 呼叫或要求也會產生資料 SKU (Basic、Contact 和/或 Atmosphere)，視呼叫或要求中指定的欄位而定。如果在 Place Details 呼叫或要求中未指定任何欄位，系統就會觸發所有資料 SKU，並向您收取 Place 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：Find Current Place

針對向 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 (Basic、Contact 和/或 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 美元起)
   • 氣氛資料 (價格為每次要求 0.005 美元起)

---

SKU：Places Photo

針對下列項目，系統會視為 Places Photo SKU 來計費：

• Android：呼叫 fetchPhoto()
• iOS：呼叫 loadPlacePhoto:
• JavaScript：向 PlacePhoto.getUrl() 傳回的網址要求載入圖片像素資料時，呼叫 Maps JavaScript API Places Library 的 Place Photos 服務
• 網路服務：傳送至 Places API Place Photos 服務的要求

如果是 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 地圖平台服務條款》的「授權限制」部分。

管理使用成本

如要管理 Places SDK for Android 的使用成本，或是滿足對實際執行環境流量的需求，您可以針對傳送至任何 API 的所有要求設定每日配額限制。系統會在太平洋時間凌晨 12 點重設每日配額。

注意：您只能設定可計費 API 的每日可計費配額上限。如果您的專案未使用任何可計費 API，就無法設定每日上限。

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

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

假如某天的 API 用量達到可計費配額上限，在當天剩餘時間內，應用程式將無法存取 API。

相關成本管理資源

• Google 地圖平台計費方式與定價
• Google 地圖平台報表與監控

---