舊版 Places 和 Routes SKU 詳細資料

本頁面提供舊版 Places API、舊版 Directions API 和舊版 Distance Matrix API SKU 的 SKU 詳細資料、SKU ID、計費事件和計費觸發條件。如需這些服務的最新版本，請參閱「Places (新版) SKU 詳細資料」和「路徑和導航 SKU 詳細資料」。如需所有產品類別的目錄，請參閱「API 用量詳細資料總覽」。

關於 SKU 表格

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

類別 SKU 屬於 Essentials、Pro 或 Enterprise SKU 類別。
可計費事件 SKU 的計費事件。
觸發條件 哪些程式碼元素會觸發計費事件。
定價 該 SKU 群組的價目表連結。

舊版 Places 產品 SKU

如需最新版本，請參閱「Places (新版) 產品 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 呼叫「不」支援指定傳回的欄位。這些呼叫一律會傳回所有 Places 資料，除了每個 API 要求的費用，還會收取三個 Places 資料 SKU 的費用：

[ Essentials：Places Legacy ]

SKU：Autocomplete – Per Request

  類別 Essentials
  SKU ID

7384-2DE4-D388 (全球)

2164-BC00-53DC (印度)
  API Place Autocomplete (舊版) Android、
Place Autocomplete (舊版) iOS、
Place Autocomplete (舊版) Web
  可計費事件 不含工作階段符記的要求
  觸發條件
  範例

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

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

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

  類別 Essentials
  SKU ID

E9C9-934B-DDB1 (全球)
  API Place Autocomplete (舊版) Android、
Place Autocomplete (舊版) iOS、
Place Autocomplete (舊版) Web
  可計費事件 工作階段
  觸發條件
  • Android：呼叫 fetchPlace()
  • iOS：呼叫 fetchPlaceFromPlaceID:
  • 網路服務：Place Details 要求

要求中的欄位：

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

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

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

自動完成要求為免付費。這項舊版 SKU 會在您根據一般 Place Details 定價要求後續 Place Details 時計費。

以下範例說明各平台的一系列要求，按 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 欄位)

Web 服務要求

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 呼叫。

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

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

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

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

SKU：Basic Data

資料 SKU：針對 Places Details 或 Find Place 要求中的基本資料欄位計費。

  類別 Essentials
  SKU ID

75D4-C522-326B (全球)

5D7B-1F7B-395E (印度)
  API Places Details (舊版) 搭配基本欄位
Find Place (舊版) 搭配基本欄位
  可計費事件 成功要求 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。

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
  SKU ID

44A2-D839-A3AC (全球)

FE05-60A4-CDDF (印度)
  API Places Web Service Find Place
  可計費事件 僅要求 place_id 成功
  觸發條件 未指定任何欄位或僅指定 place_id 欄位的尋找地點要求：FindPlace(fields: place_id)。
  定價 價目表 (全球)
價目表 (印度)

SKU：Place Details – ID Refresh

  類別 Essentials
  SKU ID

2D88-4302-6299 (全球)

4604-F56B-7086 (印度)
  API Place Details (舊版)
  可計費事件 僅要求 ID 欄位成功
  觸發條件 僅包含地點 ID 欄位的要求：getPlaceDetails(fields: place_id)。
  定價 價目表 (全球)
價目表 (印度)

SKU：Query Autocomplete – Per Request

  類別 Essentials
  SKU ID

C4B1-8805-63EF (全球)

59E9-EB83-5CA3 (印度)
  API Query Autocomplete 服務
  可計費事件 成功提出要求
  觸發條件

使用 Query Autocomplete 時，不提供按 Autocomplete 工作階段計價。後續的 Place Details 要求會根據 Place Details Pro SKU 計費。
  定價 價目表 (全球)
價目表 (印度)

[ Pro: Places Legacy ]

SKU：Autocomplete without Place Details – Per Session

  類別 Pro
  SKU ID

B52C-8320-6DC5 (全球)

C625-D3CE-DF37 (印度)
  API Place Autocomplete (舊版) Android、
Place Autocomplete (舊版) iOS、
Place Autocomplete (舊版) Web
  可計費事件 工作階段
  觸發條件
  定價 價目表 (全球)
價目表 (印度)

SKU：尋找目前位置

  類別 Pro
  SKU ID

7218-264C-D1D7 (全球)

0862-F46E-1A1A (印度)
  API Places SDK for Android、
Places SDK for iOS
  可計費事件 成功提出要求
  觸發條件
  範例

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

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Basic Data

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Contact Data

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 價目表 (全球)
價目表 (印度)

SKU：Find Place

  類別 Pro
  SKU ID

DC67-3188-2294 (全球)

ECB4-087C-9A27 (印度)
  API Find Place (舊版)
  可計費事件 成功要求 ID 以外的欄位
  觸發條件 Find Place 要求，且指定 ID 以外的欄位。
  範例

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

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Basic Data

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Contact Data

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

帳單會顯示下列 SKU：

  • 尋找目前位置
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 價目表 (全球)
價目表 (印度)

SKU：Places – Nearby Search

  類別 Pro
  SKU ID

6B23-8A17-D29D (全球)

CC66-BE0E-2477 (印度)
  API Nearby Search (舊版)
  可計費事件 成功申請 Pro 功能
  觸發條件

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

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

  • 地點
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 價目表 (全球)
價目表 (印度)

SKU：Places – Text Search

  類別 Pro
  SKU ID

E95A-86C7-7F47 (全球)

102E-888D-5596 (印度)
  API Text Search (舊版)
  可計費事件 成功向 Text Search (舊版) 提出要求
  觸發條件

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

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

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

如果您提出 Text Search (舊版) 要求，按 SKU 查看帳單時，帳單會顯示下列 SKU：

  • Places - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  定價 價目表 (全球)
價目表 (印度)

SKU：Places Details

  類別 Pro
  SKU ID

FC5C-DF28-543F (全球)

F7AA-FEF9-C90E (印度)
  API Place Details (舊版)
  可計費事件 成功申請 Pro 功能
  觸發條件

使用網路 API 和服務時，無論是否提供工作階段符記，系統都會以 Place Details SKU 計費。
  範例
  1. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且只指定 ADDRESS 欄位
    • Web API 或服務：發出 Place Details (舊版) 要求，且只指定地址欄位：getPlaceDetails(fields: formatted_address)
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Places Details
    • Basic Data
  2. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且只指定 PHONE_NUMBER 欄位
    • Web API 或服務：發出 Place Details (舊版) 要求，並指定電話號碼欄位：getPlaceDetails(fields: formatted_phone_number)
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Places Details
    • Contact Data
  3. 進行下列其中一項呼叫或要求：
    • 行動裝置：在 Android 上呼叫 fetchPlace() 或在 iOS 上呼叫 fetchPlaceFromPlaceID:，且指定所有欄位
    • Web API 或服務：發出 Place Details (舊版) 要求，並指定所有欄位 (如果您未指定任何欄位，這類要求會採用此預設值)：getPlaceDetails()。
    按 SKU 查看帳單時，其中將列出下列 SKU：
    • Places Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  定價 價目表 (全球)
價目表 (印度)

[ Enterprise: Places Legacy ]

SKU：Atmosphere Data

資料 SKU：針對 Places Details 或 Find Place 要求中的氣氛資料欄位計費。

  類別 Enterprise
  SKU ID

D63D-5CC5-302A (全球)

0CE0-1963-137E (印度)
  API Places Details (舊版) 含氣氛欄位
Find Place (舊版) 含氣氛欄位
  可計費事件 成功要求 Atmosphere 資料欄位
  觸發條件
  欄位遮罩計費範例

系統會根據欄位遮罩中提供的欄位，向您收取要求費用。例如：

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

SKU：Contact Data

資料 SKU，用於對 Place Details 或 Find Place 要求中的聯絡資料欄位收費。

  類別 Enterprise
  SKU ID

F095-CD01-81B2 (全球)

A03F-5079-C66C (印度)
  API Places Details (舊版) 含聯絡資訊欄位
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

Web 服務欄位

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
  SKU ID

81E7-85D0-58A7 (全球)

9F4B-2E19-1B63 (印度)
  API Places Photo (舊版)
  可計費事件 成功要求相片
  觸發條件
  • Android：向 fetchPhoto() 提出要求
  • iOS：向 loadPlacePhoto: 提出要求
  • JavaScript：向 PlacePhoto.getUrl() 要求載入圖片像素資料。
  • 網路服務：傳送至 Places API Place Photos 服務的要求。
  定價 價目表 (全球)
價目表 (印度)

舊版 Routes API SKU

[ Essentials: Routes Legacy ]

SKU：Directions

  類別 Essentials
  SKU ID

28A8-3EB4-4595 (全球)

4714-291C-3199 (印度)
  API Maps JavaScript API 的 Directions Service、
Directions API (舊版)
  可計費事件 要求成功，未使用 Pro 或 Enterprise 功能
  觸發條件 不會觸發較高評分 SKU 的查詢
  定價 價目表 (全球)
價目表 (印度)

SKU：距離矩陣

  類別 Essentials
  SKU ID

C1B6-FF9D-7700 (全球)

558A-4F88-F361 (印度)
  API Distance Matrix API (舊版)、
Maps JavaScript API Distance Matrix Service
  可計費事件 不含 Pro 或 Enterprise 功能的元素。每個傳送到 Distance Matrix API 的要求都會產生元素，將 origins 數量乘以 destinations 數量即等於元素數量。
  觸發條件 不會觸發高價 SKU 的元素要求
  定價 價目表 (全球)
價目表 (印度)

[ Pro：Routes Legacy ]

SKU：Directions Advanced

  類別 Pro
  SKU ID

9407-00C2-CF85 (全球)

E27B-BD57-FD7D (印度)
  API Maps JavaScript API 的 Directions Service、
Directions API (舊版)
  可計費事件 成功使用 Pro 功能的要求
  觸發條件
  定價 價目表 (全球)
價目表 (印度)

SKU：進階距離矩陣

  類別 Pro
  SKU ID

DFAE-763F-CF6E (全球)

C0F4-32AE-F6D1 (印度)
  API Distance Matrix API (舊版)、
Maps JavaScript API Distance Matrix Service
  可計費事件 每個元素都會傳回 Pro 功能。每個傳送到 Distance Matrix API 的要求都會產生元素，將 origins 數量乘以 destinations 數量即等於元素數量。
  觸發條件
  定價 價目表 (全球)
價目表 (印度)