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 (Legacy)	地點詳細資料 (新版)
Place Photos (舊版)	Place Photos (新版)
Place 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 (新版) 的搜尋中使用這些新類型和現有類型。所有新類型都包含在 Table A 中。

動態地點資料

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