選擇 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 文字搜尋 (新推出) 「尋找地點」服務沒有新版本。「文字搜尋」(新版) 已取代原本的內容。
搜尋附近 搜尋附近地點 (新推出) 透過含有文字查詢的現有 API 的所有要求，都應使用 Text Search (New)，因為 Nearby Search (新) 不支援文字輸入。
搜尋文字 文字搜尋 (新推出)
Place Details Place Details (新推出)
Place Photo 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 (New) 和 Places SDK for iOS 的所有功能和 API。

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

遷移至新版 API

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

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

本節介紹 Places API (新版) 的重要功能。

已在 Google Cloud Standard 平台上實作

Places API (新版) 是由 Google Cloud 的服務基礎架構實作。這項實作提供了更安全可靠的平台，並提供 OAuth 等進階安全性選項。這個標準 API 設計可以在所有 API 中達到一定程度的一致性，進而提升使用 Places API (新版) 的開發效率。

提高效能

Places API (新版) 可提升效能，建議您替換使用現有 Places API 的應用程式。

簡化計費模式

Places API (新版) 簡化了定價作業，因此您只需要為實際使用的資料付費。系統會使用欄位遮罩來實作簡化定價。

透過 Place Details (New)、Nearby Search (New) 和 Text Search (New) 可使用欄位遮罩控管回應中要傳回的欄位清單。如此一來，您只需為所要求的資料付費。使用欄位遮罩是不錯的設計做法，可避免要求不必要的資料，避免不必要的處理時間和帳單費用。

地點的一致回應資料

在現有的 API 中，Place Details、Nearby Search 和 Text Search API 會傳回地點的不同回應資料。Places API (新版) 會將回應標準化，讓這些 API 傳回的地點相同的資料。

展開的地點類型

API 回應現在可以包含地點的主要類型。每個地點都可以有一個單一類型值，該值會指定為地點的主要類型，如表 A 所示。

此外，新版 API 也會加入下表所列的地點類型。您可以在「搜尋附近」(New) 和「Text Search (New)」搜尋中，使用這些新類型和現有類型。新類型都包含在表 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
顧問 Heliport 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 (新版) 已從資料表 B 中移除下列類型。也就是說，現在您可以在搜尋中使用下列類型：
  • 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。

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