Google 地圖平台 API 使用量詳細資料

本頁面詳細說明 Google 地圖平台 SKU，包括印度的 SKU。

庫存單位 (SKU) 是 Google 地圖平台與產品相關聯的獨特項目，一個產品可以有多個相關聯的 SKU。每個 SKU 都有固定價格，您可以在價格清單 (定價、定價 - 印度) 中查看。使用服務時，可能會觸發一或多個 SKU，每個 SKU 都會列為帳單上的獨立明細項目。

SKU 名稱

本節會依名稱列出所有 SKU，並分為 Essentials、Pro 和 Enterprise。這是帳單上顯示的名稱。

  • 以粗體底線標示的 SKU 名稱已更新。
  • 將指標懸停在上方即可查看先前的 SKU 名稱，然後按下 Esc 鍵即可關閉。

如需價格類別的說明，請參閱「帳單總覽」指南中的「Essentials、專業版和企業版類別」。

Essentials

地圖 路徑介面集 地點 環境

Dynamic Maps

Embed1

Maps SDK2

Static Maps

Static Street View

靜態街景中繼資料

Map Tiles API：2D 地圖圖塊

Map Tiles API：街景服務圖塊

Routes：Compute Routes Essentials

Routes：Compute Route Matrix Essentials

自動完成要求

自動完成工作階段用量

Geocoding

Geolocation

Places API Place Details Essentials (僅限 ID)

Places API Place Details Essentials

Places API Text Search Essentials (僅限 ID)

Places UI Kit - per Request

Places UI Kit - Autocomplete per Session

Time Zone

空氣品質使用情況

Solar API Building Insights

天氣用量

1 Embed 和 Embed Advanced 現在已合併為單一 SKU：Embed。這些服務的其他部分則維持不變。

2 Mobile Native Static Maps 和 Mobile Native Dynamic Maps 現在已合併為單一 SKU：Maps SDK。這些服務的其他部分則維持不變。

Pro

地圖 路徑介面集 地點 環境

鳥瞰圖

Dynamic Street View

海拔高度

Roads - Nearest Road

Roads - Route Traveled

Roads - Speed Limits

RouteOptimization - SingleVehicleRouting

路徑：Compute Routes Pro

Routes：Compute Route Matrix Pro

Address Validation Pro

Places API Nearby Search Pro

Places API Place Details Pro

Places API Text Search Pro

Places Aggregate API Pro

花粉使用方式

Enterprise

地圖 路徑介面集 地點 環境

Map Tiles API： 擬真成像 3D 圖塊

RouteOptimization - FleetRouting

Routes：Compute Routes Enterprise

Routes：Compute Route Matrix Enterprise

導航要求

Address Validation Enterprise

Places API Nearby Search Enterprise

Places API Nearby Search Enterprise + Atmosphere

Places API Place Details Enterprise

Places API Place Details Enterprise + Atmosphere

Places API Place Details Photos

Places API Text Search Enterprise

Places API Text Search Enterprise + Atmosphere

Solar API 資料層

關於 SKU 表格

以下各節將說明各個 SKU 的詳細資料：

類別 SKU 屬於 Essentials、專業版或企業版 SKU 類別。
可計費事件 系統會針對 SKU 計費的事件。
觸發條件 哪些程式碼元素會觸發可計費事件。
定價 該 SKU 群組的價目表連結。

地圖產品 SKU

[ Essentials: Maps ]

SKU：Dynamic Maps

  類別 Essentials
  API Maps JavaScript API
  可計費事件 地圖載入成功
  觸發條件
  定價 主要價目表
印度價目表

SKU：Embed

  類別 Essentials
  API Embed API
  可計費事件 要求成功
  觸發條件 傳送給 Embed API 的要求。
  定價 主要價目表
印度價目表

SKU：Maps SDK

  類別 Essentials
  API Maps SDK for Android
Maps SDK for iOS
  可計費事件 地圖載入
  觸發條件

使用者與地圖之間的互動 (例如平移、縮放或切換地圖圖層) 不會產生額外的地圖載入量。
  定價 主要價目表
印度價目表

SKU：Static Maps

  類別 Essentials
  API Maps Static API
  可計費事件 地圖載入
  觸發條件 成功向 Maps Static API 傳送地圖載入要求。
  定價 主要價目表
印度價目表

SKU：Static Street View

這個 SKU 會針對向 Street View Static API 發出的要求計費，這些要求會傳回靜態街景服務全景。

  類別 Essentials
  API Street View Static API
  可計費事件 全景載入
  觸發條件

向 Street View Static API 提出的靜態街景服務全景要求成功。
  注意事項
  定價 主要價目表
印度價目表

SKU：Static Street View Metadata

  類別 Essentials
  API Street View Static API
  可計費事件 僅要求中繼資料成功
  觸發條件 向 Street View Static API 提出僅限中繼資料的要求並成功。詳情請參閱「街景服務圖片中繼資料」。
  定價 主要價目表
印度價目表

[ Pro: Maps ]

SKU：Aerial View

  類別 Pro
  API Aerial View API
  可計費事件 成功要求 Pro 資料
  觸發條件

lookupVideo 方法。

  定價 主要價目表
印度價目表

SKU：Dynamic Street View

  類別 Pro
  API Maps JavaScript API
  可計費事件 全景載入成功
  觸發條件
  定價 主要價目表
印度價目表

SKU：Elevation

  類別 Pro
  API Maps JavaScript API、
Elevation API
  可計費事件 要求成功
  觸發條件
  定價 主要價目表
印度價目表

地圖圖塊 - 2D 和街景圖塊

[ Essentials: Map Tiles ]

SKU：Map Tiles API：2D 地圖圖塊

  類別 Essentials
  API Map Tiles API
  可計費事件 傳回 2D 地圖圖塊的要求
  觸發條件
  • 2D 地圖圖塊 - 道路圖
  • 2D 地圖圖塊 -「衛星」
  • 2D 地圖圖塊 - 地形
  定價 主要價目表
印度價目表

SKU：Map Tiles API：街景服務圖塊

  類別 Essentials
  API Map Tiles API
  可計費事件 成功要求街景服務圖塊
  觸發條件
  • Street View Tiles
  • 街景服務縮圖
  • 街景服務全景 ID
  注意事項
  定價 主要價目表
印度價目表

地圖圖塊 - 3D 圖塊

[ Enterprise：地圖圖塊 ]

SKU：Map Tiles API：擬真成像 3D 圖塊

  類別 Enterprise
  API Map Tiles API
  可計費事件 傳回 3D 圖塊的要求
  觸發條件 3D 圖塊。
  定價 主要價目表
印度價目表

路徑介面集產品 SKU

[ Essentials: Routes ]

SKU：Routes：Compute Routes Essentials

  類別 Essentials
  API Compute Routes
  可計費事件 要求成功，但未使用 Pro 或 Enterprise 功能
  觸發條件 傳送至 Compute Routes 的要求。這類要求不會使用 Pro 或 Enterprise 功能。
  定價 主要價目表
印度價目表

SKU：Routes：Compute Route Matrix Essentials

  類別 Essentials
  API Compute Route Matrix
  可計費事件 每個元素都會傳回，但沒有 Pro 或 Enterprise 功能
  觸發條件 傳送至 Compute Route Matrix 的要求，這類要求未使用 Pro 或 Enterprise 功能。
  定價 主要價目表
印度價目表

[ Pro: Roads and Routes ]

SKU：Roads – Nearest Road

  類別 Pro
  API Roads API Nearest Roads 服務
  可計費事件 要求成功
  觸發條件 傳送至 Roads API Nearest Roads 服務的要求。
  定價 主要價目表
印度價目表

SKU：Roads – Route Traveled

  類別 Pro
  API Roads API
  可計費事件 要求成功
  觸發條件 比對路徑服務。
  定價 主要價目表
印度價目表

SKU：Roads – Speed Limits

  類別 Pro
  API Roads API
  可計費事件 API 回應中傳回的元素。
  觸發條件 速限服務 - 存取權受限
  定價 主要價目表
印度價目表

SKU：Route Optimization：Single Vehicle Routing

  類別 Pro
  API Route Optimization API
  可計費事件 成功提出出貨要求，且指定一輛車。
  觸發條件 路線最佳化出貨要求，其中指定一輛車。
  範例

如果路線最佳化要求有下列情況：

  • 1 輛車
  • 10 個不重複的貨運 (10 個不重複的貨運地點或裝載)

系統會針對單一車輛路線 SKU 中的 10 筆出貨記錄觸發帳單。如果同一項要求包含 5 輛車，系統會改用 Route Optimization：車隊路線規劃 SKU 計費。

系統不會針對下列貨件收費：

  • 因驗證錯誤 (例如語法或資料驗證錯誤) 或任何內部服務錯誤而導致要求失敗的貨件。
  • VALIDATE_ONLY 解決模式 (僅執行驗證) 中的要求。
  • 在驗證時判定為不可行的貨運，或明確忽略、排除在最佳化範圍外，或因 InjectedSolutionConstraint 而無法最佳化的貨運。
  定價 主要價目表
印度價目表

SKU：Routes：Compute Routes Pro

  類別 Pro
  API Compute Routes
  可計費事件 成功要求 (使用 Pro 版功能)
  觸發條件
  定價 主要價目表
印度價目表

SKU：Routes：Compute Route Matrix Pro

  類別 Pro
  API Compute Route Matrix
  可計費事件 透過 Pro 功能傳回的每個元素
  觸發條件
  定價 主要價目表
印度價目表

[ Enterprise：Route Optimization、Routes ]

SKU：Route Optimization：Fleet Routing

  類別 Enterprise
  API Route Optimization API
  可計費事件 每項成功運送多輛車的要求。
  觸發條件 已成功為多部車輛提出運送要求。

系統不會針對下列貨件收費：

  • 因驗證錯誤 (例如語法或資料驗證錯誤) 或任何內部服務錯誤而導致要求失敗的貨件。
  • VALIDATE_ONLY 解決模式 (僅執行驗證) 中的要求。
  • 在驗證時判定為不可行的貨運，或明確忽略、排除在最佳化範圍外，或因 InjectedSolutionConstraint 而無法最佳化的貨運。
  範例

如果路線最佳化要求有下列情況：

  • 5 輛車
  • 10 個不重複的貨運 (10 個不重複的貨運地點或裝載)

系統會針對 Fleet Routing SKU 中的 10 筆出貨記錄觸發計費。如果同一項要求只包含一輛車，系統會改為以 Route Optimization: Single Vehicle SKU 計費。
  定價 主要價目表
印度價目表

SKU：Routes：Compute Routes Enterprise

  類別 Enterprise
  API Compute Routes
  可計費事件 成功要求企業版功能
  觸發條件
  定價 主要價目表
印度價目表

SKU：Routes：Compute Route Matrix Enterprise

  類別 Enterprise
  API Compute Route Matrix
  可計費事件 透過 Enterprise 功能傳回的每個元素
  觸發條件
  定價 主要價目表
印度價目表

[ Enterprise: Navigation ]

Navigation SDK 包括：Navigation SDK for Android 和 Navigation SDK for iOS。

  類別 Enterprise
  SDK Navigation SDK for Android
Navigation SDK for iOS
  可計費事件 每個目的地
  觸發條件

Android SDK

iOS SDK
  範例

每通電話的費用計算方式為目的地數量乘以每個 SKU 的價格。請注意，單一方法呼叫最多可包含 25 個目的地。
  定價 主要價目表
印度價目表

地點 (新版) 產品 SKU

[ 基礎知識：Places、Geocoding、Geolocation ]

SKU：Autocomplete Requests

  類別 Essentials
  API Android 版 Place Autocomplete、
iOS 版 Place Autocomplete、
Maps JavaScript API Place Autocomplete 小工具、
Place Autocomplete 網頁版
  可計費事件 要求沒有工作階段權杖，或權杖無效/過期
  觸發條件

在下列情況下，系統會觸發這個 SKU：

  • 要求未包含會期權杖。
  • 要求中包含工作階段權杖，但您放棄工作階段。
  • 您的要求包含工作階段權杖，但您會在特定情況下終止工作階段。如要瞭解 Autocomplete 工作階段用量，請參閱「工作階段符記」或「Autocomplete 工作階段用量」。
  範例 使用工作階段可限制單一 Autocomplete 工作階段的計費要求數量。詳情請參閱「工作階段符記」或「SKU：Autocomplete 工作階段用量」。
  定價 主要價目表
印度價目表

SKU：Autocomplete Session Usage

  類別 Essentials
  API Android 版 Place Autocomplete、
iOS 版 Place Autocomplete、
Maps JavaScript API Place Autocomplete 小工具、
Place Autocomplete 網頁版
  可計費事件 使用工作階段權杖提出要求
  觸發條件

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

這個 SKU 可做為 Autocomplete (New) 要求 SKU 的包裝函式，讓您限制單一 Autocomplete 工作階段的計費要求數量。如要瞭解 Autocomplete 工作階段用量，請參閱「工作階段符記」。
  定價 主要價目表
印度價目表

SKU：Geocoding

  類別 Essentials
  API Maps JavaScript API Geocoding 服務、
Geocoding API
  可計費事件 要求成功
  觸發條件
  定價 主要價目表
印度價目表

SKU：Geolocation

  類別 Essentials
  API Geolocation API
  可計費事件 要求成功
  觸發條件 傳送給 Geolocation API 的要求。
  定價 主要價目表
印度價目表

SKU：Places API Place Details Essentials (IDs Only)

  類別 Essentials
  API Places API Place Details
  可計費事件 僅要求 ID 欄位時成功
  觸發條件

Android SDK 的欄位

Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME

Fields for iOS

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

Maps JavaScript API Places Library 的欄位

id
photos

網路服務的欄位

attributions
id
name*
photos

* name 欄位包含地點資源名稱，格式為 places/PLACE_ID。如要取得地點的文字名稱，請在 Pro SKU 中要求 displayName 欄位。

 使用 Place Details Essentials (IDs Only) 要求終止工作階段，等同於不使用工作階段。
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Place Details Essentials

  類別 Essentials
  API Places API Place Details
  可計費事件 只要求基本欄位
  觸發條件

Android SDK 的欄位

Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
    * 請改用這個函式，不要使用 Place.Field.ADDRESS (已淘汰)。
Place.Field.LOCATION*
    * 請改用這個方法，不要使用 Place.Field.LAT_LNG (已淘汰)。
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

Fields for iOS

GMSPlacePropertyAddressComponents
GMSPlacePropertyFormattedAddress
GMSPlacePropertyCoordinate
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyViewport

Maps JavaScript API Places Library 的欄位

addressComponents
adrFormatAddress
formattedAddress
location
plusCode
types
viewport

網路服務的欄位

addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

* 地址描述符號通常適用於印度境內的消費者，其他地區則為實驗功能。
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Text Search Essentials (IDs Only)

  類別 Essentials
  API 文字搜尋 (新功能)
  可計費事件 僅要求 ID 成功。
  觸發條件

Android SDK

Place.Field.DISPLAY_NAME*
    * 請改用這個方法，不要使用 Place.Field.NAME (已在 4.0 版中淘汰)。
Place.Field.ID
Place.Field.RESOURCE_NAME*
    * 包含地點資源名稱，格式為：places/PLACE_ID。
     使用 DISPLAY_NAME 存取地點的文字名稱。

iOS

GMSPlacePropertyPlaceID

Maps JavaScript API Places Library

id

網路服務

places.attributions
places.id
places.name*
nextPageToken

* places.name 欄位包含地點資源名稱，格式為 places/PLACE_ID。在 Pro SKU 中使用 places.displayName 存取地點的文字名稱。
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places UI Kit - per Request


  類別 Essentials
  API Places UI Kit Android、
Places UI Kit iOS、
Places UI Kit JavaScript
  可計費事件 要求
  觸發條件 從 Places UI Kit 要求 Place Details 和 Place Search 元素時，就會觸發這項 SKU。無論 UI Kit 中顯示哪些欄位，使用者每次提出 Places UI Kit 要求，系統都會只針對這個 SKU 收費。

Android

Place Details 元件
Place Search 元件

iOS

Place Details 元件
Place Search 元件

JavaScript

Place Details 元素
Place Search 元素

  定價 主要價目表
印度價目表

SKU：Places UI Kit - Autocomplete per Session

  類別 Essentials
  API Places UI Kit Android、
Places UI Kit iOS、
Places UI Kit JavaScript
  可計費事件 工作階段
  觸發條件 Places UI Kit Basic Autocomplete 要求會觸發這項 SKU：

Android

基本自動完成元件

iOS

基本自動完成元件

JavaScript

基本自動完成元素
  定價 主要價目表
印度價目表

SKU：Time Zone

  類別 Essentials
  API Time Zone API
  可計費事件 要求成功
  觸發條件 成功傳送給 Time Zone API 的要求。
  定價 主要價目表
印度價目表

[ Pro: Address Validation, Places ]

SKU：Address Validation Pro

  類別 Pro
  API Address Validation API
  可計費事件 要求成功
  觸發條件
  定價 主要價目表
印度價目表

SKU：Places API Nearby Search Pro

  類別 Pro
  API 搜尋附近地點 (新功能)
  可計費事件 成功要求 Pro 欄位。
  觸發條件

Android SDK

Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.DISPLAY_NAME >*
    * 請改用這個標記，Place.Field.NAME 已淘汰。
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
    * 請改用這個函式，因為 Place.Field.ICON_URL 已淘汰。
Place.Field.ID
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.RESOURCE_NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

iOS SDK

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Maps JavaScript API Places Library

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

網路服務

places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.attributions
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.id
places.location
places.name**
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* 地址描述符號通常適用於印度境內的消費者，其他地區則為實驗功能。

** places.name 欄位包含地點資源名稱，格式為：places/PLACE_ID。使用 places.displayName 存取地點的文字名稱。
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Place Details Pro

  類別 Pro
  API Places API Place Details
  可計費事件 成功要求 Pro 欄位
  觸發條件

Android SDK 的欄位

Place.Field.ACCESSIBILITY_OPTIONS*
    * 請改用這個函式，不要使用 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (已淘汰)。
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
    * 請改用這個函式，因為 Place.Field.NAME 已淘汰。
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
    * 請改用這個函式，不要使用 Place.Field.ICON_URL (已淘汰)。
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

Fields for iOS

GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance

Maps JavaScript API Places Library 的欄位

accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes

網路服務的欄位

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Text Search Pro

  類別 Pro
  API 文字搜尋 (新功能)
  可計費事件 成功要求 Pro 欄位。
  觸發條件

Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    請改用這個函式，不要使用 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (已淘汰)。
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS*
    請改用這個函式，不要使用 Place.Field.ADDRESS (已淘汰)。
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL *
    請改用這個函式，不要使用 Place.Field.ICON_URL (已淘汰)。
Place.Field.LOCATION*
    請改用這個函式，不要使用 Place.Field.LAT_LNG (已淘汰)。
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

iOS

GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyPhotos
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance

Maps JavaScript API Places Library

accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport

網路服務

places.accessibilityOptions
places.addressComponents
places.addressDescriptor*
places.adrFormatAddress
places.businessStatus
places.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
places.googleMapsUri
places.iconBackgroundColor
places.iconMaskBaseUri
places.location
places.photos
places.plusCode
places.postalAddress
places.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport

* 地址描述符號通常適用於印度境內的消費者，其他地區則為實驗功能。
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places Aggregate Pro

  類別 Pro
  API Places Aggregate API
  可計費事件 成功要求 Pro 版功能
  觸發條件
  定價 主要價目表
印度價目表

[ 企業：地址驗證、地點 ]

SKU：Address Validation Enterprise

  類別 Enterprise
  API Address Validation API
  可計費事件 工作階段在要求地址驗證時終止
  觸發條件
  • 在 ValidateAddress (REST) 方法中終止的自動完成 (新版) 工作階段。
  • 在 ValidateAddress (gRPC) 方法中終止的自動完成 (新版) 工作階段。
  定價 主要價目表
印度價目表

如要瞭解定價和如何搭配使用 Autocomplete (New) 工作階段與 Places API，請參閱 Places API 說明文件中的下列指南：

SKU：Places API Nearby Search Enterprise

  類別 Enterprise
  API 搜尋附近地點 (新功能)
  可計費事件 已成功要求企業欄位。
  觸發條件

Android SDK

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * 請改用這個函式，Place.Field.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.USER_RATINGS_TOTAL 已淘汰。
Place.Field.WEBSITE_URI

iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Maps JavaScript API Places Library

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

網路服務

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Nearby Search Enterprise + Atmosphere

  類別 Enterprise
  API 搜尋附近地點 (新功能)
  可計費事件 成功要求取得氛圍欄位。
  觸發條件

Android SDK

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

iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Maps JavaScript API Places Library

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

網路服務

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* 僅限文字搜尋和附近搜尋
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Place Details Enterprise

  類別 Enterprise
  API Places API Place Details
  可計費事件 成功要求企業版欄位
  觸發條件

Android SDK 的欄位

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * 請改用這個函式，Place.Field.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.USER_RATINGS_TOTAL 已遭淘汰。
Place.Field.WEBSITE_URI

Maps JavaScript API Places Library 的欄位

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

Fields for iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

網路服務的欄位

currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Place Details Enterprise + Atmosphere

  類別 Enterprise
  API Places API Place Details
  可計費事件 成功要求 Enterprise + Atmosphere 欄位
  觸發條件

Android SDK 的欄位

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

iOS 版 SDK 的欄位

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Maps JavaScript API Places Library 的欄位

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

網路服務的欄位

allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout

* 僅限文字搜尋和附近搜尋
  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Place Details Photo

  類別 Enterprise
  API Places API 地點詳細資料相片
  可計費事件 成功要求提供相片
  觸發條件 要求提供相片。
  定價 主要價目表
印度價目表

SKU：Places API Text Search Enterprise

  類別 Enterprise
  API 文字搜尋 (新功能)
  可計費事件 已成功要求企業欄位。
  觸發條件 要求下列欄位時，系統會觸發這個 SKU：

Android SDK 的欄位

Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
    * 請改用這個函式，Place.Field.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.USER_RATINGS_TOTAL 已淘汰。
Place.Field.WEBSITE_URI

iOS 版 SDK 的欄位

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

Maps JavaScript API Places Library 的欄位

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

網路服務的欄位

places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri

  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places API Text Search Enterprise + Atmosphere

  類別 Enterprise
  API 文字搜尋 (新功能)
  可計費事件 成功要求 Enterprise + Atmosphere 欄位。
  觸發條件

Android SDK

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

iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

Maps JavaScript API Places Library

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

網路服務

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
routingSummaries*
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout

* 僅限文字搜尋和附近搜尋

  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

環境產品 SKU

[ Essentials: Environment ]

SKU：空氣品質用量

  類別 Essentials
  API Air Quality API
  可計費事件 成功要求空氣品質資料
  觸發條件
  定價 主要價目表
印度價目表

SKU：Solar API Building Insights

  類別 Essentials
  API Solar API
  可計費事件 要求成功
  觸發條件 傳送給 Solar API buildingInsights 資源的要求。

當您向 Solar API buildingInsights 資源提出要求時，系統會觸發這項 SKU。
  範例
  定價 主要價目表
印度價目表

SKU：Weather Usage

這項 SKU 會針對傳送給 Weather API 的要求計費。

  類別 Essentials
  可計費事件 要求
  觸發條件

對下列端點/方法提出要求時，系統會觸發計費：
  定價 主要價目表
印度價目表

[ Pro: Environment ]

SKU：Pollen Usage

  類別 Pro
  API Pollen API
  可計費事件 要求成功
  觸發條件
  定價 主要價目表
印度價目表

[ Enterprise: Environment ]

SKU：Solar API Data Layers

  類別 Enterprise
  API Solar API
  可計費事件 要求成功
  觸發條件 傳送至 Solar API dataLayers 資源的要求。
  注意事項

從同一項要求存取多個圖像網址不會產生額外費用。
  定價 主要價目表
印度價目表

舊版 Places 產品 SKU

如需最新版本，請參閱「地點介面集產品 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 收費。

如果是網路服務，下列 Places API 要求可讓您指定要傳回的資料欄位：

如果是網路服務，下列 Places API 呼叫「不」支援指定傳回的欄位。這些呼叫一律會傳回所有地點介面集資料，除了每個 API 要求的費用，還會收取三個地點介面集資料 SKU 的費用：

[ Essentials: Places Legacy ]

SKU：Autocomplete – Per Request (Legacy)

  類別 Essentials
  API 地點自動完成 (舊版) Android、
地點自動完成 (舊版) iOS、
地點自動完成 (舊版) 網頁
  可計費事件 不含會期權杖的要求
  觸發條件
  範例

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

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

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

  類別 Essentials
  API 地點自動完成 (舊版) Android、
地點自動完成 (舊版) iOS、
地點自動完成 (舊版) 網頁
  可計費事件 工作階段
  觸發條件
  • Android：呼叫 fetchPlace()
  • iOS：呼叫 fetchPlaceFromPlaceID:
  • 網路服務：Place Details 要求

要求中的欄位：

請務必在要求中指定所需欄位，以免產生不必要的費用。 視您指定的欄位而定，Place Details 要求也會產生下列資料 SKU：

如果您在 Place Details 要求中未指定欄位，系統就會觸發所有資料 SKU。

如果您在 Autocomplete 工作階段期間僅要求重新整理 Place Details ID (要求僅指定 place_id 欄位)，系統會將該工作階段視為 SKU：Autocomplete without Place Details – Per Session 來計費。
  範例

自動完成要求為免付費。如果您根據一般地點詳細資料定價要求後續的地點詳細資料，系統就會依這項舊版 SKU 計費。

這個範例說明一系列要求 (依平台)，當您按 SKU 查看帳單時，帳單中會顯示下列 SKU：

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data

各平台的範例要求：

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)

  定價 主要價目表
印度價目表

關於 Autocomplete 工作階段

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

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

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

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

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

SKU：Basic Data

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

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

  類別 Essentials
  API Places API Basic Data (舊版)
  可計費事件 成功要求基本資料欄位
  觸發條件

Android SDK 的欄位

Place.Field.ACCESSIBILITY_OPTIONS*
   * 請改用此項目，不要使用 Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (已淘汰)
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * 請改用此項目，不要使用 Place.Field.NAME (已淘汰)
Place.Field.FORMATTED_ADDRESS*
   * 請改用此項目，不要使用 Place.Field.ADDRESS (已淘汰)
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * 請改用此項目，不要使用 Place.Field.ICON_URL (已淘汰)
Place.Field.ID
Place.Field.LOCATION*
   * 請改用此項目，不要使用 Place.Field.LAT_LNG (已淘汰)
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.TYPES
Place.Field.VIEWPORT
Place.Field.UTC_OFFSET。

Fields for 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 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Find Place – ID only (舊版)

  類別 Essentials
  API Places Web Service Find Place
  可計費事件 僅要求「place_id」的成功率
  觸發條件 未指定任何欄位，或只指定 place_id 欄位的「尋找地點」要求：FindPlace(fields: place_id)。
  定價 主要價目表
印度價目表

SKU：Place Details – ID Refresh (舊版)

  類別 Essentials
  API 地點詳細資料 (舊版)
  可計費事件 僅要求 ID 欄位時成功
  觸發條件 只含地點 ID 欄位的要求： getPlaceDetails(fields: place_id)。
  定價 主要價目表
印度價目表

SKU：Query Autocomplete – Per Request (Legacy)

  類別 Essentials
  API 查詢自動完成服務
  可計費事件 要求成功
  觸發條件

使用 Query Autocomplete 時，不提供按 Autocomplete 工作階段計價。後續的 Place Details 要求會根據 Place Details Pro SKU 計費。

  定價 主要價目表
印度價目表

[ Pro: Places Legacy ]

SKU：Autocomplete without Place Details – Per Session (Legacy)

  類別 Pro
  API 地點自動完成 (舊版) Android、
地點自動完成 (舊版) iOS、
地點自動完成 (舊版) 網頁
  可計費事件 工作階段
  觸發條件
  定價 主要價目表
印度價目表

SKU：Find Current Place (Legacy)

  類別 Pro
  API Places SDK for Android、
Places SDK for iOS
  可計費事件 要求成功
  觸發條件

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

以下範例說明發出「尋找目前地點」要求，並指定「基本」、「聯絡資訊」和「氣氛」資料 SKU 的欄位時，系統會向您收取哪些 SKU 的費用。如要查看帳單上的 SKU，請按照「依據 SKU 分析用量與費用」一文所述，依據 SKU 查看帳單。

您發出 Find Current Place 要求，且只指定 ADDRESS 欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Basic Data

您發出 Find Current Place 要求，且只指定 PHONE_NUMBER 欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Contact Data

您發出 Find Current Place 要求，並指定全部三個資料類型欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 主要價目表
印度價目表

SKU：Find Place (Legacy)

  類別 Pro
  API Places Web Service Find Place
  可計費事件 成功要求 ID 欄位以外的資料
  觸發條件 指定 ID 欄位以外欄位的 Find Place 要求。

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

以下範例說明發出「尋找目前地點」要求，並指定「基本」、「聯絡資訊」和「氣氛」資料 SKU 的欄位時，系統會向您收取哪些 SKU 的費用。如要查看帳單上的 SKU，請按照「依據 SKU 分析用量與費用」一文所述，依據 SKU 查看帳單。

您發出 Find Place 要求，且只指定 ADDRESS 欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Basic Data

您發出 Find Place 要求，且只指定 PHONE_NUMBER 欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Contact Data

您發出 Find Place 要求，並指定全部三個資料類型欄位：

帳單會顯示下列 SKU：

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 主要價目表
印度價目表

SKU：Places – Nearby Search (Legacy)

  類別 Pro
  API 搜尋附近地點
  可計費事件 成功要求 Pro 版功能
  觸發條件

這項要求不支援指定要傳回的欄位。回應會傳回地點清單和支援的資料欄位子集。

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

您發出 Nearby Search 要求，例如： NearbySearch (San Francisco, 100 meters)。按 SKU 查看帳單時，其中將列出下列 SKU：

  • 地點
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 主要價目表
印度價目表

SKU：Places – Text Search (Legacy)

  類別 Pro
  API 文字搜尋 (舊版)
  可計費事件 要求成功
  觸發條件

Text Search 要求會傳回地點清單，但不支援指定傳回特定欄位。Text Search 要求會傳回支援的資料欄位子集。系統會向您收取 Text Search 要求的費用，以及所有資料類型 SKU 的費用： Basic Data、 Contact Data 和 Atmosphere Data。

Maps JavaScript API Place SearchBox 小工具也會觸發 Place – Text Search SKU：如果使用者選取地點查詢 (圖示為放大鏡)，而不是結果項目 (圖示為圖釘)，系統會呼叫 getPlaces() 方法，請見下圖：

Places Details SearchBox 小工具查詢選項
使用者在搜尋框內輸入「pizza」(披薩) 後，您可以在搜尋框小工具顯示的結果中看到「pizza delivery」(披薩外送) 旁邊有放大鏡圖示，代表這是地點查詢 (而不是結果項目)。
  範例

如果您發出 Text Search 要求 (例如 TextSearch(123 Main Street))，按 SKU 查看帳單時，帳單會顯示下列 SKU：

  • Place - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 主要價目表
印度價目表

SKU：Place Details Pro (舊版)

  類別 Pro
  API 地點詳細資料 (舊版)
  可計費事件 成功要求 Pro 版功能
  觸發條件

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

這個 SKU 也會觸發資料 SKU 的計費：如果您在要求中加入資料欄位，可能會觸發額外的資料 SKU 計費：Basic、Contact 和Atmosphere。 請只指定您需要的資料欄位，避免產生不必要的費用。系統會向您收取這個 SKU 和要求資料的費用。
  範例
  1. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且只指定 ADDRESS 欄位
    • Web API 或服務：發出 Place Details 要求，且只指定地址欄位：getPlaceDetails(fields: formatted_address)
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Place Details
    • Basic Data
  2. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且只指定 PHONE_NUMBER 欄位
    • Web API 或服務：發出 Place Details 要求，並指定電話號碼欄位：getPlaceDetails(fields: formatted_phone_number)
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Place Details
    • Contact Data
  3. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且指定所有欄位
    • Web API 或服務：發出 Place Details 要求，並指定所有欄位 (如果您未指定任何欄位，這類要求會採用此預設值)：getPlaceDetails()。
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Place Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  定價 主要價目表
印度價目表

[ Enterprise：Places Legacy ]

SKU：Atmosphere Data (Legacy)

資料 SKU，用於計算 Place Details 或 Find Place 要求中氣氛資料欄位的費用。對於觸發資料 SKU 的要求，除了基本 SKU 以外，系統也會針對這類資料 SKU 收費。
  類別 Enterprise
  API Atmosphere Data
  可計費事件 成功要求 Atmosphere 資料欄位
  觸發條件

Android SDK 的欄位

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 已淘汰

iOS 版 SDK 的欄位

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood。

Maps JavaScript API Places Library 的欄位

請參閱「欄位 (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。

  欄位遮罩帳單範例

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Contact Data (Legacy)

資料 SKU，用於計算 Place Details 或 Find Place 要求中聯絡資料欄位的費用。對於觸發這項 SKU 的要求，除了基本 SKU 以外，系統也會針對這項 SKU 收費。
  類別 Enterprise
  API Places API 聯絡人資料 (舊版)、
Find Place
  可計費事件 成功要求聯絡資料欄位
  觸發條件

Android SDK 的欄位

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * 請改用這個函式，不要使用 Place.Field.PHONE_NUMBER (已淘汰)。
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

iOS 版 SDK 的欄位

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

網路服務的欄位

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  欄位遮罩帳單

系統會根據欄位遮罩中提供的欄位，計算要求費用。例如：

  • 如果欄位遮罩只包含這個 SKU 的欄位：系統會按照這個 SKU 的費率收取要求費用。
  • 如果欄位遮罩包含其他 SKU 的欄位：系統會按照所要求欄位的最高 SKU 費率計費。舉例來說，如果您同時納入 Essentials SKU 和 Enterprise SKU 的欄位，系統就會以 Enterprise SKU 費率計費。
  定價 主要價目表
印度價目表

SKU：Places Photo (舊版)

  類別 Enterprise
  API Places Photo (舊版)
  可計費事件 成功要求提供相片
  觸發條件
  • Android：對 fetchPhoto() 的要求
  • iOS：對 loadPlacePhoto: 的要求
  • JavaScript：向 PlacePhoto.getUrl() 發出要求，載入圖片像素資料。
  • 網路服務：傳送至 Places API Place Photos 服務的要求。
  定價 主要價目表
印度價目表

舊版 Routes API SKU

[ Essentials：Routes Legacy ]

SKU：Directions (Legacy)

  類別 Essentials
  API Maps JavaScript API 的 Directions Service、
Directions API (舊版)
  可計費事件 要求成功，但未使用 Pro 或 Enterprise 功能
  觸發條件 不會觸發較高費率 SKU 的查詢。
  定價 主要價目表
印度價目表

SKU：Distance Matrix (舊版)

  類別 Essentials
  API Distance Matrix API (舊版)、
Maps JavaScript API Distance Matrix Service
  可計費事件 不含 Pro 或 Enterprise 功能的每個元素
  觸發條件 要求元素時不會觸發較高價格的 SKU。
  定價 主要價目表
印度價目表

[ Pro: Routes Legacy ]

SKU：Directions Advanced (舊版)

  類別 Pro
  API Maps JavaScript API 的 Directions Service、
Directions API (舊版)
  可計費事件 成功要求 (使用 Pro 版功能)
  觸發條件
  定價 主要價目表
印度價目表

SKU：Distance Matrix Advanced (舊版)

  類別 Pro
  API Distance Matrix API (舊版)、
Maps JavaScript API Distance Matrix Service
  可計費事件 每個元素都會傳回 Pro 版功能
  觸發條件
  定價 主要價目表
印度價目表