簡介
Places API (新版) 包含下列 API：
本文將概略介紹這些新 API。
Place Details (新推出)
地點 ID 可用來辨識 Google 地點資料庫和 Google 地圖中的特定地點。取得地點 ID 後，您可以發出 Place Details (新版) 要求，索取特定商家或搜尋點的詳細資料。Place Details (新版) 要求會傳回指定地點的完整資訊，例如完整地址、電話號碼、使用者評分和評論。
取得地點 ID 的方法有很多種。例如：
- Text Search (New)
- Nearby Search (新版)
- Geocoding API
- Routes API
- Address Validation API
- Autocomplete (新版)
Place Photos (新推出)
Place Photos (新版) 可讓您存取 Google Places 資料庫中儲存的數百萬張相片，在應用程式中加入高品質的相片內容。您可以使用 Place Photos (New) API 存取相片，並配合應用程式將圖片調整至最佳尺寸。
傳送至 Place Photos (New) API 的所有要求，都必須包含相片資源名稱，用於識別要傳回的相片。您可以使用下列指令取得相片資源名稱：
如要在 Place Details (新版)、Text Search (新版) 或 Nearby Search (新版) 要求的傳回結果中，加入相片資源名稱，請務必在要求的欄位遮罩中加入 photos 欄位。
Text Search (新版) 和 Nearby Search (新版)
Places API (新版) 包含兩個搜尋 API：
-
可指定要搜尋地點的文字字串。例如：「澳洲雪梨的辣味素食」或「加州帕羅奧圖附近的高級海鮮餐廳」。
您可以指定價格等級、目前營業狀態、評分或特定地點類型等詳細資料，縮小搜尋範圍。您也可以指定將結果偏向特定位置，或將搜尋範圍限制在特定位置。
-
可讓您指定要搜尋的區域，以及地點類型清單。指定區域為圓形，由中心點的經緯度座標和半徑 (以公尺為單位) 定義。
指定一或多個地點類型，定義地點的特徵。舉例來說，指定「
pizza_restaurant」和「shopping_mall」，即可搜尋位於指定區域購物中心內的披薩餐廳。
這兩項搜尋的主要差異在於，Text Search (新版) 可讓您指定任意搜尋字串，而 Nearby Search (新版) 則需要指定搜尋區域。
自動完成 (新版) 和工作階段符記
Autocomplete (新版) 是一項網路服務，可根據 HTTP 要求傳回地點預測和查詢預測結果。在要求中，指定 Text Search 字串和地理邊界，控管搜尋區域。
工作階段符記是使用者產生的字串，用於將 Autocomplete (新版) 呼叫視為工作階段進行追蹤。Autocomplete (新版) 會使用工作階段符記，將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以用於計費。
新欄位、屬性和無障礙選項
Places API (新版) 包含新欄位、屬性和無障礙選項，可為使用者提供更多地點資訊。以下各節將說明這些層面。
欄位
Places API (新版) 包含多個新欄位：
| 欄位 | 說明 |
|---|---|
regularSecondaryOpeningHours |
說明特定作業的特定時間。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以指定得來速或外送服務時間做為次要營業時間。 |
paymentOptions |
地點接受的付款方式。一個地點可以接受多種付款方式。如果沒有付款方式資料，系統就不會設定付款方式欄位。您可以使用的選項包括：
|
parkingOptions |
地點提供的停車選項。您可以使用的選項包括：
|
subDestinations |
與特定地點相關的獨特地點。舉例來說，機場航廈會視為機場的子目的地。 |
fuelOptions |
加油站提供的最新燃料選項資訊。這項資訊會定期更新。選項包括：
|
evChargeOptions |
這個充電站的電動車充電樁數量。雖然部分電動車充電樁有多個接頭，但每個充電樁一次只能為一輛車充電，因此這個欄位會反映特定時間可用的電動車充電樁數量。 |
shortFormattedAddress |
地點的人類可讀簡短地址。 |
primaryType |
指定結果的主要類型。舉例來說，某個地點可能會歸類為 cafe 或 airport。一個地點只能有一個主要類型。如需可能值的完整清單，請參閱「支援的類型」。 |
primaryTypeDisplayName |
主要類型的顯示名稱，如果適用，會根據要求語言本地化。如需可能值的完整清單，請參閱「支援的類型」。 |
entrances |
目的地的入口。入口是一組經緯度座標，用於定義地點的出入口位置。 |
navigationPoints |
目的地的導航點。導航點是道路旁可結束導航的位置，包括支援的交通方式和用途。 |
屬性
Places API (新版) 包含多項新屬性：
| 屬性 | 說明 |
|---|---|
outdoorSeating |
提供戶外座位。 |
liveMusic |
地點提供現場音樂表演。 |
menuForChildren |
地點提供兒童菜單。 |
servesCocktails |
供應雞尾酒。 |
servesDessert |
提供甜點。 |
servesCoffee |
地點供應咖啡。 |
goodForChildren |
適合兒童。 |
allowsDogs |
可帶狗入內。 |
restroom |
地點設有洗手間。 |
goodForGroups |
地點可容納團體。 |
goodForWatchingSports |
地點適合觀看運動賽事。 |
無障礙功能選項
Places API (新版) 包含下列無障礙選項欄位：
| 欄位 | 說明 |
|---|---|
wheelchairAccessibleParking |
地點提供無障礙停車位。 |
wheelchairAccessibleEntrance |
地點有無障礙入口。 |
wheelchairAccessibleRestroom |
地點有無障礙洗手間。 |
wheelchairAccessibleSeating |
地點有無障礙座位。 |
AI 輔助摘要
Places API (新版) AI 輔助摘要功能採用 Gemini 模型，可傳回地點和區域的摘要，協助使用者決定去處。
AI 輔助摘要會整合各種輸入內容的資料，協助使用者更明智地決定是否造訪某個地點。舉例來說，如果您想嘗試新餐廳，AI 輔助的摘要可以列出常見的菜單亮點、讓您瞭解餐廳氛圍，或統整使用者評論的主題。如果你造訪新城市，AI 輔助的摘要可提供附近景點和設施的總覽。
Places API (新版) 新增 AI 輔助功能
Place Details (新版)、Text Search (新版) 和Nearby Search (新版) 支援 AI 輔助摘要。Places API (新版) 回應提供下列 AI 摘要：
Google 會經常重新生成這些摘要，確保摘要內容根據最新資訊更新。提出 Places API (新版) 要求時，應用程式會顯示最新資料。
遷移至 Places API (新版)
如果您是 Places API (舊版) 的現有客戶，且想將應用程式遷移至 Places API (新版)，請參閱下列遷移說明文件：
- 遷移至 Place Details (新版)
- 遷移至 Nearby Search (新版)
- 遷移至 Text Search (新版)
- 遷移至 Place Photos (新版)
- 遷移至 Autocomplete (新版)