Places API(新版)では、パフォーマンスが向上して料金モデルが刷新されているため、Places API を使用するアプリを更新する価値があります。機能の比較について詳しくは、API を選択するをご覧ください。
このガイドでは、Places API(新版)と Places API の主な違いと、必要な変更に対処する方法について説明します。
Places API(新版)を有効にする
Places API(新版)の機能を利用するには、まず Google Cloud プロジェクトで Places API(新版)を有効にする必要があります。詳細については、Google Cloud プロジェクトを設定するをご覧ください。
アプリで使用する API キーに Places API (new) を追加しておく必要があります。詳しくは、API キーを使用するをご覧ください。
全般的な変更点
複数の API に適用される一般的な変更は次のとおりです。
- すべての新しい API では、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
- レスポンス形式としてサポートされているのは JSON のみです。
- Place Details(新版)、Nearby Search(新版)、およびテキスト検索(新版)でレスポンスで返すフィールドを指定するには、フィールド マスキングが必要です。詳細については、FieldMask をご覧ください。
- Nearby Search(新版) API と Text Search(新版) API は、Place Details(新版)によって返された場所の詳細と一致する場所の詳細をすべて返すようになりました。
- Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)の JSON レスポンス形式が既存の API の形式から変更されました。詳しくは、Places API レスポンスを移行するをご覧ください。
API 固有の変更
このセクションでは、各 API の次の移行ガイドについて説明します。