簡介
Places API 可讓您使用文字字串或鄰近程度，搜尋及擷取各種地點類型的資訊。Places API (舊版) 是 Places API (新版) 的舊版。
下表列出這兩個 API 的對應版本。請參閱本指南，瞭解兩者的主要差異，並遷移至 Places API (新版)。
| Places API (舊版) | Places API (新推出) | 附註 |
|---|---|---|
| Find Place (舊版) | Text Search (新版) | Find Place (舊版) 沒有新版本。Text Search (新版) 已取代該服務。 |
| Nearby Search (舊版) | Nearby Search (新版) | 所有使用舊版 API 且包含文字查詢的要求，都應使用 Text Search (新版)，因為 Nearby Search (新版) 不支援文字輸入。 |
| Text Search (舊版) | Text Search (新版) | |
| Place Details (舊版) | Place Details (新版) | |
| Place Photos (舊版) | Place Photos (新版) | |
| Place Autocomplete (舊版) | Autocomplete (新版) | |
| Query Autocomplete (舊版) | Autocomplete (新版) | Autocomplete (新版) 新增的功能。 |
改用新版 API
如要改用新版 API，請參閱下列遷移指南：
- 遷移至 Nearby Search (新版)
- 遷移至 Text Search (新版)
- 遷移至 Place Details (新版)
- 遷移至 Place Photos (新版)
- 遷移至 Autocomplete (新版)
Places API (新版) 新增的主要功能
本節說明 Places API (新版) 新增的主要功能。
在 Google Cloud 標準平台上實作
Places API (新版) 是在 Google Cloud 的服務基礎架構上實作。這項實作可提供更安全可靠的平台，並提供 OAuth 等進階安全性選項。這種標準 API 設計可確保 API 之間的一致性，提高 Places API (新版) 的開發效率。
提高效能
Places API (新版) 的效能更佳，因此建議您替換使用現有 Places API 的應用程式。
簡化計費模式
Places API (新版) 簡化了定價模式，您只需依用量付費。簡化定價是使用欄位遮罩實作。
使用 Place Details (新版)、Nearby Search (新版) 和 Text Search (新版) 時，您可以使用欄位遮罩，控制要在回應中傳回的欄位清單。系統只會向您收取要求資料的費用。使用欄位遮蓋是良好的設計做法，可確保您不會要求不必要的資料，有助於避免不必要的處理時間和帳單費用。
地點的回應資料一致
使用舊版 API 時，Place Details (舊版)、Nearby Search (舊版) 和 Text Search (舊版) API 會針對同一個地點傳回不同的回應資料。Places API (新版) 標準化回應，因此這些 API 都會傳回相同的地點資料。
擴增地點類型
API 回應現在可包含地點的主要類型。每個地點都可以有一個指定為主要類型的類型值，如表 A 所示。
新版 API 也包含多種新類型。使用 Nearby Search (新版) 和 Text Search (新版) 搜尋時，您可以使用這些新類型和現有類型。新類型都包含在表 A 中。
動態地點資料
Places API (新版) 支援動態回應資料，例如電動車充電站的可用性，或加油站的最新油價。您可以使用這些回應欄位，打造動態使用者體驗。