Places API (新版) 包含下列 API：
本文件概要說明這些新 API。
Place Details (新版)
地點 ID 可專門用來識別 Google 地方資訊資料庫中的某個地點 Google 地圖。使用地點 ID 即可要求特定的詳細資料 啟動 Place Details (新功能)，以建立建築物或搜尋點 請求。Place Details (新) 要求會傳回 例如完整地址、電話號碼、使用者評分 評論。
取得地點 ID 的方法有很多種，例如：
- Text Search (新版)
- Nearby Search (新版)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
Place Photo (新版)
Place Photo (New) 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」即可搜尋位於指定地區購物中心的披薩餐廳。
這兩種搜尋的主要差異在於，Text Search (新版) 可讓您指定任意搜尋字串，而 Nearby Search (新版) 則需要指定特定搜尋區域。
Autocomplete (New) 和工作階段符記
Autocomplete (新版) 是一種網路服務，可根據 HTTP 要求傳回地點預測結果和查詢預測結果。在要求中指定 搜尋字串和控制搜尋區域的地理邊界。
工作階段符記是使用者產生的字串，可將 Autocomplete (新) 呼叫追蹤為 工作階段。自動完成 (新版) 會使用工作階段符記，將查詢分組 使用者自動完成搜尋的選取階段，則會進入獨立的工作階段 帳單用途
新增欄位、屬性和無障礙選項
Places API (新版) 包含新的欄位、屬性和無障礙選項，可為使用者提供更多地點相關資訊。這些層面會在下文中說明。
欄位
Places API (新版) 包含以下幾個新欄位：
| 欄位 | 說明 |
|---|---|
regularSecondaryOpeningHours |
說明特定作業的特定時間。次要營業時間與商家的主要營業時間不同。適用對象 例如餐廳可以指定「免下車服務」或「外送」 以小時做為次要營業時間 |
paymentOptions |
地點接受的付款方式。一個地點可接受超過
多種付款方式如果沒有付款選項資料，系統會取消設定付款選項欄位。選項包括：
|
parkingOptions |
地點提供的停車位。選項包括：
|
subDestinations |
與特定地點相關的獨特地點。舉例來說，機場航廈可視為機場的子目的地。 |
fuelOptions |
有關燃油選項的最新資訊，
加油站。這項資訊會定期更新。選項包括：
|
evChargeOptions |
這個站點的電動車 (EV) 充電器數量。雖然部分電動車充電器有數個連接器，但每個充電器一次只能為一輛車充電，因此這個欄位會顯示特定時間可用的電動車充電器數量。 |
shortFormattedAddress |
人類可讀的簡短地點地址。 |
primaryType |
指定結果的主要類型。例如，某個地點
可歸類為 cafe 或 airport。A 罩杯
地點只能有一個主要類型。如需可能值的完整清單，請參閱「支援的類型」。 |
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，請參閱下列遷移說明文件：