選擇 API 版本

Places API 支援兩個 API 版本：Places API 是現有的 API，而 Places API (新版) 是新一代的 API。

Places API (新版) 推出後，您的第一項工作是決定要使用哪組 API。如果您是新客戶或已經在使用 API 的現有客戶，就適用情況。本指南說明這兩種 API 的主要差異。

API 清單

下表列出這兩組 API。如果您是現有客戶，請使用這個表格來確定用來取代目前所用 API 的新 API。

Places API Places API (新推出) 注意事項
Find Place Text Search (新版) Find Place 未提供新版。Text Search (新版) 已取代。
搜尋附近 Nearby Search (新版) 凡是使用現有 API 且包含文字查詢的要求，都應使用 Text Search (新版)，因為 Nearby Search (新版) 不支援文字輸入。
搜尋文字 Text Search (新版)
Place Details Place Details (新功能)
Place Photo 地點相片 (新)
Place Autocomplete 自動完成 (新版)
查詢自動完成 自動完成 (新版) 自動完成功能加入的功能 (新功能)

您在 API 金鑰上啟用的 Places API 服務版本，會控管應用程式使用的 API：

  • Places API：啟用現有 API。如果只有與應用程式 API 金鑰相關聯的專案啟用了 Places API，應用程式就無法存取新的 API。

  • Places API (新版)：啟用「Places SDK for iOS 新增的重要功能 (新版)」一文中所述的所有新 API 和功能。您的應用程式將無法存取現有的 API。

  • 兩者皆是：啟用 Places SDK for iOS (新版) 和 Places SDK for iOS 的所有功能與 API。

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

遷移至新版 API

如果您使用現有 API，且想要遷移至新的 API，請參閱以下各個 API 的遷移指南：

Places API 新增的重要功能 (新功能)

本節說明 Places API 新增的重要功能 (新功能)。

實作於 Google Cloud 標準平台

Places API (新版) 已經導入 Google Cloud 的服務基礎架構。此實作讓它具有更安全可靠的平台，並帶來 OAuth 等強化的安全性選項。這項標準 API 設計可讓所有 API 的一致性等級，透過 Places 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
顧問 直升機 playground 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 hotel rest_stop

除了這些新類型之外，Places API (新版) 也將下列類型從 Places API 的表 2 移至 Places API 的資料表 A (新版)。也就是說，您現在可以在搜尋中使用這些類型：

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

動態地點資料

Places API (新版) 支援動態回應資料，例如電動車充電站的供應情形，或是加油站的最新燃料價格。使用這些回應欄位建立動態使用者體驗。

您該選擇哪種 API？

開始開發應用程式前，您必須選擇 API：

  1. 如果您是剛開始使用 Places API 的新客戶，請先開始使用新的 API。

  2. 如果您是新客戶，且尚未替換現有 API (例如 Place Autocomplete 或 Query Autocomplete)，則可合併使用新舊 API。

  3. 如果您是現有客戶，可以繼續使用現有的 API。不過，如要善用 Places API (新版) 的效能改善和功能強化項目，您可以遷移至新的 API。

    如要進一步瞭解遷移，請參閱遷移總覽。