はじめに
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(新版)、テキスト検索(新版)では、レスポンスで返すフィールドを指定するためにフィールド マスキングが必要です。詳細については、FieldMask をご覧ください。
- Nearby Search(新版) API と テキスト検索(新版) API が、Place Details(新版)で返される場所の詳細と一致する完全な場所の詳細を返すようになりました。
- Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)の各 API の JSON レスポンス形式は、既存の API の形式から変更されています。詳しくは、Places API レスポンスを移行するをご覧ください。
API 固有の変更
このセクションでは、各 API の移行ガイドについて説明します。
- Nearby Search(新版)に移行する
- テキスト検索(新版)に移行する
- Place Details(新版)に移行する
- Place Photos(新版)に移行する
- Autocomplete(新版)に移行する