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