Places API（従来版）の概要

Places API を使用すると、テキスト文字列または近接性に基づいて、さまざまな場所のタイプに関する情報を検索して取得できます。Places API は、Places API（新版）の以前のバージョンです。

次の表に、両方の API の対応するバージョンを示します。このガイドでは、2 つの API の主な違いを理解し、Places API（新規）に移行する方法について説明します。

Places API（以前のバージョン）	Places API（新規）	メモ
Find Place（従来版）	テキスト検索（新規）	Find Place の新しいバージョンはありません。テキスト検索（新版）に置き換わりました。
Nearby Search（従来）	Nearby Search（新規）	Nearby Search（新版）はテキスト入力をサポートしていないため、テキストクエリを含む以前の API を使用するリクエストはすべて、Text Search（新版）を使用する必要があります。
テキスト検索（従来版）	テキスト検索（新規）
Place Details（以前の方法）	Place Details（新規）
Place Photo（従来版）	Place Photo (New)
Place Autocomplete（従来版）	Autocomplete（新規）
クエリ自動補完（従来版）	Autocomplete（新規）	Autocomplete（新規）に機能が追加されました。

新しい API に移行する

新しい API に移行するには、次の移行ガイドをご覧ください。

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 API、Nearby Search API、Text Search API は、場所に対して異なるレスポンスデータを返していました。Places API（新規）ではレスポンスが標準化されているため、これらの API はすべて、場所について同じデータを返します。

拡張されたプレイスタイプ

API レスポンスに、場所のプライマリタイプを含めることができるようになりました。すべての場所には、表 A に示すように、場所の主なタイプとして指定される単一のタイプ値を設定できます。

新しい API には、いくつかの新しい型も含まれています。これらの新しいタイプと既存のタイプは、Nearby Search（新版）と Text Search（新版）の検索で使用できます。新しいタイプはすべて表 A に記載されています。

動的場所データ

Places API（新規）は、EV 充電スタンドの空き状況やガソリンスタンドの最新の燃料価格などの動的レスポンスデータをサポートしています。これらのレスポンスフィールドを使用して、動的なユーザーエクスペリエンスを作成します。