選擇 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 文字搜尋 (新版) 目前沒有 Find Place 新版本。 已由 Text Search (新版) 取代。
Nearby Search Nearby Search (新版) 所有使用現有 API 且包含文字查詢的要求，都應使用 Text Search (新版)，因為 Nearby Search (新版) 不支援文字輸入。
文字搜尋 文字搜尋 (新版)
Place Details Place Details (新版)
Place Photo Places Photo (新版)
Place Autocomplete 自動完成 (新功能)
Query 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 還新增了下表所列的場所類型。您可以在使用鄰近搜尋 (新版) 和文字搜尋 (新版) 的搜尋中，使用這些新類型和現有類型。表 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 farmstay 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 (新版) 也將下列類型從 Places API 的 Table 2 移至 Places API (新版) 的 Table 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 和現有 API。

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

    如要進一步瞭解遷移作業，請參閱「遷移概覽」。