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 的遷移指南:
- 遷移至 Nearby Search (新版)
- 遷移至 Text Search (新版)
- 遷移至 Place Details (新版)
- 遷移至 Place Photo (新版)
- 遷移至 Autocomplete (新功能)
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,才能開始開發應用程式:
如果您是剛開始使用 Places API 的新客戶,請先使用新的 API。
如果您是新客戶,且尚未替換現有 API (例如 Place Autocomplete 或 Query Autocomplete),則可合併使用新舊 API。
如果您是現有客戶,可以繼續使用現有的 API。不過,如要充分利用 Places API (新版) 的效能改善和功能強化功能,您可以遷移至新版 API。
如要進一步瞭解遷移作業,請參閱「遷移概覽」一文。