はじめに
Places API を使用すると、テキスト文字列または近接度を使用して、さまざまな場所タイプの情報を検索して取得できます。Places API（従来版）は、Places API（新版）の従来バージョンです。
次の表に、両方の API の対応するバージョンを示します。このガイドを使用して、2 つの API の主な違いを理解し、Places API（新版）に移行してください。
| Places API（従来版） | Places API（新版） | メモ |
|---|---|---|
| Find Place（従来版） | テキスト検索（新版） | Find Place（従来版）の新しいバージョンはありません。テキスト検索（新版）に置き換えられました。 |
| Nearby Search（従来版） | Nearby Search（新版） | テキストクエリを含む従来版 API を使用するリクエストはすべて、 テキスト検索（新版） を使用する必要があります。Nearby Search（新版）ではテキスト入力がサポートされていないためです。 |
| テキスト検索（従来版） | テキスト検索（新版） | |
| Place Details（従来版） | Place Details（新版） | |
| Place Photos（従来版） | Place Photos（新版） | |
| Place Autocomplete（従来版） | 予測入力（新版） | |
| Query 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（新版）、テキスト検索（新版）では、フィールド マスクを使用して、レスポンスで返されるフィールドのリストを制御します。これにより、リクエストされたデータに対してのみ課金されます。フィールド マスキングを使用すると、不要なデータをリクエストしないようにできるため、不要な処理時間や課金が発生するのを防ぐことができます。
場所に関するレスポンス データの一貫性
従来版の API では、Place Details（従来版）、Nearby Search（従来版）、テキスト検索（従来版）の API は、場所に対して異なるレスポンス データを返していました。 Places API（新版）では、レスポンスが標準化されているため、これらの API はすべて、場所に対して同じデータを返します。
拡張された場所タイプ
API レスポンスに場所の主タイプを含めることができるようになりました。 すべての場所には、表 Aに示すように、場所の主タイプとして指定される単一のタイプ値を設定できます。
新しい API には、いくつかの新しいタイプも含まれています。これらの新しいタイプと既存のタイプは、Nearby Search（新版）とテキスト検索（新版）を使用した検索で使用できます。新しいタイプはすべて表 Aに含まれています。
動的な場所データ
Places API（新版）は、EV 充電スタンドの空き状況やガソリン スタンドの最新の燃料価格など、動的なレスポンス データをサポートしています。これらのレスポンス フィールドを使用して、動的なユーザー エクスペリエンスを作成します。