集計データ型

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

集計データを読み取るには、データ型、時間範囲、データの「バケット化」（またはグループ化）の基準を選択する必要があります。データはいくつかの方法でバケット化できます。

期間
時間単位または 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 日あたりのキロカロリー単位で表します。これは、ユーザーが体重を増やしたり減らしたりして、BMR が変化した場合に有用です。

REST

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

Android

名前com.google.calories.bmr.summary
データ型オブジェクトAGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
フィールド（形式 - 単位）
FIELD_AVERAGE（float - 1 日 kcal）
一定期間におけるユーザーの平均 BMR。
FIELD_MAX（float～ kcal/日）
一定期間におけるユーザーの最大 BMR。
FIELD_MIN（float～ 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
フィールド（形式 - 単位）
平均（float - ワット）
一定期間にユーザーが発電した平均電力（ワット）。
最大（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 分あたりの拍数）。
最大（float～ bpm）
一定期間におけるユーザーの最大心拍数（1 分あたりの拍数）。
分（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
フィールド（形式 - 単位）
平均（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
フィールド（形式 - 単位）
平均（float - kg）
一定期間におけるユーザーの平均体重（キログラム）。
最大（float - kg）
一定期間におけるユーザーの最大体重（キログラム）。
分（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
フィールド（形式 - 単位）
平均（float - メートル/秒）
一定期間におけるユーザーの平均速度（メートル/秒）。
max（float - メートル/秒）
一定期間におけるユーザーの最高速度（メートル/秒）。
min（float - メートル/秒）
一定期間におけるユーザーの最低速度（メートル/秒）。

Android

名前com.google.speed.summary
データ型オブジェクトAGGREGATE_SPEED_SUMMARY
フィールド（形式 - 単位）
平均（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> - キロカロリー/グラム/ミリグラム）
一定期間に摂取された食品の総栄養素。

健康

これらのデータ型を使用して、集計された医療や健康に関するデータを読み取ることができます。

血糖値の概要

各データポイントは、時間範囲の平均、最小、最大血糖値または濃度を 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）
一定期間におけるユーザーの血糖値または血糖値の平均値。
最大（float—mmol/L）
一定期間におけるユーザーの最大血糖値または最大血糖値。
分（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 - 列挙型）（オプション フィールド）
測定されたときのユーザーの身体の位置。
測定場所（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
フィールド（形式 - 単位）
平均（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 になることがあります。