本頁面由 Cloud Translation API 翻譯而成。

Places SDK for Android 用量與計費方式

錯誤：9005 PLACES_API_RATE_LIMIT_EXCEEDED

按一下「資訊」圖示，查看這個頁面的目錄。

Places SDK for Android 的計費和定價

如要瞭解 Google 計算您的帳單和價格的方式，請參閱 Google 地圖平台價格表或 Google 地圖平台價格表 - 印度。

Places SDK for Android 產品 SKU 詳細資料

關於欄位遮罩

在要求中使用欄位遮罩 (又稱為「欄位清單」)，指定要在回應中傳回的欄位清單。系統會以您要求的最高 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 要求) 之後，您必須使用新的工作階段符記來啟動新的工作階段。

工作階段符記適用於單一工作階段，不應用於多個工作階段。假如您重複使用工作階段符記，系統會將工作階段視為無效，並針對相關要求收費 (因為系統會將其視為未提供工作階段符記)。

SKU：自動完成要求

針對未使用工作階段的 Autocomplete API 要求，系統會以此 SKU 計費。如要瞭解如何使用工作階段來限制單一自動完成工作階段中計費的要求數量，請參閱「工作階段符記」或「SKU：自動完成工作階段使用量」。

	類別	Essentials
	可計費事件	要求
	觸發條件	這個 SKU 會在下列情況下觸發：您的要求未包含工作階段權杖。您的要求包含工作階段權杖，但您放棄了工作階段。您的要求包含工作階段權杖，但您會在特定情況下終止工作階段。如要瞭解自動完成工作階段用量，請參閱「工作階段符記」或「自動完成工作階段用量」。
	定價	主要價目表印度價目表

SKU：Autocomplete 工作階段使用量

針對每項包含工作階段符記的 Autocomplete (新版) API 要求，系統會以此 SKU 計費。

	類別	Essentials
	可計費事件	要求
	觸發條件	向 Autocomplete (新版) API 傳送包含工作階段符記的要求時，系統會觸發這個 SKU。這個 SKU 是 Autocomplete (New) 要求 SKU 的包裝函式，可讓您限制在單一 Autocomplete 工作階段中計費的要求數量。如要瞭解 Autocomplete 工作階段用途，請參閱「工作階段符記」。注意：如果您未使用自動完成工作階段 (新版)，系統會以 SKU：自動完成要求計費，每項自動完成要求收費。詳情請參閱「自動完成 (新功能) 和會話定價」。
	定價	主要價目表印度價目表

SKU：Places API Place Details Essentials (IDs Only)

針對只傳回 Place ID 的 Place Details 要求，系統會以此 SKU 計費。

	類別	Essentials
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求下列欄位時，系統會觸發這個 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` 存取地點的文字名稱。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Place Details Essentials

針對傳送至 Place Details API 的要求，如果是擷取此 SKU 中的欄位，系統會以此 SKU 計費。

	類別	Essentials
	可計費事件	使用指定的欄位遮罩提出要求。
	觸發條件	要求下列位置欄位時，系統會觸發這個 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`。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Place Details Pro

這個 SKU 會針對您在 Place Details Pro 要求中指定的欄位收費。

	類別	Pro
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	當您僅要求下列欄位或費率較低的欄位時，就會觸發這個 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 (新版)。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Place Details Enterprise

這個 SKU 會針對包含 Enterprise 欄位的 Places 要求收費。

	類別	Enterprise
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求下列欄位時，系統會觸發這個 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`。如果您使用 Place Details 呼叫終止 Autocomplete 工作階段，且該呼叫要求任何欄位 (來自 SKU：Place Details (Basic、Advanced 或 Preferred))，系統會以 SKU：Place Details (Preferred) 計費。詳情請參閱「SKU：自動完成工作階段使用量」。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Place Details Enterprise + Atmosphere

這個 SKU 會針對要求指定氣氛欄位的 Place Details API 呼叫收費。

	類別	Enterprise
	可計費事件	要求
	觸發條件	要求下列欄位時，系統會觸發這個 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` 如果 Autocomplete 工作階段是由 Place Details 呼叫終止，而該呼叫要求 SKU：Place Details (Basic、Advanced 或 Preferred) 中的任何欄位，則系統會以 SKU：Place Details (Preferred) 計費。詳情請參閱「SKU：自動完成工作階段用量」。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Nearby Search Pro

這個 SKU 會針對您在 Nearby Search Pro 要求中指定的欄位收費。

	類別	Pro
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	當您僅要求下列欄位或費率較低的欄位時，就會觸發這個 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`
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Nearby Search Enterprise

這個 SKU 會針對包含任何企業版欄位的附近搜尋要求收費。

	類別	Enterprise
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求下列欄位時，系統會觸發這個 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`。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要定價表印度定價表

SKU：Places API Nearby Search Enterprise + Atmosphere

這個 SKU 會針對包含指定 atmostphere 欄位的附近搜尋要求收費。

	類別	Enterprise
	可計費事件	要求
	觸發條件	要求下列欄位時，系統會觸發這個 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`
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Text Search Essentials (IDs Only)

針對只傳回 ID 的 Text Search API 要求，系統會以此 SKU 計費。

	類別	Essentials
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	當您僅要求下列欄位時，系統就會觸發這個 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` 存取地點的文字名稱。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要定價表印度定價表

SKU：Places API Text Search Pro

這個 SKU 是資料 SKU，會針對您在 Text Search Pro 要求中指定的欄位收費。

	類別	Pro
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	當您「僅」要求下列欄位或較低費率的欄位時，就會觸發這個 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 (新版)。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Text Search Enterprise

這個 SKU 會針對包含任何 Enterprise 欄位的文字搜尋要求收費。

	類別	Enterprise
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求下列欄位時，系統會觸發這個 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`。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Places API Text Search Enterprise + Atmosphere

這個 SKU 會針對包含任何氣氛欄位的 Text Search 要求收費。

	類別	Enterprise
	可計費事件	要求
	觸發條件	要求下列欄位時，系統會觸發這個 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`
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Place Details Photos

這個 SKU 會針對 Place Details 相片要求收費。

	類別	Enterprise
	可計費事件	要求
	觸發條件	您向 Place Details API 要求相片時，系統就會啟動計費。
	定價	主要價目表印度價目表

Places SDK for Android 舊版 SKU 詳細資料

關於 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，會針對 Place Details 或 Find Place 要求中的 Basic Data 欄位收費。對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。

「Basic」類別中的欄位已包含地點介面集要求的基本費用，因此不會產生任何額外費用。

	類別	Essentials
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求以下任一欄位都會觸發 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`。已淘汰的欄位：在 Places SDK for Android 4.0 版中，下列欄位已淘汰：`Place.Field.ADDRESS`、`Place.Field.ICON_URL`、`Place.Field.LAT_LNG`、`Place.Field.NAME` 和 `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` 欄位。請改用 `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`
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Contact Data

這個 SKU 是資料 SKU，會針對 Place Details 或 Find Place 要求中的Contact Data 欄位收費。對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。

您可以使用 Place Details 或 Find Place 要求中的欄位參數 (適用於網路服務)，或是 Place.Field 的陣列 (適用於 Android 或 iOS)，將回應限制為僅限指定的欄位。「聯絡資訊」類別中的欄位會產生額外費用。

	類別	Enterprise
	可計費事件	使用指定的欄位遮罩要求。
	觸發條件	要求以下任一欄位都會觸發 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`
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Atmosphere Data

針對傳送至 Atmosphere Data API 的要求，如果指定此 SKU 中的欄位，系統就會以此 SKU 計費。

	類別	Enterprise
	可計費事件	使用指定的欄位遮罩提出要求。
	觸發條件	要求下列任一欄位都會觸發計費： 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`。
	欄位遮罩計費範例	以下是根據您在欄位遮罩中選取的欄位，說明要求的計費方式。如果要求欄位遮罩只包含這個 SKU 的欄位：系統會以這個 SKU 的費率計費。舉例來說，您可以要求這個 SKU 的一或多個欄位，並以這個 SKU 的費率付費。如果您的要求欄位遮罩包含其他 SKU 的欄位：系統會以要求欄位的最高 SKU 費率計費。舉例來說，如果您納入多個 SKU 的欄位 (例如 Essentials SKU 和 Enterprise SKU)，系統會以 Enterprise SKU 的費率計費。
	定價	主要價目表印度價目表

SKU：Autocomplete – Per Request

針對不含工作階段符記的要求收取費用

如果您透過無效的 Autocomplete 工作階段 (例如重複使用工作階段符記的工作階段) 提出要求，系統也會以 Autocomplete – Per Request SKU 計費。

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

	類別	Essentials
	可計費事件	要求
	觸發條件	系統會針對以下項目啟動帳單： Android： `findAutocompletePredictions()` iOS： `findAutocompletePredictionsFromQuery:` JavaScript： Maps JavaScript API 的 Place Autocomplete 服務網路服務： Places API Place Autocomplete 服務
	定價	主要價目表印度價目表

SKU：Autocomplete without Place Details – Per Session

針對Autocomplete 工作階段 (在工作階段起始的幾分鐘內)，如果不含 Place Details 要求，系統會以此 SKU 計費。

	類別	Pro
	可計費事件	工作階段
	觸發條件	如果應用程式在單一工作階段中發出下列兩個要求，系統就會觸發帳單功能： 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
	定價	主要定價表印度定價表

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

系統不會針對自動完成要求收費。當您根據一般 Places Details 定價要求後續 Place Details 時，系統就會收取這項 SKU 的費用。

	類別	Essentials
	可計費事件	工作階段
	觸發條件	針對包含下列任一要求的 Autocomplete 工作階段，系統會以 Autocomplete (included with Place Details) – Per Session SKU 計費： Android：呼叫 `fetchPlace()` iOS：呼叫 `fetchPlaceFromPlaceID:` 網路服務：Place Details 要求 Place Details 要求會產生資料 SKU (Basic、Contact 和/或 Atmosphere)，視要求中指定的欄位而定。如果您未在地點詳細資料要求中要求特定欄位，則所有資料 SKU (Essentials、Pro、Enterprise 和 Enterprise + Atmosphere) 都會觸發。請只指定所需的欄位，以免產生不必要的費用。如果您在 Autocomplete 工作階段期間只要求重新整理 Place Details ID (要求只指定 `place_id` 欄位)，系統會以 SKU：Autocomplete without Place Details – Per Session 計費。
	範例	如果您的應用程式在單一工作階段中發出下列三個呼叫： Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (含有 `FetchPlaceRequest`，其中包含 Place 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 Place Details 基本資料
	定價	主要價目表印度價目表

SKU：Place Details Pro

這個 SKU 會針對舊版 Place Details 要求收費。

	類別	Pro
	可計費事件	要求
	觸發條件	系統會針對來自下列 API 的要求觸發帳單： 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」旁邊有圖釘圖示，表示這是地點結果 (而非查詢)。網路服務： Places API Place Details 服務使用網路 API 和服務時，無論是否提供工作階段符記，系統都會以 Place Details SKU 計費。這個 SKU 也會觸發資料 SKU 的計費：如果您在要求中加入資料欄位，系統可能會針對以下資料 SKU 額外收費：Basic、Contact 和 Atmosphere。請只指定要避免產生不必要費用的資料欄位。系統會向您收取這個 SKU 的費用，以及您要求的資料費用。
	範例	進行下列其中一項呼叫或要求：行動裝置：在 Android 上呼叫 `fetchPlace()` 或在 iOS 上呼叫 `fetchPlaceFromPlaceID:`，且只指定 `ADDRESS` 欄位 Web API 或服務：發出 Place Details 要求，且只指定地址欄位：`getPlaceDetails(fields: formatted_address)` 按 SKU 查看帳單時，其中將列出下列 SKU： Place Details Basic Data 進行下列其中一項呼叫或要求：行動裝置：在 Android 上呼叫 `fetchPlace()` 或在 iOS 上呼叫 `fetchPlaceFromPlaceID:`，且只指定 `PHONE_NUMBER` 欄位 Web API 或服務：發出 Place Details 要求，並指定電話號碼欄位：`getPlaceDetails(fields: formatted_phone_number)` 按 SKU 查看帳單時，其中將列出下列 SKU： Place Details Contact Data 進行下列其中一項呼叫或要求：行動裝置：在 Android 上呼叫 `fetchPlace()` 或在 iOS 上呼叫 `fetchPlaceFromPlaceID:`，且指定所有欄位 Web API 或服務：發出 Place Details 要求，且指定所有欄位 (如果您未指定任何欄位，這類要求會採用此預設值)：`getPlaceDetails()`。按 SKU 查看帳單時，其中將列出下列 SKU： Place Details Basic Data Contact Data Atmosphere Data
	定價	主要定價表印度定價表

SKU：Find Current Place

這個 SKU 會針對「尋找目前所在地點」要求收費。

這個 SKU 也會觸發資料 SKU 的計費：如果您在要求中加入資料欄位，系統可能會針對以下資料 SKU 額外收費：Basic、Contact 和 Atmosphere。請只指定要避免產生不必要費用的資料欄位。系統會向您收取這個 SKU 的費用，以及您要求的資料費用。

	類別	Pro
	可計費事件	要求
	觸發條件	這個 SKU 會針對下列方法的請求收費： `findCurrentPlace()` (Android) `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 這個 SKU 也會觸發資料 SKU 的計費：如果您在要求中加入資料欄位，系統可能會針對以下資料 SKU 額外收費：Basic、Contact 和 Atmosphere。請只指定要避免產生不必要費用的資料欄位。系統會向您收取這個 SKU 的費用，以及您要求的資料費用。
	範例	以下範例說明在提出 Find Current Place 要求，並指定 Basic、Contact 和 Atmosphere 資料 SKU 欄位時，系統會向您收取哪些 SKU 費用。如要查看帳單中的 SKU，請按照「依據 SKU 分析用量與費用」一節所述，依 SKU 查看帳單。您發出 `findCurrentPlace()` (Android) 或 `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 要求，且只指定 `ADDRESS` 欄位。帳單會顯示下列 SKU： Find Current Place 基本資料您發出 `findCurrentPlace()` (Android) 或 `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 要求，並指定 `PHONE_NUMBER` 欄位。帳單會顯示下列 SKU： Find Current Place 聯絡資料您發出 `findCurrentPlace()` (Android) 或 `findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:` (iOS) 要求，並指定全部三個資料類型值區的欄位。帳單會顯示下列 SKU： Find Current Place Basic Data Contact Data Atmosphere Data
	定價	主要價目表印度價目表

SKU：Places API Place Details Photos

這個 SKU 會針對舊版 Places Photo 服務計費。

	類別	Enterprise
	可計費事件	要求
	觸發條件	系統會針對以下項目啟動帳單： Android：呼叫 `fetchPhoto()` iOS：呼叫 `loadPlacePhoto:` JavaScript：向 `PlacePhoto.getUrl()` 傳回的網址要求載入圖片像素資料時，呼叫 Maps JavaScript API Places Library 的 Place Photos 服務。除非將網址實際用於取得像素資料，否則不會觸發帳單費用。網路服務：傳送至 Places API Place Photos 服務的要求
	定價	主要定價表印度定價表

使用條款限制

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