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 の次の移行ガイドが含まれています。