これらのデータ型を使用して、アクティビティ、ワークアウト、エクササイズに関する指標をキャプチャできます。
アクティビティ
このデータ型は、ユーザーが行ったアクティビティをキャプチャするために使用できます。ランニングやさまざまなスポーツなどの一般的なフィットネス アクティビティのほか、瞑想、ガーデニング、睡眠などのアクティビティも含まれます。
ユーザーがその期間に複数のアクティビティを行っていた場合は、メインのアクティビティ タイプ用のセッションと、異なるアクティビティ タイプ用の複数のセグメントを作成します。たとえば、総合格闘技のクラスでキックボクシングとボクシングを少し行った場合は、総合格闘技のセッションを作成します。その後、さまざまなアクティビティ タイプをセグメントに分類できます。
各データポイントには開始時間と終了時間が必要です。データポイントは連続している必要はなく、間隔があってもかまいません。
REST
| 名前 | com.google.activity.segment |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | アクティビティ タイプ(int - 列挙型)
ユーザーが行っていたアクティビティの種類。アクティビティ タイプのリストはこちらをご覧ください。 |
Android
| 名前 | com.google.activity.segment |
| データ型オブジェクト | TYPE_ACTIVITY_SEGMENT |
| Android の権限 | ACTIVITY_RECOGNITION |
| フィールド(形式 - 単位) | FIELD_ACTIVITY (int - 列挙型)
ユーザーが行っていたアクティビティの種類。アクティビティ タイプのリストはこちらをご覧ください。 |
基礎代謝率(BMR)
このデータ型は、ユーザーの基礎代謝量(キロカロリー単位)を取得します。各データポイントは、ユーザーの身長と体重に基づいて、1 日中安静にしていた場合に消費するキロカロリー数を表します。終了時間のみを設定する必要があります。これは、読み取りのタイムスタンプとして使用されます。
REST
| 名前 | com.google.calories.bmr |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | カロリー(float - 1 日あたりのキロカロリー)
身長と体重に基づいて、1 日中安静にしていた場合に消費されるキロカロリー数。 |
Android
| 名前 | com.google.calories.bmr |
| データ型オブジェクト | TYPE_BASAL_METABOLIC_RATE |
| フィールド(形式 - 単位) | FIELD_CALORIES(float - 1 日あたりのキロカロリー)
年齢、体重、身長に基づいて、1 日中安静にしていた場合に消費されるキロカロリー数。 |
消費カロリー
このデータ型は、ユーザーが消費した総カロリー(キロカロリー単位)をキャプチャします。これには、安静時の消費カロリー(BMR)も含まれます。各データポイントは、ある期間に消費された総キロカロリーを表すため、開始時間と終了時間の両方を設定する必要があります。
REST
| 名前 | com.google.calories.expended |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | calories(float - kcal)
消費したキロカロリー数。 |
Android
| 名前 | com.google.calories.expended |
| データ型オブジェクト | TYPE_CALORIES_EXPENDED |
| Android の権限 | ACTIVITY_RECOGNITION |
| フィールド(形式 - 単位) | FIELD_CALORIES(float - kcal)
消費したキロカロリー数。 |
サイクリング ペダル ケイデンス
ユーザーがサイクリングを行う場合、このデータ型を使用して、クランクの 1 分あたりの回転数(RPM)でペダリングの速度をキャプチャできます。各データポイントはペダリング速度の瞬間の測定値を表すため、終了時刻のみを設定する必要があります。これは、読み取りのタイムスタンプとして使用されます。
REST
| 名前 | com.google.cycling.pedaling.cadence |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | rpm(float - rpm)
1 分あたりの自転車のクランク回転数。 |
Android
| 名前 | com.google.cycling.pedaling.cadence |
| データ型オブジェクト | TYPE_CYCLING_PEDALING_CADENCE |
| フィールド(形式 - 単位) | FIELD_RPM(float - rpm)
1 分あたりの自転車のクランク回転数。 |
サイクリング ペダル累積
ユーザーがサイクリングをする場合、このデータ型を使用して、一定期間のクランク回転数をキャプチャできます。各データポイントは、開始時点のカウントからの回転数を表します。
REST
| 名前 | com.google.cycling.pedaling.cumulative |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | revolutions(int - カウント)
一定期間の自転車のクランクの回転数。 |
Android
| 名前 | com.google.cycling.pedaling.cumulative |
| データ型オブジェクト | TYPE_CYCLING_PEDALING_CUMULATIVE |
| フィールド(形式 - 単位) | FIELD_REVOLUTIONS(int - カウント)
一定期間の自転車のクランクの回転数。 |
ハートポイント(強めの運動)
このデータ型は、ユーザーがすべてのアクティビティで獲得したハートポイント(強めの運動)の数を記録します。各データポイントは、ある時間間隔で計算された心拍ゾーンの数を表します。
ユーザーは 1 日のハートポイント(強めの運動)の目標を設定し、進捗状況を追跡できます。心拍ゾーンは、次の方法で計算できます。
- 心拍数
- Metabolic Equivalent of Task(MET)値
- 歩行速度
獲得できるハートポイントの数は、アクティビティの強度によって異なります。このガイドに沿って、ハートポイント(強めの運動)を計算して書き込みます。
| データ | 1 HP(低~中程度の強度の運動) | 2 HP(高強度の活動) |
|---|---|---|
| 心拍数 | 最大心拍数の 50% を超える 1 分間のアクティビティ | 最大心拍数の 70% を超える 1 分間のアクティビティ |
| MET 値 | 3 ~ 6 MET。(ボートやロッククライミングなど)。 | >6 MET。たとえば、HIIT、スキー、バレーボール、サッカーなどです。 |
| ウォーキングの速度 | 1 分あたり 100 ~ 130 歩 | 1 分あたり 130 歩以上 |
REST
| 名前 | com.google.heart_minutes |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | intensity(float - ハートポイント)
ユーザーが行ったエクササイズやアクティビティの強度に基づいて獲得したハートポイント(強めの運動)。 |
Android
| 名前 | com.google.heart_minutes |
| データ型オブジェクト | TYPE_HEART_MINUTES |
| フィールド(形式 - 単位) | FIELD_INTENSITY(float - 心拍ゾーン)
ユーザーが行う運動やアクティビティの強度。1 分間の軽度から中程度の身体活動(時速 4 km を超えるウォーキングや時速 16 km を超えるサイクリングなど)で、ハートポイント(強めの運動)1 ポイントを獲得できます。強度の高い運動を 1 分間行うと、ハートポイント(強めの運動)が 2 ポイント獲得できます。 |
通常の運動(分)
このデータ型には、ユーザーがすべてのアクティビティで獲得したと Google Fit が計算した通常の運動(分)の合計時間が記録されます。各データポイントは、時間間隔の推定移動時間(分)を表します。開始時間と終了時間の両方を設定する必要があります。
ヨガ、ダンス、ガーデニング、その他の家事など、あらゆるアクティビティで「通常の運動(分)」を獲得できます。ウォーキングをすると、60 秒以内に 30 歩以上歩くたびに、ムーブメント 1 分が記録されます。
REST
| 名前 | com.google.active_minutes |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | duration(int - ミリ秒)
獲得した通常の運動(分)の時間の長さ(ミリ秒単位)。
有効な範囲: >=0 |
Android
| 名前 | com.google.active_minutes |
| データ型オブジェクト | TYPE_MOVE_MINUTES |
| フィールド(形式 - 単位) | FIELD_DURATION(int - ミリ秒)
獲得した通常の運動(分)の時間の長さ(ミリ秒単位)。
有効な範囲: 0 ~ Long.MAX_VALUE |
電源
このデータ型は、ユーザーがアクティビティを行ったときに生成したパワーをワット単位で取得します。たとえば、エアロバイクで運動するときにパワーメーターを使用する場合です。各データポイントは、発電量の瞬時測定値を表します。
各データポイントは生成された電力の瞬間的な測定値を表すため、終了時間のみを設定する必要があります。これは、読み取りのタイムスタンプとして使用されます。
REST
| 名前 | com.google.power.sample |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | watts(float - ワット)発電量(ワット単位)。 |
Android
| 名前 | com.google.power.sample |
| データ型オブジェクト | TYPE_POWER_SAMPLE |
| フィールド(形式 - 単位) | FIELD_WATTS(float - ワット)
発電量(ワット単位)。 |
歩数の回転数
このデータ型は、1 分あたりの歩数で測定された歩行の歩調をキャプチャします。各データポイントは、1 分あたりの歩数で表される歩調の瞬間の測定値を表します。
REST
| 名前 | com.google.step_count.cadence |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
| フィールド(形式 - 単位) | rpm(float - 歩数/分)
歩調(1 分あたりの歩数)。 |
Android
| 名前 | com.google.step_count.cadence |
| データ型オブジェクト | TYPE_STEP_COUNT_CADENCE |
| フィールド(形式 - 単位) | FIELD_RPM(float - 歩/分)
歩調(1 分あたりの歩数)。 |
歩数の差分
このデータ型には、最後の読み取り以降に歩いた歩数が記録されます。各ステップは 1 回のみ報告されるため、データポイントに重複する時間を含めることはできません。各データポイントの開始時間は、歩数が記録された期間の開始を表す必要があります。
開始時間は、前のデータポイントの終了時間以上にする必要があります。ある期間のすべての値を合計すると、その期間の歩数の合計が計算されます。
REST
| 名前 | com.google.step_count.delta | |
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
|
| フィールド(形式 - 単位) |
|
Android
| 名前 | com.google.step_count.delta | |
| データ型オブジェクト | TYPE_STEP_COUNT_DELTA | |
| Android の権限 | ACTIVITY_RECOGNITION | |
| フィールド(形式 - 単位) |
|
ワークアウト
各データポイントは、ユーザーが実行したワークアウト エクササイズの連続したセットを 1 つ表します。データポイントには、エクササイズの種類(レジスタンス エクササイズやウェイト トレーニングなど)、エクササイズの繰り返し回数、エクササイズの時間、抵抗のフィールドが含まれます。
REST
| 名前 | com.google.activity.exercise | |||||
| OAuth 権限スコープ |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
|||||
| フィールド(形式 - 単位) |
|
Android
| 名前 | com.google.activity.exercise | |||||
| フィールド(形式 - 単位) |
|