Health Platform API

Health Platform API adalah API Android yang memberi developer satu antarmuka untuk membaca, menulis, dan membagikan data historis kesehatan dan kebugaran pengguna. Dengan Health Platform, pengguna dapat mengontrol data mereka. Pengguna mengontrol aplikasi mana yang memiliki akses baca atau tulis ke berbagai jenis data. Jenis data Health Platform API mencakup tinggi, detak jantung, dan banyak lagi.

Health Platform API memberi pengguna mekanisme penyimpanan dan berbagi yang memungkinkan mereka memilih aplikasi yang dapat mengakses dan menampilkan data kesehatan dan kebugaran pribadi mereka. Hal ini kemudian memungkinkan developer aplikasi menampilkan gambaran kesehatan pengguna yang lebih lengkap dan memungkinkan pengguna memantau data mereka secara lebih efektif.

Software developer kit Health Platform API memberi developer aplikasi Android semua yang mereka perlukan untuk memberikan akses bagi pengguna ke data kesehatan dan kebugaran di perangkat Samsung tertentu, dan memungkinkan aplikasi untuk melakukan operasi massal, seperti memasukkan, menghapus, dan membaca data.

Memulai

Saat menggunakan Health Platform, perhatikan hal-hal berikut:

  • Aplikasi klien harus mendapatkan izin terperinci untuk akses baca atau tulis dari pengguna.
  • Pengguna dapat menolak izin atau mencabut izin kapan saja setelahnya.
  • Health Platform API hanya mendukung perangkat Samsung tertentu.
  • HealthDataClient adalah klien untuk Health Platform dan titik entri ke Health Platform.

Gambar berikut menunjukkan langkah-langkah integrasi yang diperlukan dan harus diikuti developer:

langkah-integrasi

Merilis file

Rilis Health Platform V1 berisi hal berikut:

  • Client SDK: Sertakan SDK ini dalam aplikasi Anda untuk menggunakan Health Platform API. SDK adalah repo Maven yang dapat Anda sertakan secara langsung dalam file build Gradle aplikasi.

Menginstal Platform Kesehatan

Instal Health Platform menggunakan langkah-langkah berikut:

Pada file build.gradle root aplikasi, tambahkan repo, seperti yang ditunjukkan pada contoh berikut:

allprojects {
    ...
    repositories {
        ...
        google()
    }
}

Tambahkan dependensi pada Health Platform SDK dalam file build.gradle modul Anda, seperti yang ditunjukkan dalam contoh berikut:

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

Data

Health Platform menyimpan dan menyusun data kesehatan dan kebugaran. Fitur ini juga mempertimbangkan perbedaan inti pada cara pengukuran data dari jenis yang berbeda. Misalnya, pengukuran detak jantung akan segera dilakukan, tetapi jumlah langkah akan diambil selama jangka waktu tertentu.

Berikut adalah objek utama di Health Platform dan perbedaannya:

  • RawData: pengukuran dan catatan data.
  • DataType: penentu untuk jenis data kesehatan dan kebugaran umum, seperti detak jantung, lemak tubuh, atau suhu tubuh, beserta formatnya, seperti kolom, hanya baca, opsional.
  • SampleData: objek RawData yang merupakan pengukuran seketika, seperti detak jantung, tekanan darah, atau kecepatan lari.
  • IntervalData: objek RawData yang merupakan pengukuran kumulatif yang diambil selama jangka waktu tertentu, seperti jumlah langkah yang dilakukan, jarak yang ditempuh, atau kalori yang terbakar.
  • SeriesData: objek RawData yang mengenkapsulasi urutan pengukuran selama jangka waktu tertentu. SeriesData sangat cocok untuk data sensor frekuensi tinggi, seperti sampel detak jantung berkelanjutan selama sesi aktivitas.

Masing-masing dari tiga class RawData sesuai dengan subclass tertentu dari DataType: SampleData, IntervalData, dan SeriesData sesuai dengan SampleDataType, IntervalDataType, dan SeriesDataType.

Setiap objek RawData diberi ID unik (UID) oleh Health Platform saat disisipkan. Anda dapat menggunakan UID ini untuk mereferensikan objek RawData tertentu dalam permintaan baca, update, atau hapus.

Jenis data

Health Platform mencakup berbagai jenis data yang umum digunakan di seluruh aplikasi kesehatan dan kebugaran. Data yang disimpan dengan jenis data yang tersedia memberi pengguna gambaran menyeluruh tentang data historis kesehatan, kebugaran, dan kesejahteraan mereka, yang memberikan analisis tentang aktivitas harian mereka.

Setiap jenis data ditentukan oleh format datanya yang mencakup hal-hal berikut:

  • Kolom: kolom spesifik atau umum yang dikaitkan dengan jenis data. Misalnya, jenis data saturasi oksigen darah (SpO2) memiliki kolom seperti Judul, Catatan, dan Persentase.
  • Jenis: panjang, ganda, string, atau enum.
  • Atribut: rentang validasi, opsional, wajib, atau baca-saja.

Daftar jenis data

Dapatkan hasil maksimal dari Health Platform dengan memahami jenis data yang tersedia. Health Platform mendukung jenis data yang ditampilkan dalam tabel berikut. Jenis data diatur menurut formatnya: sampel, interval, atau seri.

Jenis SampleData:

DataType.BasalMetabolicRateDataType BASAL_METABOLIC_RATE Wajib
DataType.BloodGlucoseDataType BLOOD_GLUCOSE Wajib dan Opsional
DataType.BloodPressureDataType BLOOD_PRESSURE Wajib dan Opsional
DataType.BodyFatDataType BODY_FAT Wajib
DataType.BodyTemperatureDataType BODY_TEMPERATURE Wajib dan Opsional
DataType.BoneMassDataType BONE_MASS Wajib
DataType.CervicalMucusDataType CERVICAL_MUCUS Opsional
DataType.CervicalPositionDataType CERVICAL_POSITION Opsional
DataType.CyclingPedalingCadenceDataType CYCLING_PEDALING_CADENCE Wajib
DataType.DateOfBirthDataType DATE_OF_BIRTH Hanya baca
DataType.GenderDataType GENDER Hanya baca
DataType.HeartRateDataType HEART_RATE Wajib
DataType.HeightDataType HEIGHT Wajib
DataType.HipCircumferenceDataType HIP_CIRCUMFERENCE Wajib
DataType.HrvDifferentialIndexDataType HRV_DIFFERENTIAL_INDEX Wajib
DataType.HrvRmssdDataType HRV_RMSSD Wajib
DataType.HrvSDataType HRV_S Wajib
DataType.HrvSd2DataType HRV_SD2 Wajib
DataType.HrvSdannDataType HRV_SDANN Wajib
DataType.HrvSdnnDataType HRV_SDNN Wajib
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX Wajib
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX Wajib
DataType.HrvSdsdDataType HRV_SDSD Wajib
DataType.HrvTinnDataType HRV_TINN Wajib
DataType.LeanBodyMassDataType LEAN_BODY_MASS Wajib
DataType.LocationDataType LOCATION Wajib
DataType.MenstruationDataType MENSTRUATION Opsional
DataType.OvulationTestDataType OVULATION_TEST Wajib
DataType.OxygenSaturationDataType OXYGEN_SATURATION Wajib
DataType.PaceDataType PACE Wajib
DataType.PowerDataType POWER Wajib
DataType.RespiratoryRateDataType RESPIRATORY_RATE Wajib
DataType.RestingHeartRateDataType RESTING_HEART_RATE Wajib
DataType.SexualActivityDataType SEXUAL_ACTIVITY Wajib
DataType.SpeedDataType SPEED Wajib
DataType.StepsCadenceDataType STEPS_CADENCE Wajib
DataType.Vo2MaxDataType VO2_MAX Wajib dan Opsional
DataType.WaistCircumferenceDataType WAIST_CIRCUMFERENCE Wajib
DataType.WeightDataType WEIGHT Wajib

Jenis IntervalData:

DataType.ActiveEnergyDataType ACTIVE_ENERGY_BURNED Wajib
DataType.ActiveTimeDataType ACTIVE_TIME Hanya baca
DataType.ActivityEventDataType ACTIVITY_EVENT Wajib
DataType.ActivityLapDataType ACTIVITY_LAP Opsional
DataType.ActivitySessionDataType ACTIVITY_SESSION Wajib
DataType.BasalEnergyDataType BASAL_ENERGY_BURNED Hanya baca
DataType.DistanceDataType DISTANCE Wajib
DataType.ElevationGainedDataType ELEVATION_GAINED Wajib
DataType.FloorsClimbedDataType FLOORS_CLIMBED Wajib
DataType.HydrationDataType HYDRATION Wajib
DataType.NutritionDataType NUTRITION Opsional
DataType.RepetitionsDataType REPETITIONS Wajib
DataType.SleepSessionDataType SLEEP_SESSION Opsional
DataType.SleepStageDataType SLEEP_STAGE Wajib
DataType.StepsDataType STEPS Wajib
DataType.SwimmingStrokesDataType SWIMMING_STROKES Wajib dan Opsional
DataType.TotalEnergyDataType TOTAL_ENERGY_BURNED Hanya baca

Jenis SeriesData:

DataType.CyclingPedalingCadenceSeriesDataType CYCLING_PEDALING_CADENCE Wajib
DataType.HeartRateSeriesDataType HEART_RATE Wajib
DataType.LocationSeriesDataType LOCATION Wajib
DataType.PaceSeriesDataType PACE Wajib
DataType.PowerSeriesDataType POWER Wajib
DataType.SpeedSeriesDataType SPEED Wajib
DataType.StepsCadenceSeriesDataType STEPS_CADENCE Wajib

Fungsi developer

Berikut adalah penjelasan tentang kumpulan fungsi data standar yang tersedia dalam Health Platform. Platform tersebut menyediakan fungsi penyisipan, pembaruan, dan penghapusan standar untuk data mentah.

Membaca AggregatedData

Platform ini memungkinkan klien menerapkan fungsi agregasi pada jenis AggregatedData berikut:

  • StatisticalData: nilai rata-rata, minimum, atau maksimum dalam kumpulan SampleData atau SeriesData, seperti detak jantung minimum dan maksimum selama sesi aktivitas.
  • CumulativeData: jumlah nilai IntervalData, seperti total jumlah langkah dalam interval harian.
  • CountData: jumlah sederhana objek RawData dasar, seperti jumlah sesi aktivitas dalam minggu tertentu. Data jumlah dapat dihitung untuk jenis data sampel, interval, dan seri.

Menghubungkan ke Health Platform API

HealthDataClient adalah titik entri ke Health Platform API.

Langkah-langkah berikut menjelaskan cara menghubungkan ke Health Platform:

  1. Gunakan HealthDataService.getClient untuk membuat instance HealthDataClient baru.
  2. Selanjutnya, aplikasi klien harus meminta izin dari pengguna menggunakan metode requestPermissions (Set).

HealthDataClient akan secara otomatis mengelola koneksinya ke lapisan penyimpanan dasar dan menangani semua Komunikasi Antar-Proses (IPC) dan serialisasi permintaan keluar dan respons masuk.