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

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

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

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

動的場所データ

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