選擇 SDK 版本

應用程式提供的 Places SDK for Android 功能如下 取決於您的 SDK 版本號碼 (例如:3.5.0) 在應用程式設定中指定為 API 金鑰啟用的 API,以及如何 初始化應用程式。本指南將說明不同版本和 如何選取要在應用程式中啟用的版本。

SDK 版本號碼

您在應用程式層級 build.gradle 中指定的 SDK 版本號碼 檔案會決定應用程式是否可存取 特定發行的新版本舉例來說,Autocomplete (新版) 僅適用於 SDK 3.5.0 以上版本。

如要進一步瞭解每個 SDK 版本中的異動內容,請參閱 Android 版 SDK 附註

Places SDK for Android 的 Places API 版本

除了指定 SDK 版本號碼外,您也必須選取「地點」 SDK 在 Google Cloud 控制台中呼叫的 API 服務:Places API 或 Places API (新版)。以及 SDK 版本號碼 (也就是 選擇決定您的應用程式提供的特定功能版本 像是自動完成或自動完成 (新版)雖然您只能指定一個 SDK 您也可以在自己的網頁上同時啟用 Places API 和 Places API (新版) API 金鑰,接著選取 SDK 用來呼叫的服務 在應用程式中初始化 SDK 時所用的方法。不過在大多數的情況下 您會想啟用 Places API (新版),並使用 應用程式中的 SDK 功能

選取 SDK 版本和 API 服務

如要選取應用程式可用的 SDK 功能,請按照下列步驟操作:

  1. 在 Google Cloud 專案中啟用 Places API、Places API (新版),或 兩者。詳情請參閱「啟用 API
  2. 在 API 金鑰限制中,啟用 Places API、Places API (新版),或 兩者。詳情請參閱「限制 API 金鑰
  3. 在應用程式層級的 build.gradle 檔案中,指定版本號碼。如要 資訊,請參閱 安裝

  4. 您可以呼叫 Places.initializeWithNewPlacesApiEnabled()敬上 或 Places.initialize()。 方法。

如要進一步瞭解如何選取 Places API 服務,請參閱「設定 Google Cloud 專案

各版本提供的 SDK 功能

下表列出每個 SDK 所需的 SDK 和 API 版本 功能:

功能 API 金鑰已啟用 Places API 初始化方法 SDK 最低版本
自動完成 (新版) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (新功能) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.3.0
Nearby Search (新版) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.5.0
Place Photos (新推出) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.4.0
Text Search (新版) Places API (新推出) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete Places API initialize()
目前所在地點 Places API initialize()
Place Details Places API initialize()
Place Photo Places API initialize()

選擇要啟用的版本時應考量的事項

您可以參考下列原則來決定要選擇哪個版本:

  • 如果您是剛開始使用 Places SDK for Android 的新客戶, 從 Places API (新版) 和新的 SDK 著手。
  • 如果您是現有客戶,可以繼續使用現有的 SDK。 但是,您可以善用效能改善項目和功能 改善 Places SDK for Android (新版) 的功能,則應採用 將機器學習工作流程自動化改用新版 SDK 並不需要進行遷移,只需按照 請按照「選取 SDK 版本和 API」一文中的步驟 服務
  • 在 Places SDK for Android (新版) 中,系統會從 。詳情請參閱工作階段 符記
  • 透過 Place Autocomplete 小工具發出的呼叫一律呼叫 Place Autocomplete,而非 Place Autocomplete (新版);小工具呼叫不會受到 初始化方法。
  • Place Photos (新推出) 只會傳回點陣圖圖片的 URI,而 Place 相片只會傳回點陣圖 圖片。
  • 目前地點: 僅適用於 Places SDK for Android,不適用於 Places SDK for Android (新功能)。

Places SDK for Android 中的強化功能 (新推出)

本節說明 Places SDK for Android 新增的重要功能 (新功能)。

實作於 Google Cloud 標準平台

Places SDK for Android (新版) 已經導入 服務上 基礎架構 Google Cloud 中的資源進而打造更安全可靠的平台。 這項標準設計可讓 SDK 維持一定程度的一致性, Places SDK for Android 的開發效率 (新功能)。

提高效能

Places SDK for Android (新版) 提供更完善的效能, 可以一併替換使用現有 SDK 的應用程式。

新功能

Places SDK for Android (新版) 內含所有 SDK 的最新版本 功能:

新版 Text Search 服務

Text Search (新版) 會傳回資訊 根據字串得出一組地點的資訊,例如「臺北市的披薩」或 「渥太華附近的鞋店」或「中正路 123 號」。服務會傳回清單 與文字字串及任何位置自訂調整設定相符的地點。

在 Placed Details (新版) 和 Place Photos (新功能) 中加入新的回應資料

  • Place Details (新功能) 現在包含 檢閱 回應 Place 物件中的類別。 Place 類別 包含支援這個欄位的新 getReviews() 方法。致電 getReviews() 即可返回單一地點 (最多 5 則) 的評論。

  • Place Photo (新增) 將 AuthorAttributions敬上 加入 PhotoMetadata 類別。AuthorAttributions 包含的 List AuthorAttribution敬上 如需儲存大量結構化物件 建議使用 Cloud Bigtable

已在 Place Photos 中新增 URI 回應 (新)

您現在可以使用 Place Photo (新增) 傳回圖片點陣圖的 URI。先前您只能傳回 圖片點陣圖本身

簡化計費模式

Places SDK for Android 定價簡化了,因此您只需要 為實際資料用量付費透過欄位清單導入簡化定價 也稱為欄位遮罩

透過 Place Details 和 Text Search:透過欄位清單 ] 欄位。您只需為使用的資料支付費用 。使用欄位清單是不錯的設計做法,可確保您不會 要求不必要的資料,以避免不必要的處理時間,並 帳單費用。

如需這兩種 SDK 的詳細定價資訊,請參閱「使用和 帳單

展開的地點類型

新版 SDK 會新增下表顯示的地點類型。這些類型 做為 Place Details 的一部分傳回,以及 Text Search 回應。您也可以使用這些新類型 和現有類型 新類型已列入表格 答:

類型
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant 農場 korean_restaurant sporting_goods_store
barber_shop 農莊民宿 lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal 市場 steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant 裁縫師
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant 汽車旅館 thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
顧問 直升機 遊樂場 vegetarian_restaurant
convention_center hiking_area 學齡前 vietnamese_restaurant
小屋 historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center 青年旅館 resort_hotel 批發商
dental_clinic 飯店 rest_stop

除了這些新類型以外,Places API (新版) 移動了下列類型 。 也就是說,您現在可以在 搜尋:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality