選擇 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 Nearby Search (新版) 所有使用現有 API 且包含文字查詢的要求,都應使用 Text Search (新版),因為 Nearby Search (新版) 不支援文字輸入。
文字搜尋 文字搜尋 (新版)
Place Details Place Details (新功能)
Place 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 還新增了下表所列的場所類型。在透過 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 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。

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

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