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 (New) API 存取相片，並將圖片調整為最適合應用程式的大小。
向 Place Photo (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 要求傳回地點預測結果和查詢預測結果。在要求中，指定用來控制搜尋區域的文字搜尋字串和地理邊界。
工作階段符記是使用者產生的字串，可將 Autocomplete (新) 呼叫視為工作階段來追蹤。Autocomplete (新版) 會使用工作階段符記，將使用者自動完成搜尋的查詢和選取階段歸入不同的工作階段，以便計費。
新的欄位、屬性和無障礙選項
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 |
地點提供無障礙座位。 |
遷移至 New Places API
如果您是 Places API 現有客戶，且想將應用程式遷移至使用新版 API，請參閱下列遷移說明文件：