סוגי נתונים בהתאמה אישית

אם האפליקציה שלכם צריכה לתעד מידע שלא נכלל באחד מסוגי הנתונים הקיימים בפלטפורמת Google Fit, תוכלו ליצור סוג נתונים בהתאמה אישית.

יצירת סוגי נתונים מותאמים אישית

יצירה או ציון של סוג נתונים מותאם אישית לצורך תיעוד נתונים מותאמים אישית. כשיוצרים סוגי נתונים מותאמים אישית, חשוב לוודא:

  • השם של סוג הנתונים מייצג במדויק את נתוני הבסיס.

  • הקידומת של שם סוג הנתונים תואמת לשם החבילה של האפליקציה.

Android

כדי ליצור סוג נתונים בהתאמה אישית בפעם הראשונה, משתמשים בשיטה ConfigClient.createCustomDataType:

val request = DataTypeCreateRequest.Builder()
    // The prefix of your data type name must match your app's package name
    .setName("com.packagename.appname.custom_data_type") // Add some custom fields, both int and float
    .addField("field1", Field.FORMAT_INT32)
    .addField("field2", Field.FORMAT_FLOAT)
    // Add some common fields
    .addField(Field.FIELD_ACTIVITY)
    .build()

Fitness.getConfigClient(this, account)
    .createCustomDataType(request)
    .addOnSuccessListener { dataType ->
        // Use this custom data type to insert data into your app.
        Log.d(TAG, "Created data type: ${dataType.name}")
    }

REST

סוגי נתונים הם נכס של מקורות נתונים ב-API ל-REST. כדי לתעד נתונים מותאמים אישית, צריך ליצור מקור נתונים ולאחר מכן לציין את סוג הנתונים:

  1. צריך לקרוא ל-API ל-REST כדי ליצור מקור נתונים חדש. לדוגמה: FlexibilityMeasure.

  2. מומלץ לתת לסוג הנתונים שם ייחודי שמייצג בצורה טובה את הנתונים שהוא מתעד.

  3. מציינים את השדות של סוג הנתונים ואת הפורמטים שלהם.

שיטת HTTP

POST

כתובת ה-URL של הבקשה

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

גוף הבקשה

{
  "dataStreamName": "FlexibilityMeasure",
  "type": "raw",
  "application": {
    "detailsUrl": "http://recoveryapps.com",
    "name": "Stretch Flex",
    "version": "1"
  },
  "dataType": {
    "name": "com.recoveryapps.stretchflex.flexibility",
    "field": [
     {
      "name": "ankle_range_degrees",
      "format": "integer"
     },
     {
      "name": "wrist_range_degrees",
      "format": "integer",
      "optional": true
     }
    ]
   }
}

תשובה

אם מקור הנתונים נוצר בהצלחה, תקבלו את קוד הסטטוס של תשובת HTTP מסוג 200 OK. גוף התגובה מכיל ייצוג JSON של מקור הנתונים, כולל נכס datasource.dataStreamId. משתמשים במזהה הזה בתור dataSourceId על מנת להוסיף נתונים.

שימוש בסוגי נתונים מותאמים אישית

Android

ממירים את השם של סוג הנתונים המותאם אישית ממחרוזת (com.packagename.appname.custom_data_type) לאובייקט DataType באמצעות השיטה ConfigClient.readDataType. משתמשים באובייקט שהוחזר כדי להוסיף ולקרוא נתונים מותאמים אישית.

Fitness.getConfigClient(this, account)
    .readDataType("com.packagename.appname.custom_data_type")
    .addOnSuccessListener { dataType ->
        // Use this custom data type to insert data into your app.
        Log.d(TAG, "Retrieved data type: ${dataType.name}")
    }

REST

כדי להוסיף או לקרוא נתונים מותאמים אישית באמצעות סוגי הנתונים המותאמים אישית, אתם צריכים את מקורות הנתונים שלהם. כדי לבדוק את מקורות הנתונים של סוג נתונים בהתאמה אישית, שולחים בקשת GET ל-API ל-REST.

הוספת נתונים מותאמים אישית

כדי להוסיף נתונים מותאמים אישית, צריך ליצור מערך נתונים עם נקודות נתונים חדשות. מציינים את מקור הנתונים שיצרתם עבור סוג הנתונים המותאם אישית. נקודות הנתונים צריכות לכלול את כל השדות והפורמטים הנכונים בסוג הנתונים המותאם אישית.

קריאת נתונים מותאמים אישית

כדי לקרוא נתונים מותאמים אישית, צריך לציין את מקור הנתונים שיצרתם לסוג הנתונים המותאם אישית כשמאחזרים נקודות נתונים מפלטפורמת Google Fit.