Places API (新版) 包含下列 API：
本文將概略說明這些新 API。
Place Details (新版)
地點 ID 可用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。有了地點 ID，您就可以發出 Place Details (New) 要求，取得特定設施或興趣點的詳細資料。Place Details (New) 要求會傳回指定地點的完整資訊，例如完整地址、電話號碼、使用者評分和評論。
取得地點 ID 的方法有很多種，例如：
地點相片 (新版)
地點相片 (新版) 可讓您存取 Google 地點資料庫中的數百萬張相片，進而將高品質相片內容加入應用程式。您可以使用 Place Photos (新版) API 存取相片，並將圖片調整至應用程式最佳尺寸。
所有對 Place Photos (新版) API 的請求都必須包含相片資源名稱，以便系統唯一識別要傳回的相片。您可以使用下列方法取得相片資源名稱：
如要在 Place Details (新版)、Text Search (新版) 或 Nearby Search (新版) 要求的回應中加入相片資源名稱，請務必在要求的欄位遮罩中加入 photos 欄位。
Text Search (新版) 和 Nearby Search (新版)
Places API 包含兩個搜尋 API：
-
讓您指定要用來搜尋地點的文字字串。例如：「澳洲雪梨的辛辣素食」或「加州帕羅奧圖附近的海鮮餐廳」。
您可以指定價格等級、目前營業狀態、評分或特定地點類型等詳細資料，以便進一步縮小搜尋範圍。您也可以指定將結果偏向特定地點，或將搜尋範圍限制在特定地點。
-
可讓您指定要搜尋的區域，以及地點類型清單。將區域指定為以圓形定義的區域，圓心為經緯度座標，半徑以公尺為單位。
指定一或多個地點類型，定義地點的特性。舉例來說，指定「
pizza_restaurant」和「shopping_mall」即可搜尋位於指定地區購物中心的披薩餐廳。
這兩種搜尋功能的主要差異在於，文字搜尋 (新版) 可讓您指定任意搜尋字串，而搜尋附近 (新版) 則需要指定特定搜尋區域。
Autocomplete (New) 和工作階段符記
Autocomplete (新版) 是一種網路服務，可根據 HTTP 要求傳回地點預測結果和查詢預測結果。在要求中指定文字搜尋字串和地理範圍，以控制搜尋範圍。
工作階段符記是使用者產生的字串，可將自動完成 (新) 呼叫追蹤為工作階段。Autocomplete (New) 會使用工作階段符記，將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以用於計費。
新增欄位、屬性和無障礙選項
Places API (新版) 包含新的欄位、屬性和無障礙選項，可為使用者提供更多關於地點的資訊。這些方面會在後續章節中說明。
欄位
Places API (新版) 包含以下幾個新欄位：
| 欄位 | 說明 |
|---|---|
regularSecondaryOpeningHours |
說明特定作業的特定時間。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將得來速營業時間或外送營業時間指定為次要營業時間。 |
paymentOptions |
商家接受的付款方式。地點可以接受多種付款方式。如果沒有付款選項資料，系統會取消設定付款選項欄位。選項包括：
|
parkingOptions |
地點提供的停車選項。選項包括：
|
subDestinations |
與特定地點相關的獨特地點。舉例來說，機場航廈可視為機場的子目的地。 |
fuelOptions |
關於加油站提供的燃料選項的最新資訊。這項資訊會定期更新。選項包括：
|
evChargeOptions |
這個站點的電動車充電器數量。雖然部分電動車充電器有數個連接器，但每個充電器一次只能為一輛車充電，因此這個欄位會顯示特定時間可用的電動車充電器數量。 |
shortFormattedAddress |
地點的簡短地址，人類可讀。 |
primaryType |
指定結果的主要類型。舉例來說，地點可能會歸類為 cafe 或 airport。地點只能有單一主要類型。如需可能值的完整清單，請參閱「支援的類型」。 |
primaryTypeDisplayName |
主要類型的顯示名稱，並根據要求語言進行本地化 (如適用)。如需可能值的完整清單，請參閱「支援的類型」。 |
屬性
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 技術輔助摘要可提供附近景點和設施的概況。
新增 AI 輔助功能至 Places API (新功能)
Place Details (新版)、Text Search (新版) 和 Nearby Search (新版) 支援 AI 輔助摘要。Places API (新版) 回應提供下列 AI 技術輔助摘要：
Google 會經常重新產生這些摘要，確保摘要內容根據最新可用資訊保持新鮮。提出 Places API (新版) 要求時，您會在應用程式中顯示最新的資料。
遷移至新版 Places API
如果您是現有的 Places API (新版) 客戶，並想將應用程式遷移至使用新版 API，請參閱下列遷移說明文件：
- 遷移至 Place Details (新版)
- 遷移至 Nearby Search (新功能)
- 遷移至 Text Search (新版)
- 遷移至 Place Photos (新版)
- 遷移至 Autocomplete (新功能)