Places API 支援兩個 API 版本： Places API 是 現有的 API 和 Places API (新增) 是下一個 API 的新世代版本
Places API (新版) 推出後，您的第一項工作是決定 以及要使用的 API如果您是新客戶或現有客戶，則發生此情況 目前已經在使用 API 的客戶透過本指南瞭解 計算差異
API 清單
下表列出這兩組 API。如果您是現有客戶 請根據這個表格判斷有哪些新的 API 會取代目前的 API 目前的使用量。
| Places API | Places API (新推出) | 注意事項 |
|---|---|---|
| Find Place | Text Search (新版) | 沒有新版「尋找地點」。 Text Search (新版) 已取代。 |
| 搜尋附近 | Nearby Search (新版) | 凡是使用現有 API (包含文字查詢) 的要求，都應使用 Text Search (新版) 因為 Nearby Search (新版) 不支援文字輸入。 |
| 搜尋文字 | Text Search (新版) | |
| Place Details | Place Details (新功能) | |
| Place Photo | 地點相片 (新) | |
| Place Autocomplete | 自動完成 (新版) | |
| 查詢自動完成 | 自動完成 (新版) | 自動完成功能加入的功能 (新功能) |
您啟用的 Places API 服務版本 ，以便控制應用程式使用的 API：
Places API：啟用現有 API。如果只有 與下列項目相關聯的專案已啟用 Places API 應用程式就無法存取新的 API。
Places API (新版)：啟用所有新的 API 和 功能，請參閱「在 Places SDK for iOS (新版)：您的應用程式不會 可以存取現有 API
兩者：為兩者啟用所有功能和 API Places SDK for iOS (新版) 和 Places SDK for iOS：
如要進一步瞭解如何選取 Places API 服務， 請參閱「設定 Google Cloud 專案」。
遷移至新版 API
如果您使用的是現有 API，且想要遷移至新的 API，請參閱 以下各 API 的遷移指南：
- 遷移至 Nearby Search (新版)
- 遷移至 Text Search (新版)
- 遷移至 Place Details (新版)
- 遷移至 Place Photo (新版)
- 遷移至 Autocomplete (新版)
Places API 新增的重要功能 (新功能)
本節說明 Places API 新增的重要功能 (新功能)。
實作於 Google Cloud 標準平台
Places API (新版) 上會導入 服務基礎架構 Google Cloud 中的資源這項實作方式讓安全性與可信度提升。 平台提供更強大的安全性選項 OAuth。這個標準 API 可讓各 API 的一致性達到更高的效率 開發的 API (新推出)。
提高效能
Places API (新版) 提供更優質的效能， 因此可以考慮替換使用現有 Places API 的應用程式。
簡化計費模式
Places API 的定價簡化了，因此您只需要 為實際資料用量付費簡化計價模式的 欄位遮罩。
與 Place Details (新功能) 合作 Nearby Search (新版)，以及 Text Search (新版) 可利用欄位遮罩控管 要在回應中傳回的欄位清單。您只需為使用的資料支付費用 。使用欄位遮罩是很好的設計做法，可確保 請勿要求不必要的資料，以避免不必要的處理時間 以及帳單費用
一致的地點回應資料
使用現有的 API 時，Place Details Nearby Search 和 Text Search API 針對地點傳回不同的回應資料。Places API (新推出) 將回應標準化，讓這些 API 針對地點傳回相同的資料。
展開的地點類型
API 回應現在可以包含地點的主要類型。每個地點都有 指定為地點的主要類型的單一類型值，如 表 A.
此外，新的 API 也會加入下表顯示的地點類型。你可以 使用以下新類型和現有類型進行搜尋時 Nearby Search (新版) 和 Text Search (新版)。所有新類型都位於 表 A.
| 類型 | |||
|---|---|---|---|
| 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 (新版) 移動了下列類型 。 也就是說，您現在可以在 搜尋：
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
動態地點資料
Places API (新版) 支援動態回應資料，例如可用性 或加油站的最新燃料價格使用 建立動態使用者體驗。
您該選擇哪種 API？
開始開發應用程式前，您必須選擇 API：
如果您是剛開始使用 Places API 的新客戶， 開始使用新的 API
如果您是新客戶，且目前沒有替換 現有的 API，例如 Place Autocomplete 或 Query 自動完成功能，您就能合併使用全新和現有的 API。
如果您是現有客戶，可以繼續使用現有的 相互整合但要善用效能改善項目， Places API 的強化功能 (新版)， 新的 API
如要進一步瞭解遷移，請參閱遷移 總覽頁面。