Snapshot API の概要

サポート終了のお知らせ: プレイスと天気のコンテキスト シグナル

警告: getPlaces() メソッドと getWeather() メソッドで公開されている場所と天気のコンテキスト シグナルは非推奨になりました。

• プレイスのコンテキスト シグナルがオフになりました。このシグナルの継続的な使用は、2019 年 10 月 30 日まで、既存の実装を使用しているお客様に限定されていました。新しい実装では、Places コンテキスト シグナルではなく Places SDK for Android を使用する必要があります。
• 天気コンテキスト シグナルも無効になりました。このシグナルの継続的な使用は、2020 年 1 月 31 日まで、既存の実装を使用しているお客様に限定されています。Google は、天気コンテキスト シグナルの代替機能を提供していません。

Snapshot API を使用して、ユーザーの現在の環境に関する情報を取得できます。Snapshot API を使用すると、さまざまなコンテキスト シグナルにアクセスできます。

• ユーザーのアクティビティが検出された（歩行中や運転中など）。
• 登録した近くのビーコン。
• ヘッドフォンの状態（接続されているかどうか）。
• 位置情報（緯度と経度を含む）。

システムはこれらの値をキャッシュに保存し、すばやく返すことができます。データがない場合、センシングと推論が行われ、最新の状態値が返されます。Awareness API は、公開 API を持つコンテキスト タイプの既存のデータ型を返します。

各コンテキスト シグナルには、対応する Snapshot API メソッドがあります。たとえば、現在検出されているアクティビティを取得するには、getDetectedActivity() を呼び出し、SuccessListener を使用して DetectedActivityResponse を取得します。次に、getActivityRecognitionResult() を呼び出して ActivityRecognitionResult を返します。これにより、実際のリクエスト データを取得できます。

次の例は、検出された最新のアクティビティを取得する方法を示しています。

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

リクエストデータでできることの詳細については、スナップショット データを取得するをご覧ください。