集計データ型

連続的に記録できるデータ（一定期間に複数のデータポイントがあるデータ）の場合、Google Fit プラットフォームはこのデータを集計し、計算結果を返すことができます。平均値でも、サマリーまたは合計でもかまいません。集計データを読み取ることで、これらの計算にかかる時間を節約し、アプリユーザーに有用な要約や平均を簡単に示すことができます。

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

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

アクティビティ

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

アクティビティの概要

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

REST

名前com.google.activity.summary
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
activity（int - enum）
ユーザーが行ったアクティビティのタイプ。アクティビティ タイプの一覧をご覧ください。
duration（int～ミリ秒）
アクティビティでその時間範囲内のすべてのセグメントの合計時間。
セグメント数（int - count）
このデータポイントの期間にわたる個別のアクティビティ セグメントの数。

Android

名前com.google.activity.summary
データ型オブジェクトAGGREGATE_Activity_SUMMARY
フィールド（形式 - 単位）
FIELD_activity（int - enum）
ユーザーが行ったアクティビティのタイプ。アクティビティ タイプの一覧をご覧ください。
FIELD_DURATION（int～ミリ秒）
アクティビティでその時間範囲内のすべてのセグメントの合計時間。
FIELD_NUM_SEGMENTS（int - count）
このデータポイントの期間にわたる個別のアクティビティ セグメントの数。

基礎代謝率（BMR）の概要

各データポイントは、ある期間におけるユーザーの基本的、最大、最小基礎代謝率を 1 日キロカロリーで表したものです。ユーザーの体重が増加または減少したため、BMR が変化した場合に役立ちます。

REST

名前com.google.calories.bmr.summary
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
average（float - 1 日 kcal）
一定期間におけるユーザーの平均 BMR。
max（float - 1 日 kcal）
一定期間におけるユーザーの最大 BMR。
min（float - 1 日 kcal）
一定期間におけるユーザーの BMR の最小額。

Android

名前com.google.calories.bmr.summary
データ型オブジェクトAGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - 1 日 kcal）
一定期間におけるユーザーの平均 BMR。
FIELD_MAX（float - 1 日 kcal）
一定期間におけるユーザーの最大 BMR。
FIELD_MIN（float - 1 日 kcal）
一定期間におけるユーザーの BMR の最小額。

消費カロリーの概要

一定期間の消費カロリーの総計または合計カロリー。このデータ型とそのフィールドは、即時データ型と同じです。

ハートポイント（要約）

各データポイントは、一定期間に獲得したハートポイントの数を表します。

REST

名前com.google.heart_minutes.summary
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.activity.read
フィールド（形式 - 単位）
強度（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 - ワット）
期間中に生成されたユーザーの最小電力（ワット）。

ステップ数の差分の概要

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

Body

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

体脂肪率の概要

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

REST

名前com.google.body.fat.percentage.summary
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.body.read
フィールド（形式 - 単位）
average（float - percent）
一定期間の体脂肪率の総量に対するユーザーの平均割合。
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
フィールド（形式 - 単位）
average（float～ bpm）
一定期間における 1 分あたりの心拍数の平均ユーザー心拍数。
max（float～ bpm）
一定期間における 1 分あたりの拍動数の最大心拍数。
min（float～ bpm）
一定期間における 1 分間あたりの拍数の最小心拍数。

Android

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

身長のまとめ

各データポイントは、一定期間におけるユーザーの平均的、最大、最小の高さをメートル単位で表したものです。

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 つのフィールドがあります。

REST

名前com.google.location.bounding_box
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.location.read
フィールド（形式 - 単位）
低緯度（float - 度）
境界ボックスの最小緯度を浮動小数点数で表して、度数で指定します。
低経度（float - 度）
境界ボックスの最小経度。浮動小数点数（度単位）で指定します。
高緯度（float - 度）
境界ボックスの最大緯度。浮動小数点数で表され、度数で表されます。
高経度（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 - 列挙型）
ユーザーがどのような食事を食べたか（この期間内のすべての食事が同じ食事に関するものである場合）。
栄養素（Map<String> - カロリー / グラム）
一定期間に摂取された食品の栄養素の総量。

Android

名前com.google.nutrition.summary
データ型オブジェクトAGGREGATE_NUTRITION_SUMMARY
フィールド（形式 - 単位）
FIELD_MEAL_TYPE（int - 列挙型）
ユーザーがどのような食事を食べたか（この期間内のすべての食事が同じ食事に関するものである場合）。
FIELD_NUTRIENTS（Map<String> - Kilocalories/grams/milligrams）
一定期間に摂取された食品の栄養素の総量。

健康

これらのデータ型は、医療と健康に関する集計データを読み取るために使用します。

血糖値の概要

各データポイントは、ある期間における平均の血糖値または血糖値の平均または濃度を表します。1 mmol/L は 18 mg/dL となります。

これらの各フィールドの値が期間中に測定されたすべての測定値で同じである場合、返されるデータ内にフィールド値が表示されます。

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

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

REST

名前com.google.blood_glucose.summary
OAuth の権限スコープ
https://www.googleapis.com/auth/fitness.blood_glucose.read
フィールド（形式 - 単位）
average（float - mmol/L）
一定期間のユーザーの平均血糖値または濃度。
max（float - mmol/L）
一定期間におけるユーザーの最大血糖値または濃度。
min（float - mmol/L）
一定期間におけるユーザーの最小血糖値または濃度。
食事への一時的な関係（int - 列挙型）（オプションのフィールド）
測定値が取得されたタイミングとユーザーが食べた時間。
食事タイプ（int - 列挙型）（オプション フィールド）
読書をしたときにユーザーが食べた食事の種類。
睡眠との一時的な関係（int - 列挙型）（オプションのフィールド）
測定値とユーザー睡眠時間を比較。
標本ソース（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）
一定期間におけるユーザーの平均収縮期血圧。
最高血圧（float～ mmHg）
一定期間におけるユーザーの最高血圧血圧。
最低血圧（float～ mmHg）
一定期間における最低血圧最低血圧。
平均血圧（float～ mmHg）
ある期間におけるユーザーの平均血圧血圧。
最大拡張期（float～ mmHg）
一定期間のユーザーの最高血圧血圧。
最低血圧（float～ mmHg）
一定期間における最低血圧最低血圧。
body position（int - 列挙型）（オプション フィールド）
測定が行われたときのユーザーの身体の位置。
measurement location（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 - 摂氏）
一定期間におけるユーザーの最低体温。
measurement location（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/min）
一定期間の酸素流量の平均値とユーザーの平均値。
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 になります。