寫入血壓資料

應用程式可以透過寫入 com.google.blood_pressure 資料類型來記錄血壓資料。在這個資料類型中,每個資料點都代表一個即時的血壓讀數。資料點包含收縮壓和舒壓壓力的欄位、讀取期間的身體位置,以及測量結果的主體位置。

  • systolicdiastolic 為必要欄位,其他均為選填欄位。
  • systolic (上限) 和 diastolic (最小值) 的壓力是以 mmHg 為單位。
  • 如有指定,主體位置必須含有下列其中一個值:
    • 1 - 站立
    • 2 - 坐著
    • 3 - 躺下
    • 4 - 半階
  • 如果有指定,測量位置必須具有下列其中一個值:

    • 1 - 左手腕
    • 2 - 右手腕
    • 3 - 左上臂
    • 4 - 右上臂

Android

如要寫入血壓資料點,請建立 TYPE_BLOOD_PRESSURE 的新 DataSource,如以下範例所示。

val bloodPressureSource = DataSource.Builder()
    .setDataType(TYPE_BLOOD_PRESSURE)
    // ...
    .build()

val bloodPressure = DataPoint.builder(bloodPressureSource)
    .setTimestamp(timestamp, TimeUnit.MILLISECONDS)
    .setField(FIELD_BLOOD_PRESSURE_SYSTOLIC, 120.0f)
    .setField(FIELD_BLOOD_PRESSURE_DIASTOLIC, 80.0f)
    .setField(FIELD_BODY_POSITION, BODY_POSITION_SITTING)
    .setField(
        FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION,
        BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM)
    .build()

REST

建立資料來源

如要寫入血壓資料點,請建立新的資料來源

HTTP 方法

POST

要求網址

https://www.googleapis.com/fitness/v1/users/me/dataSources

要求主體

{
  "dataStreamName": "BloodPressure",
  "type": "raw",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "My Example App",
    "version": "1"
  },
  "dataType": {
    "name": "com.google.blood_pressure"
   }
}

回應

如果成功建立資料來源,您會收到 200 OK HTTP 回應狀態碼。回應主體包含資料來源的 JSON 表示法,包括 datasource.dataStreamId 屬性。請使用這個 ID 做為 dataSourceId 新增資料。

新增血壓資料

建立 com.google.blood_pressure 類型的資料點來新增資料。

HTTP 方法

PATCH

要求網址

https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000

要求主體

為清楚起見,以下顯示的 JSON 主體會加註註解,說明健康狀態欄位常數的用法。

  {
    "dataSourceId": "datasource.dataStreamId",
    "maxEndTimeNs": 1574159699023000000,
    "minStartTimeNs": 1574159699023000000,
    "point": [
      {
        "dataTypeName": "com.google.blood_pressure",
        "endTimeNanos": 1574159699023000000,
        "startTimeNanos": 1574159699023000000,
        "value": [
          {
            "fpVal": 120.0  // systolic
          },
          {
            "fpVal": 80.0  // diastolic
          },
          {
            "intVal": 2  // Body position enum value for sitting
          },
          {
            "intVal": 3  // Location enum value for left upper arm
          }
        ]
      }
    ]
  }