集計データ型

継続的に記録できるデータ（一定期間にわたる複数のデータポイント）の場合、Google Fit プラットフォームはこのデータを集計し、計算結果を返します。これは、平均値または合計値です。集計データを読み取ることで、これらの計算にかかる時間を節約し、アプリユーザーに役立つ概要や平均値を簡単に表示できます。

集計データを読み取るには、データ型、期間、データをバケット化（グループ化）するものを選択する必要があります。データをバケット化する方法はいくつかあります。

期間
バケットに集計されたデータを 1 時間ごとまたは 1 日ごとに分類します。たとえば、1 日あたりの歩数や消費カロリーを確認できます。
活動のタイプ
アクティビティ タイプ別に集計データをバケット化します。たとえば、1 週間分の睡眠データの場合、睡眠アクティビティのタイプ（浅い睡眠、深い睡眠、レム睡眠）ごとにバケットが作成されます。
アクティビティ セグメント
一定期間のアクティビティ セグメントごとにデータをバケットに集計します。たとえば、午前 9 時から午前 10 時の間にランニングをしたユーザーが、最初の 20 分間は走り、10 分間座り、15 分間歩き、15 分間走った場合、これは 4 つのアクティビティ セグメントと見なされ、4 つのバケットが返されます。
セッション
セッションの時間境界を使用してデータを集計します。たとえば、ユーザーが 2 回のランニングを行い、それが 2 つのセッション（朝のランニングと午後のランニング）として記録された場合、セッションごとにバケット化して、各ランニングの平均歩数や平均速度を把握できます。

アクティビティ

これらのデータ型を使用して、健康とウェルネスに関する集計データを読み取ります。

アクティビティの概要

特定の期間における特定のアクティビティの合計時間とセグメント数。各データポイントは、特定の期間における特定のアクティビティ タイプのすべてのアクティビティ セグメントの概要を表します。

REST

名前com.google.activity.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
activity（int - 列挙型）
ユーザーが行っていたアクティビティの種類。アクティビティ タイプのリストはこちらをご覧ください。
duration（int - ミリ秒）
期間内のすべてのセグメントでアクティビティに費やされた合計時間。
セグメント数（int - カウント）
このデータポイントの時間間隔における個別の活動セグメントの数。

Android

名前com.google.activity.summary
データ型オブジェクトAGGREGATE_ACTIVITY_SUMMARY
フィールド（形式 - 単位）
FIELD_ACTIVITY（int - 列挙型）
ユーザーが行っていたアクティビティの種類。アクティビティ タイプのリストはこちらをご覧ください。
FIELD_DURATION（int - ミリ秒）
期間内のすべてのセグメントでアクティビティに費やされた合計時間。
FIELD_NUM_SEGMENTS（int - カウント）
このデータポイントの時間間隔における個別の活動セグメントの数。

基礎代謝率（BMR）の概要

各データポイントは、その期間のユーザーの基礎代謝率の平均値、最大値、最小値を 1 日あたりのキロカロリーで表しています。これは、体重が増減して基礎代謝量が変化したユーザーに役立ちます。

REST

名前com.google.calories.bmr.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
average（float - 1 日あたりの kcal）
一定期間のユーザーの平均基礎代謝量。
max（float - 1 日あたりのキロカロリー）
期間中のユーザーの最大基礎代謝量。
min（float - 1 日あたりのカロリー）
一定期間のユーザーの最小 BMR。

Android

名前com.google.calories.bmr.summary
データ型オブジェクトAGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - 1 日あたりのキロカロリー）
一定期間のユーザーの平均基礎代謝量。
FIELD_MAX（float - 1 日あたりのキロカロリー）
期間中のユーザーの最大基礎代謝量。
FIELD_MIN（float - 1 日あたりのキロカロリー）
一定期間のユーザーの最小 BMR。

消費カロリーの概要

一定期間の総消費カロリー（キロカロリー単位）。このデータ型とそのフィールドは、瞬時データ型と同じです。

ハートポイント（強めの運動）の概要

各データポイントは、その期間に獲得した心拍ゾーン（分）の数を示しています。

REST

名前com.google.heart_minutes.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
intensity（float - ハートポイント）
期間中に獲得したハートポイントの数。倍率によって獲得したポイントも含まれます（より激しいアクティビティほど、より多くのポイントを獲得できます）。
duration（float - 分）
ハートポイントを獲得した時間（分単位）。

Android

名前com.google.heart_minutes.summary
データ型オブジェクトAGGREGATE_HEART_POINTS
フィールド（形式 - 単位）
FIELD_INTENSITY（float - ハートポイント（強めの運動））
期間中に獲得したハートポイントの数。倍率によって獲得したポイントも含まれます（より激しいアクティビティほど、より多くのポイントを獲得できます）。
FIELD_DURATION（float 分）
ハートポイントを獲得した時間（分単位）。

通常の運動（分）の概要

期間中のムーブ時間の合計。このデータ型とフィールドは、瞬時データ型と同じです。

電力の概要

各データポイントは、ある期間にわたってユーザーが生成した平均、最大、最小の電力をワット単位で表します。

REST

名前com.google.power.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
average（float - ワット）
期間中のユーザーの平均発電量（ワット単位）。
max（float - ワット）
期間中にユーザーが生成した最大出力（ワット単位）。
min（float - ワット）
期間中のユーザーの最小発電量（ワット単位）。

Android

名前com.google.power.summary
データ型オブジェクトAGGREGATE_POWER_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - ワット）
期間中のユーザーの平均発電量（ワット単位）。
FIELD_MAX（float - ワット）
期間中にユーザーが生成した最大出力（ワット単位）。
FIELD_MIN（float - ワット）
期間中のユーザーの最小発電量（ワット単位）。

歩数の差分の概要

各データポイントは、期間内の歩数の合計を表します。このデータ型とそのフィールドは、瞬時データ型と同じです。

本文

これらのデータ型を使用して、集計された身体測定データを読み取ります。

体脂肪率の概要

各データポイントは、ある期間におけるユーザーの体脂肪率の平均値、最大値、最小値を表します。

REST

名前com.google.body.fat.percentage.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.body.read
フィールド（形式 - 単位）
平均（float - パーセント）
一定期間における、ユーザーの総体重に対する体脂肪の平均割合。
max（float - パーセント）
ある期間における、ユーザーの総体重に対する体脂肪の最大割合。
min（float%）
一定期間における、ユーザーの総体重に対する体脂肪の最小割合。

Android

名前com.google.body.fat.percentage.summary
データ型オブジェクトAGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - パーセント）
一定期間における、ユーザーの総体重に対する体脂肪の平均割合。
FIELD_MAX（float - パーセント）
ある期間における、ユーザーの総体重に対する体脂肪の最大割合。
FIELD_MIN（float - パーセント）
一定期間における、ユーザーの総体重に対する体脂肪の最小割合。

心拍数の概要

各データポイントは、その期間のユーザーの平均心拍数、最大心拍数、最小心拍数を 1 分あたりの心拍数で表します。

REST

名前com.google.heart_rate.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.body.read
フィールド（形式 - 単位）
平均（float - bpm）
一定期間のユーザーの平均心拍数（1 分あたりの拍数）。
max（float～ bpm）
一定期間におけるユーザーの最大心拍数（拍/分）。
min（float - bpm）
一定期間におけるユーザーの最小心拍数（拍/分）。

Android

名前com.google.heart_rate.summary
データ型オブジェクトAGGREGATE_HEART_RATE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - bpm）
一定期間のユーザーの平均心拍数（1 分あたりの拍数）。
FIELD_MAX（float - bpm）
一定期間におけるユーザーの最大心拍数（拍/分）。
FIELD_MIN（float - bpm）
一定期間におけるユーザーの最小心拍数（拍/分）。

身長の概要

各データポイントは、一定期間にわたるユーザーの平均身長、最大身長、最小身長をメートル単位で表します。

REST

名前com.google.height.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.body.read
フィールド（形式 - 単位）
average（float - メートル）
一定期間のユーザーの平均身長（メートル単位）。
max（float メートル）
一定期間におけるユーザーの最大高度（メートル単位）。
min（float メートル）
一定期間におけるユーザーの最小高度（メートル単位）。

Android

名前com.google.height.summary
データ型オブジェクトAGGREGATE_HEIGHT_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - メートル）
一定期間のユーザーの平均身長（メートル単位）。
FIELD_MAX（float - メートル）
一定期間におけるユーザーの最大高度（メートル単位）。
FIELD_MIN（float - メートル）
一定期間におけるユーザーの最小高度（メートル単位）。

体重の概要

各データポイントは、ある期間のユーザーの体重の平均値、最大値、最小値をキログラムで表します。

REST

名前com.google.weight.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.body.read
フィールド（形式 - 単位）
average（float kg）
ユーザーの一定期間の平均体重（キログラム単位）。
max（float kg）
期間内のユーザーの最大体重（キログラム単位）。
min（float kg）
一定期間のユーザーの最小体重（キログラム単位）。

Android

名前com.google.weight.summary
データ型オブジェクトAGGREGATE_WEIGHT_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - kg）
ユーザーの一定期間の平均体重（キログラム単位）。
FIELD_MAX（float—kg）
期間内のユーザーの最大体重（キログラム単位）。
FIELD_MIN（float - kg）
一定期間のユーザーの最小体重（キログラム単位）。

場所

これらのデータ型を使用して、集計された位置情報を読み取ります。

距離の差分

各データポイントは、ユーザーが一定期間に移動した総距離（メートル単位）を表します。このデータ型とそのフィールドは、瞬時データ型と同じです。

位置情報の境界ボックス

各データポイントは、一定期間にわたるユーザーの位置情報ポイントから計算されたバウンディング ボックスを表します。各境界ボックスには、境界ボックスの 4 つの角を表す 4 つのフィールドがあります。

REST

名前com.google.location.bounding_box
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.location.read
フィールド（形式 - 単位）
低緯度（float - 度）
境界ボックスの最小緯度。浮動小数点数で表され、単位は度です。
低経度（float - 度）
境界ボックスの最小経度。浮動小数点数で表され、単位は度です。
high latitude（float - 度）
境界ボックスの最大緯度。浮動小数点数で表され、単位は度です。
high longitude（float - 度）
境界ボックスの最大経度。浮動小数点数で表され、単位は度です。

Android

名前com.google.location.bounding_box
データ型オブジェクトAGGREGATE_LOCATION_BOUNDING_BOX
フィールド（形式 - 単位）
FIELD_LOW_LATITUDE（float - 度）
境界ボックスの左下隅の緯度。浮動小数点数で表されます（単位: 度）。
FIELD_LOW_LONGITUDE（float - 度）
境界ボックスの左下隅の経度。浮動小数点数で表されます（度単位）。
FIELD_HIGH_LATITUDE（float - 度）
境界ボックスの右上隅の緯度。浮動小数点数で表されます（度単位）。
FIELD_HIGH_LONGITUDE（float - 度）
境界ボックスの右上隅の経度。浮動小数点数で表されます（度単位）。

速度の概要

各データポイントは、ユーザーが一定期間に移動した平均速度、最高速度、最低速度をメートル / 秒で表します。

REST

名前com.google.speed.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.location.read
フィールド（形式 - 単位）
average（float - メートル/秒）
ユーザーの一定期間の平均速度（メートル毎秒）。
max（float - メートル/秒）
一定期間におけるユーザーの最大速度（メートル/秒）。
min（float - メートル/秒）
一定期間におけるユーザーの最低速度（メートル毎秒）。

Android

名前com.google.speed.summary
データ型オブジェクトAGGREGATE_SPEED_SUMMARY
フィールド（形式 - 単位）
average（float - メートル/秒）
ユーザーの一定期間の平均速度（メートル毎秒）。
max（float - メートル/秒）
一定期間におけるユーザーの最大速度（メートル/秒）。
min（float - メートル/秒）
一定期間におけるユーザーの最低速度（メートル毎秒）。

栄養

これらのデータ型を使用して、集計された栄養データを読み取ります。

水分補給の概要

各データポイントは、ユーザーが一定期間に消費した水の総量をリットルで表します。このデータ型とそのフィールドは、瞬時データ型と同じです。

栄養の概要

各データポイントは、ある期間のすべての栄養情報の合計を表します。栄養素フィールドでは、各値は期間内のすべてのエントリの栄養素の合計を表します。

栄養素がエントリに含まれていない場合、集計マップにも含まれません。期間内のすべてのエントリが同じ食事の場合、食事の種類も設定されます。

REST

名前com.google.nutrition.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.nutrition.read
フィールド（形式 - 単位）
食事の種類（int - 列挙型）
ユーザーが食べた食事の種類（期間内のすべてのエントリが同じ食事の場合に表示されます）。
nutrients（Map<String> - カロリー/グラム）
一定期間に摂取した食品に含まれる栄養素の合計量。

Android

名前com.google.nutrition.summary
データ型オブジェクトAGGREGATE_NUTRITION_SUMMARY
フィールド（形式 - 単位）
FIELD_MEAL_TYPE（int - 列挙型）
ユーザーが食べた食事の種類（期間内のすべてのエントリが同じ食事の場合に表示されます）。
FIELD_NUTRIENTS（Map<String> - キロカロリー/グラム/ミリグラム）
一定期間に摂取した食品に含まれる栄養素の合計量。

健康

これらのデータ型を使用して、集計された医療データと健康データを読み取ります。

血糖値の概要

各データポイントは、その期間の平均、最小、最大血糖値または濃度を表します。単位は mmol/L です。1 mmol/L は 18 mg/dL です。

この期間中に取得されたすべての測定値で、これらの各フィールドの値が全バージョンに対し有効である場合、返されるデータにフィールド値が表示されます。

  • 食事との時間的関係
  • 睡眠との時間的関係
  • 検体の採取元

値が測定間で異なる場合、フィールドは除外されます。

REST

名前com.google.blood_glucose.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.blood_glucose.read
フィールド（形式 - 単位）
平均値（float - mmol/L）
一定期間のユーザーの平均血糖値または濃度。
max（float～ mmol/L）
一定期間におけるユーザーの最大血糖値または濃度。
min（float - mmol/L）
一定期間におけるユーザーの最低血糖値または濃度。
食事との時間的関係（int - 列挙型）（省略可能なフィールド）
測定値が取得された時間とユーザーが食事をした時間。
meal type（int - 列挙型）（省略可能なフィールド）
測定時にユーザーが摂取した食事の種類。
睡眠との時間的関係（int - 列挙型）（省略可能なフィールド）
測定が行われた時間とユーザーが睡眠をとった時間。
specimen source（int - 列挙型）（省略可能なフィールド）
血糖値の測定に使用された体液の種類。

Android

名前com.google.blood_glucose.summary
データ型オブジェクトAGGREGATE_BLOOD_GLUCOSE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - mmol/L）
一定期間のユーザーの平均血糖値または濃度。
FIELD_MAX（float - mmol/L）
一定期間におけるユーザーの最大血糖値または濃度。
FIELD_MIN（float - mmol/L）
一定期間におけるユーザーの最低血糖値または濃度。
FIELD_TEMPORAL_RELATION_TO_MEAL（int - 列挙型）（省略可能なフィールド）
測定値が取得された時間とユーザーが食事をした時間。
FIELD_MEAL_TYPE（int - 列挙型）（省略可能なフィールド）
測定時にユーザーが摂取した食事の種類。
FIELD_TEMPORAL_RELATION_TO_SLEEP（int - 列挙型）（省略可のフィールド）
測定が行われた時間とユーザーが睡眠をとった時間。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE（int - 列挙型）（省略可能なフィールド）
血糖値の測定に使用された体液の種類。

血圧の概要

各データポイントは、測定期間の平均血圧、最低血圧、最高血圧を表します（単位は mmHg）。

この期間中に取得されたすべての測定値で、これらの各フィールドの値が全バージョンに対し有効である場合、返されるデータにフィールド値が表示されます。

  • 体位
  • 測定場所

値が測定間で異なる場合、フィールドは除外されます。

REST

名前com.google.blood_pressure.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.blood_pressure.read
フィールド（形式 - 単位）
平均収縮期血圧（float - mmHg）
一定期間のユーザーの平均収縮期血圧。
max systolic（float - mmHg）
一定期間におけるユーザーの最大収縮期血圧。
min systolic（float—mmHg）
一定期間におけるユーザーの最低収縮期血圧。
平均最低血圧（float - mmHg）
一定期間のユーザーの平均最低血圧。
max diastolic（float - mmHg）
一定期間におけるユーザーの最大拡張期血圧。
min diastolic（float - mmHg）
一定期間のユーザーの最低血圧。
体の位置（int - 列挙型）（省略可能なフィールド）
測定時のユーザーの体の位置。
測定場所（int - 列挙型）（省略可能なフィールド）
測定が行われた腕と腕の部位。

Android

名前com.google.blood_pressure.summary
データ型オブジェクトAGGREGATE_BLOOD_PRESSURE_SUMMARY
フィールド（形式 - 単位）
FIELD_BLOOD_PRESSURE_SYSTOLIC_AVERAGE（float - mmHg）
一定期間のユーザーの平均収縮期血圧。
FIELD_BLOOD_PRESSURE_SYSTOLIC_MAX（float - mmHg）
一定期間におけるユーザーの最大収縮期血圧。
FIELD_BLOOD_PRESSURE_SYSTOLIC_MIN（float - mmHg）
一定期間におけるユーザーの最低収縮期血圧。
FIELD_BLOOD_PRESSURE_DIASTOLIC_AVERAGE（float - mmHg）
一定期間のユーザーの平均最低血圧。
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX（float - mmHg）
一定期間におけるユーザーの最大拡張期血圧。
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN（float - mmHg）
一定期間のユーザーの最低血圧。
FIELD_BODY_POSITION（int - 列挙型）（省略可能なフィールド）
測定時のユーザーの体の位置。
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION（int - 列挙型）（省略可能なフィールド）
測定が行われた腕と腕の部位。

体温の概要

各データポイントは、ユーザーの体温の平均値、最小値、最大値を一定期間にわたって表します。

また、測定場所が時間間隔内のすべてのデータポイントで同じだった場合は、身体のどの部分で測定が行われたかの場所も含まれます。

REST

名前com.google.body.temperature.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.body_temperature.read
フィールド（形式 - 単位）
average（float - 摂氏）
一定期間のユーザーの平均体温。
max（float - 摂氏）
期間中のユーザーの最高体温。
min（float - 摂氏）
一定期間のユーザーの最低体温。
測定場所（int - 列挙型）（省略可能なフィールド）
体温測定を行った体の部位。

Android

名前com.google.body.temperature.summary
データ型オブジェクトAGGREGATE_BODY_TEMPERATURE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - 摂氏）
一定期間のユーザーの平均体温。
FIELD_MAX（float - 摂氏）
期間中のユーザーの最高体温。
FIELD_MIN（float - 摂氏）
一定期間のユーザーの最低体温。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION（int - 列挙型）（省略可能なフィールド）
体温測定を行った体の部位。

酸素飽和度の概要

各データポイントは、ユーザーの血中酸素ウェルネスと酸素補給の流量の平均値、最小値、最大値を表します。

この期間中に取得されたすべての測定値で、これらの各フィールドの値が全バージョンに対し有効である場合、返されるデータにフィールド値が表示されます。

  • 酸素療法の投与モード
  • 酸素飽和度システム
  • 酸素飽和度の測定方法

値が測定間で異なる場合、フィールドは除外されます。

REST

名前com.google.oxygen_saturation.summary
OAuth 権限スコープ
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
フィールド（形式 - 単位）
平均酸素飽和度（float - パーセンテージ）
一定期間のユーザーの平均酸素飽和度。
最大酸素飽和度（float - 割合）
一定期間におけるユーザーの最大血中酸素飽和度。
最小酸素飽和度（float - パーセンテージ）
一定期間におけるユーザーの最低血中酸素飽和度。
平均酸素流量（float—L/分）
一定期間におけるユーザーの平均補助酸素流量。
最大補助酸素流量（float - L/分）
一定期間におけるユーザーの最大補助酸素流量。
最小酸素流量（float - L/分）
一定期間におけるユーザーの最小酸素流量。
酸素療法管理モード（int - 列挙型）（省略可）
酸素療法の実施方法。
鼻カニューレで投与する場合は、省略するか 1 にできます。
酸素飽和度システム（int - 列挙型）（省略可）
酸素飽和度を測定する場所。
末梢毛細血管で測定された場合は、欠落しているか 1 の可能性があります。
酸素飽和度の測定方法（int - 列挙型）（省略可能なフィールド）
酸素飽和度の測定方法。
パルスオキシメーターで測定された場合は、欠損しているか 1 になることがあります。

Android

名前com.google.oxygen_saturation.summary
データ型オブジェクトAGGREGATE_OXYGEN_SATURATION_SUMMARY
フィールド（形式 - 単位）
FIELD_OXYGEN_SATURATION_AVERAGE（float - 割合）
一定期間のユーザーの平均酸素飽和度。
FIELD_OXYGEN_SATURATION_MAX（float - パーセンテージ）
一定期間におけるユーザーの最大血中酸素飽和度。
FIELD_OXYGEN_SATURATION_MIN（float - パーセンテージ）
一定期間におけるユーザーの最低血中酸素飽和度。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_AVERAGE（float - L/分）
一定期間におけるユーザーの平均補助酸素流量。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MAX（float - L/分）
一定期間におけるユーザーの最大補助酸素流量。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MIN（float—L/分）
一定期間におけるユーザーの最小酸素流量。
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE（int - 列挙型）（省略可能なフィールド）
酸素療法の実施方法。
鼻カニューレで投与する場合は、省略するか 1 にできます。
FIELD_OXYGEN_SATURATION_SYSTEM（int - 列挙型）（省略可能なフィールド）
酸素飽和度を測定する場所。
末梢毛細血管で測定された場合は、欠落しているか 1 の可能性があります。
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD（int - 列挙型）（省略可能なフィールド）
酸素飽和度の測定方法。
パルスオキシメーターで測定された場合は、欠損しているか 1 になることがあります。