Places API (新版) 包含下列 API：
本文將概略說明這些新的 API。
Place Details (新版)
地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。有了地點 ID，您就可以發出 Place Details (New) 要求，取得特定設施或興趣點的詳細資料。Place Details (New) 要求會傳回指定地點的完整資訊，例如完整地址、電話號碼、使用者評分和評論。
取得地點 ID 的方法有很多種，例如：
Place Photo (新版)
Place Photo (新版) API 可讓您存取 Google 地點資料庫中數百萬張相片，進而將高品質相片內容加入應用程式。您可以使用 Place Photo (新版) API 存取相片，並將圖片調整至應用程式最佳尺寸。
所有對 Place Photo (新版) 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 |
這個充電站的電動車 (EV) 充電器數量。雖然某些電動車充電器有數個連接器，但每個充電器一次只能為一輛車充電；因此，這個欄位會顯示特定時間可用的電動車充電器數量。 |
shortFormattedAddress |
地點的簡短地址，可供人類閱讀。 |
primaryType |
指定結果的主要類型。舉例來說，地點可能會歸類為 cafe 或 airport。地點只能有單一主要類型。如需可能值的完整清單，請參閱「支援的類型」。 |
primaryTypeDisplayName |
主要類型的顯示名稱，並根據要求語言進行本地化 (如適用)。如需可能值的完整清單，請參閱「支援的類型」。 |
屬性
Places API (新推出) 包含多項新屬性：
| 屬性 | 說明 |
|---|---|
outdoorSeating |
提供戶外座位。 |
liveMusic |
提供現場音樂表演。 |
menuForChildren |
餐廳提供兒童菜單。 |
servesCocktails |
這家店供應雞尾酒。 |
servesDessert |
這家店提供甜點。 |
servesCoffee |
這家店供應咖啡。 |
goodForChildren |
適合帶小孩入住。 |
allowsDogs |
地點允許帶狗。 |
restroom |
地點設有洗手間。 |
goodForGroups |
可容納團體。 |
goodForWatchingSports |
適合觀賞運動賽事。 |
無障礙選項
Places API (新版) 包含下列無障礙選項欄位：
| 欄位 | 說明 |
|---|---|
wheelchairAccessibleParking |
地點提供無障礙停車位。 |
wheelchairAccessibleEntrance |
地點設有無障礙入口。 |
wheelchairAccessibleRestroom |
地點提供無障礙洗手間。 |
wheelchairAccessibleSeating |
地點提供無障礙座位。 |
遷移至新版 Places API
如果您是現有的 Places API 客戶，並想要遷移應用程式以便使用新的 API，請參閱下列遷移說明文件：