このページは Cloud Translation API によって翻訳されました。

移行の概要

Places API（新版）はパフォーマンスが向上し、新しい料金モデルが導入されているため、Places API を使用するアプリを更新する価値があります。機能の比較について詳しくは、API を選択するをご覧ください。

このガイドでは、Places API（新規）と Places API の主要な違いと、必要な変更を処理する方法について説明します。

移行の請求に関するベストプラクティス

このガイダンスは、API の使用量が 2 番目の料金階層に移行するほど多い場合に適用されます。新しいバージョンの API に移行すると、別の SKU でも課金されます。移行月の費用増加を回避するため、本番環境で新しい API にできるだけ早く切り替えることをおすすめします。これにより、移行月中に最も費用対効果の高い月額料金階層に達することができます。料金階層については、料金ページと料金に関するよくある質問をご覧ください。

Places API（新版）を有効にする

Places API（新版）の機能を使用するには、まず Google Cloud プロジェクトで Places API（新版）を有効にする必要があります。詳細については、Google Cloud プロジェクトを設定するをご覧ください。

次に、アプリで使用している API キーに Places API（新規）を追加する必要があります。詳細については、API キーを使用するをご覧ください。

全般的な変更点

複数の API に適用される一般的な変更には、次のようなものがあります。

新しい API はすべて、認証メカニズムとして API キーと OAuth トークンの両方をサポートしています。
レスポンス形式としてサポートされているのは JSON のみです。
Place Details（新版）、Nearby Search（新版）、Text Search（新版）では、レスポンスで返すフィールドを指定するためにフィールドマスキングが必要です。詳細については、FieldMask をご覧ください。
Nearby Search（新版） API と Text Search（新版） API が、Place Details（新版）で返される場所の詳細と一致するように、場所の詳細をすべて返すようになりました。
Place Details（新規）、Nearby Search（新規）、Text Search（新規） API の JSON レスポンス形式が、既存の API の形式から変更されました。詳しくは、Places API レスポンスの移行をご覧ください。

API 固有の変更

このセクションでは、各 API の次の移行ガイドについて説明します。