このページは Cloud Translation API によって翻訳されました。

Snapshot API の概要

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

警告: getPlaces() メソッドと getWeather() メソッドによって公開される Places Context および Weather コンテキストシグナルはサポートが終了しました。

プレイスコンテキストシグナルは 2019 年 10 月 30 日まで無効になりましたが、このシグナルは既存の実装をご利用のお客様に限定されました。新しい実装では、プレイスのコンテキストシグナルの代わりに 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();
                }
            })

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