overview package class tree deprecated index com.samsung.android.sdk.healthdata interface healthconstants.exercise all superinterfaces: healthconstants.common, healthconstants.sessionmeasurement enclosing class: healthconstants public static interface healthconstants.exercise extends healthconstants.sessionmeasurement this interface defines exercise data of the user. properties properties of the following extending interfaces are available for this data type. healthconstants.common healthconstants.sessionmeasurement exercise data has the following properties. see more common properties by spreading this section out. property name description healthconstants.exercise.uuid [mandatory] data's unique id, assigned by the system when a new data is inserted healthconstants.exercise.create_time [mandatory] utc milliseconds when a data is created in the health data store, assigned by the system when a new data is inserted healthconstants.exercise.update_time [mandatory] utc milliseconds when a data is updated in the health data store, assigned by the system when a new data is inserted or the existing data is updated healthconstants.exercise.package_name [mandatory] package name which provides data, assigned by the system when a new data is inserted healthconstants.exercise.device_uuid [mandatory] device identifier which provides the health data healthconstants.exercise.start_time [mandatory] utc milliseconds when the measurement is started healthconstants.exercise.end_time [mandatory] utc milliseconds after the measurement has ended if the samsung health's exercise data has the same start_time and end_time, it means the user didn't select the "pause" or "stop" button yet on samsung health. healthconstants.exercise.time_offset [mandatory] time offset in milliseconds which considers the time zone and daylight saving time healthconstants.exercise.exercise_type [mandatory] predefined exercise type healthconstants.exercise.exercise_custom_type custom exercise type healthconstants.exercise.calorie [mandatory] burned calorie healthconstants.exercise.duration [mandatory] duration of this exercise healthconstants.exercise.distance distance healthconstants.exercise.altitude_gain increased altitude during the activity healthconstants.exercise.altitude_loss decreased altitude during the activity healthconstants.exercise.count count of a repetitive action healthconstants.exercise.count_type type of the count healthconstants.exercise.max_speed maximum speed healthconstants.exercise.mean_speed mean speed healthconstants.exercise.max_caloricburn_rate maximum rate of burned calories healthconstants.exercise.mean_caloricburn_rate mean rate of burned calories healthconstants.exercise.max_cadence maximum cadence rate healthconstants.exercise.mean_cadence mean cadence rate healthconstants.exercise.max_heart_rate maximum heart rate healthconstants.exercise.mean_heart_rate mean heart rate healthconstants.exercise.min_heart_rate minimum heart rate healthconstants.exercise.max_altitude maximum altitude healthconstants.exercise.min_altitude minimum altitude healthconstants.exercise.incline_distance uphill distance healthconstants.exercise.decline_distance downhill distance healthconstants.exercise.max_power maximum power healthconstants.exercise.mean_power mean power healthconstants.exercise.mean_rpm mean rpm (revolutions per minute) healthconstants.exercise.max_rpm max rpm (revolutions per minute) healthconstants.exercise.live_data live data (e.g. heart rate, speed, power, and so on) during exercise healthconstants.exercise.location_data location (trajectory) data during exercise healthconstants.exercise.vo2_max maximal oxygen consumption during exercise. healthconstants.exercise.comment comment healthconstants.exercise.additional additional info to express exercise's details healthconstants.exercise.custom custom info which is formatted with json and compressed data data permission the user's consent is required to read or write this data type. healthpermissionmanager.requestpermissions() displays a data permission ui to the user. see permission manager and request data permission. since: 1.0.0 field summary fields modifier and type field and description static string additional additional info to express exercise's details. static string altitude_gain increased altitude during the activity in meters. static string altitude_loss decreased altitude during the activity in meters. static string calorie burned calorie during the activity in kilocalories. static string comment comment for data. static string count count of a repetitive action, such as the revolution count of the bicycle pedal or striding count of a runner or walker. static string count_type type of the count. static int count_type_repetition general repetition type. static int count_type_stride stride or step cadence type. static int count_type_stroke stroke cadence type. static int count_type_swing swing cadence type. static string decline_distance downhill distance during the activity in meters. static string distance distance covered during the exercise in meters. static string duration duration of this exercise in milliseconds. static string exercise_custom_type custom exercise type. static string exercise_type predefined exercise type. static string health_data_type data type name for exercise. static string incline_distance uphill distance during the activity in meters. static string live_data live data (e.g. heart rate, speed, power, and so on) during exercise which is formatted with json and compressed data. static string location_data location (trajectory) data during exercise which is formatted with json and compressed data. static string max_altitude maximum altitude in meters. static string max_cadence maximum cadence rate per minute. static string max_caloricburn_rate maximum rate of burned calories in kilocalories per hour. static string max_heart_rate maximum heart rate per minute. static string max_power maximum power in watts. static string max_rpm max rpm (revolutions per minute). static string max_speed maximum speed in meters per second. static string mean_cadence mean cadence rate per minute. static string mean_caloricburn_rate mean rate of burned calories in kilocalories per hour. static string mean_heart_rate mean heart rate per minute. static string mean_power mean power in watts. static string mean_rpm mean rpm (revolutions per minute). static string mean_speed mean speed in meters per second. static string min_altitude minimum altitude in meters. static string min_heart_rate minimum heart rate per minute. static string vo2_max maximal oxygen consumption during exercise. fields inherited from interface com.samsung.android.sdk.healthdata.healthconstants.sessionmeasurement end_time, start_time, time_offset fields inherited from interface com.samsung.android.sdk.healthdata.healthconstants.common create_time, custom, device_uuid, package_name, update_time, uuid field detail exercise_type static final string exercise_type predefined exercise type. your application's exercise data is shown on samsung health if the data sets this value. if you cannot find a proper exercise type in predefined types, set the value as 0 and set exercise_custom_type instead of it. mandatory type: int available values: predefined types since: 1.0.0 see also: constant field values exercise_custom_type static final string exercise_custom_type custom exercise type. define its value as fqdn, e.g. "com.yourcompany.exercise.type.exercise_name". this property has to be used only when you cannot find a required exercise type in predefined types. if this custom type is used, set the value of exercise_type as 0. your custom health data is inserted to the health data store but it is not shown in samsung health. optional type: string value length: 1 ~ 255 since: 1.0.0 see also: constant field values distance static final string distance distance covered during the exercise in meters. optional type: float value range: 0 ~ 2000000 since: 1.0.0 see also: constant field values calorie static final string calorie burned calorie during the activity in kilocalories. mandatory type: float value range: 0 ~ 1000000 since: 1.0.0 see also: constant field values duration static final string duration duration of this exercise in milliseconds. mandatory type: long value range: 0 ~ 86400000 since: 1.0.0 see also: constant field values altitude_gain static final string altitude_gain increased altitude during the activity in meters. optional type: float value range: 0 ~ 10000 since: 1.0.0 see also: constant field values altitude_loss static final string altitude_loss decreased altitude during the activity in meters. optional type: float value range: 0 ~ 10000 since: 1.0.0 see also: constant field values count static final string count count of a repetitive action, such as the revolution count of the bicycle pedal or striding count of a runner or walker. optional type: int value range: 0 ~ 1000000 since: 1.0.0 see also: count_type, constant field values count_type static final string count_type type of the count. optional type: int available values: one of the following values count_type_stride count_type_stroke count_type_swing count_type_repetition since: 1.0.0 see also: constant field values count_type_stride static final int count_type_stride stride or step cadence type. its constant value is 30001. since: 1.0.0 see also: count_type, constant field values count_type_stroke static final int count_type_stroke stroke cadence type. its constant value is 30002. since: 1.0.0 see also: count_type, constant field values count_type_swing static final int count_type_swing swing cadence type. its constant value is 30003. since: 1.0.0 see also: count_type, constant field values count_type_repetition static final int count_type_repetition general repetition type. its constant value is 30004. since: 1.3.0 see also: count_type, constant field values max_speed static final string max_speed maximum speed in meters per second. optional type: float value range: 0 ~ 140 since: 1.0.0 see also: constant field values mean_speed static final string mean_speed mean speed in meters per second. optional type: float value range: 0 ~ 140 since: 1.0.0 see also: constant field values max_caloricburn_rate static final string max_caloricburn_rate maximum rate of burned calories in kilocalories per hour. optional type: float value range: 0 ~ 1000000 since: 1.0.0 see also: constant field values mean_caloricburn_rate static final string mean_caloricburn_rate mean rate of burned calories in kilocalories per hour. optional type: float value range: 0 ~ 1000000 since: 1.0.0 see also: constant field values max_cadence static final string max_cadence maximum cadence rate per minute. e.g. the cadence indicates steps per minute for running exercise. optional type: float value range: 0 ~ 500000 since: 1.0.0 see also: constant field values mean_cadence static final string mean_cadence mean cadence rate per minute. e.g. the cadence indicates steps per minute for running exercise. optional type: float value range: 0 ~ 500000 since: 1.0.0 see also: constant field values max_heart_rate static final string max_heart_rate maximum heart rate per minute. optional type: float value range: 0 ~ 300 since: 1.0.0 see also: constant field values mean_heart_rate static final string mean_heart_rate mean heart rate per minute. optional type: float value range: 0 ~ 300 since: 1.0.0 see also: constant field values min_heart_rate static final string min_heart_rate minimum heart rate per minute. optional type: float value range: 0 ~ 300 since: 1.2.0 see also: constant field values max_altitude static final string max_altitude maximum altitude in meters. optional type: float value range: -1000 ~ 10000 since: 1.0.0 see also: constant field values min_altitude static final string min_altitude minimum altitude in meters. optional type: float value range: -1000 ~ 10000 since: 1.0.0 see also: constant field values incline_distance static final string incline_distance uphill distance during the activity in meters. optional type: float value range: 0 ~ 1000000 since: 1.0.0 see also: constant field values decline_distance static final string decline_distance downhill distance during the activity in meters. optional type: float value range: 0 ~ 1000000 since: 1.0.0 see also: constant field values max_power static final string max_power maximum power in watts. optional type: float value range: 0 ~ 999 since: 1.0.0 see also: constant field values mean_power static final string mean_power mean power in watts. optional type: float value range: 0 ~ 999 since: 1.0.0 see also: constant field values mean_rpm static final string mean_rpm mean rpm (revolutions per minute). optional type: float value range: 0 ~ 100000 since: 1.2.1 see also: constant field values max_rpm static final string max_rpm max rpm (revolutions per minute). optional type: float value range: 0 ~ 100000 since: 1.3.0 see also: constant field values live_data static final string live_data live data (e.g. heart rate, speed, power, and so on) during exercise which is formatted with json and compressed data. optional type: byte[] maximum data size: 1000 kb live data can have one or more segments. e.g. samsung health starts the exercise data record when the user starts a specified exercise. it makes several segments to live data for each specific period. when the user tabs the 'stop' button finally it finishes the exercise data record. each segment is composed of the following json keys. json key type unit mandatory "start_time" long utc millisecond recommended.set this value if you save live_data. "heart_rate" float beat per minute recommended.set one or more values if you save live_data. "cadence" float rate per minute "count" int - "power" float watt "speed" float meter per second "distance" float meter the following example shows the json format for live_data. { "start_time":1422457096536, "heart_rate":147.48181, "cadence":95.84712, "count":83, "power":99.50436, "speed":11.061617, "distance":250 } especially, each segment's "count" and "distance" in live data are accumulated values to the each segment's "start_time"unlike other values such as "heart_rate" and "cadence" that indicate the measured value at the point of each segment's "start_time". compressed json conversion can be: converting data to compressed json getting data from compressed json since: 1.0.0 see also: healthdatautil, constant field values location_data static final string location_data location (trajectory) data during exercise which is formatted with json and compressed data. it follows wgs 84. optional type: byte[] maximum data size: 1000 kb location data can have one or more segment. each segment is composed of the following json keys. json key type mandatory "start_time" long recommended,set this value if you save location_data. "latitude" float recommended,set this value if you save location_data. "longitude" float recommended,set this value if you save location_data. "altitude" float no "accuracy" float no the following example shows the json format for location_data { "start_time":1422457096536, "latitude":2.7413864, "longitude":60.37224, "altitude":39.0, "accuracy":0.0 } compressed json conversion can be: converting data to compressed json getting data from compressed json since: 1.0.0 see also: healthdatautil, constant field values vo2_max static final string vo2_max maximal oxygen consumption during exercise. optional type: float value range: 0 ~ 100 since: 1.5.0 see also: constant field values comment static final string comment comment for data. optional type: string value length: 0 ~ 255 since: 1.0.0 see also: constant field values additional static final string additional additional info to express exercise's details. it is formatted with json and compressed data. it's different for each exercise kind. compressed json conversion can be: converting data to compressed json getting data from compressed json swimming's additional info swimming's detailed information is defined with the following json keys. json key type unit mandatory remarks "pool_length" int - yes 20 | 50 | ... "pool_length_unit" string - yes one of the following value: "meter" "yard" "total_distance" float meter yes "total_duration" int millisecond yes "lengths" array - no array of length a length is the distance from one end of a swimming pool to the other. each length's detailed information is defined with the following json keys. json key type unit mandatory description "duration" int millisecond yes duration value of this length "stroke_count" int - yes stroke count value of this length "stroke_type" string - yes stroke type value of this length one of the following value: "freestyle" "butterfly" "backstroke" "breaststroke" "mixed" "interval" int - yes interval value.it starts from 1 and increments by 1. see swimming data's example additional info. { "pool_length":25, "pool_length_unit":"meter", "total_distance":125, "total_duration":247000, "lengths":[ { "duration":49000, "interval":1, "stroke_count":20, "stroke_type":"butterfly" }, { "duration":42000, "interval":1, "stroke_count":21, "stroke_type":"backstroke" }, { "duration":51000, "interval":1, "stroke_count":26, "stroke_type":"breaststroke" }, { "duration":52000, "interval":2, "stroke_count":27, "stroke_type":"freestyle" }, { "duration":53000, "interval":2, "stroke_count":29, "stroke_type":"mixed" } ] } since: 1.3.0 see also: constant field values health_data_type static final string health_data_type data type name for exercise. use "com.samsung.health.exercise" to add permission to the manifest file. since: 1.0.0 see also: constant field values