移行の概要

欧州経済領域(EEA)のデベロッパー

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

このガイドでは、Places SDK for Android(新規)と Places SDK for Android(以前のバージョン)の主な違いと、必要な変更を処理する方法について説明します。

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

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

Places SDK for Android(新規)を有効にする

Places SDK for Android(レガシー)は、Places API サービスに依存しています。Places SDK for Android(新版)の機能を使用するには、まず Google Cloud プロジェクトで Places API(新版)を有効にする必要があります。詳細については、Google Cloud プロジェクトを設定するをご覧ください。

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

全般的な変更点

複数の API に適用される一般的な変更は次のとおりです。

  • 新しい料金モデルを使用します。すべての API の料金については、 Places SDK for Android(新版)をご覧ください。

  • Place Details(新版) Nearby Search(新版) テキスト検索(新版)では、レスポンスで返されるフィールドを指定するためにフィールド マスクが必要です。

  • リクエストを定義したり、レスポンスに新しいフィールドを追加したりするための新しいクラスが追加されました。

  • レスポンスの Place オブジェクトには、Review オブジェクトのリストを返す新しい getReviews() メソッドが含まれています。アプリが Place オブジェクトから取得した情報(写真やクチコミなど)を表示する場合、アプリは必要な帰属情報も表示する必要があります。

    詳細については、アトリビューションに関するドキュメントをご覧ください。

API 固有の変更

このセクションには、各 API の次の移行ガイドが含まれています。