Places API (舊版) 總覽

Places API 可讓您使用文字字串或依據鄰近性，搜尋及擷取各種地點類型的資訊。Places API 是 Places API (新推出) 的舊版。

下表列出兩個 API 的對應版本。請參閱本指南，瞭解兩者的主要差異，並遷移至 Places API (新版)。

Places API (舊版)	Places API (新推出)	附註
Find Place (舊版)	文字搜尋 (新版)	沒有 Find Place 新版本。已由 Text Search (新版) 取代。
附近搜尋 (舊版)	Nearby Search (新版)	所有使用舊版 API 且包含文字查詢的要求，都應使用 Text Search (新版)，因為 Nearby Search (新版) 不支援文字輸入。
文字搜尋 (舊版)	文字搜尋 (新版)
Place Details (舊版)	Place Details (新版)
Place Photo (舊版)	Places Photo (新版)
Place Autocomplete (舊版)	自動完成 (新版)
Query Autocomplete (舊版)	自動完成 (新版)	新增功能已加入自動完成功能 (新版)。

遷移至新 API

如要改用新 API，請參閱下列遷移指南：

本節將介紹新增至 Places API 的關鍵功能。

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 也包含幾種新類型。您可以在使用鄰近搜尋 (新版) 和文字搜尋 (新版) 的搜尋中，使用這些新類型和現有類型。表 A列出所有新類型。

Places API (新版) 支援動態回應資料，例如電動車充電站的可用性，或加油站的最新油價。使用這些回應欄位，打造動態使用者體驗。