Health Platform API'si

Health Platform API, geliştiricilere tek bir geçmiş sağlık, sıhhat ve zindelik bilgilerini okuma, yazma ve paylaşma ve fitness verileri. Health Platform ile verilerinin kontrolü kullanıcılardadır. Kullanıcı Sayısı hangi uygulamaların farklı veri türlerine okuma veya yazma erişimine sahip olacağını kontrol edin. Sağlık Platform API veri türleri arasında yükseklik, nabız ve daha fazlası yer alır.

Health Platform API, kullanıcılara hangi uygulamaların kişisel sağlık, fitness ve fitness verilerine erişip verileri bulunuyor. Böylece uygulama geliştiriciler, kullanıcılara daha eksiksiz kullanıcılara ait görünüm ve kullanıcıların verilerini daha etkili bir şekilde izlemesine olanak tanır.

Health Platform API yazılım geliştirici kiti, Android uygulama geliştiricilere Kullanıcıların sağlık ve sağlıklı yaşam verilerine erişebilmesi için belirli Samsung cihazlarda çalışır ve uygulamaların toplu işlemler yapmasına olanak tanır. RACI matrisine geldi.

Başlayın

Health Platform'u kullanırken aşağıdakileri göz önünde bulundurun:

  • İstemci uygulamaları, kullanıcıdan okuma veya yazma erişimi için ayrıntılı izinler almalıdır.
  • Kullanıcı, daha sonra istediği zaman izinleri reddedebilir veya izinleri iptal edebilir.
  • Health Platform API yalnızca belirli Samsung cihazları destekler.
  • HealthDataClient, Health Platform'un istemcisi ve Health Platform'a bir giriş noktasıdır.

Aşağıdaki resimde, geliştiricilerin uygulaması gereken entegrasyon adımları gösterilmektedir:

entegrasyon-adımları

Sürüm dosyaları

Health Platform V1 sürümü şunları içerir:

  • İstemci SDK'sı: Health Platform API. SDK, doğrudan uygulayabileceğiniz bir Maven deposudur. Gradle derleme dosyalarınız.

Health Platform'u yükleyin

Aşağıdaki adımları uygulayarak Health Platform'u yükleyin:

Uygulamanın root build.gradle dosyasına aşağıdaki şekilde gösterildiği gibi depoyu ekleyin örnek:

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

Modülünüzün build.gradle bölümünde Health Platform SDK'sına bağımlılık ekleyin dosyasını seçin:

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

Veri

Health Platform, sağlık ve fitness verilerini depolayıp yapılandırır. Ayrıca riskleri arasındaki temel farklar nelerdir? Örneğin, nabız ölçümü hemen alınır, ancak adım sayısı tamamlanması gereken aktiviteleri ifade eder.

Aşağıda Health Platform'daki merkezi nesneler ve farkları açıklanmıştır:

  • RawData: Ölçüm ve veri kaydı.
  • DataType: Sağlık ve fitness verisi gibi yaygın veri türleri için bir tanımlayıcı ya da vücut sıcaklığı gibi veriler ve bunların formatları (ör. salt okunur veya isteğe bağlı olabilir.
  • SampleData: anlık ölçüm olan bir RawData nesnesi. Örneğin, nabız, tansiyon veya koşu hızı gibi.
  • IntervalData: kümülatif bir ölçüm olan RawData nesnesi belirli bir süre boyunca (ör. atılan adım sayısı, katedilen mesafe veya yakılan kalori.
  • SeriesData: Bir adım sırasını kapsayan RawData nesnesi yaptığınız ölçümlerdir. SeriesData özellikle şunlar için uygun: sırasında sürekli nabız örnekleri gibi yüksek frekanslı sensör verileri devam edebilir.

Üç RawData sınıfından her biri şu özel alt sınıfa karşılık gelir: DataType: SampleData, IntervalData ve SeriesData şunlara karşılık gelir: Sırasıyla SampleDataType, IntervalDataType ve SeriesDataType.

Sağlık Hizmeti tarafından her RawData nesnesine benzersiz bir tanımlayıcı (UID) atanır Eklendiğinde platform. Belirli bir RawData öğesine referans vermek için bu UID'yi kullanabilirsiniz okuma, güncelleme veya silme isteklerindeki nesneyi bulmanız gerekir.

Veri türleri

Health Platform'da, yaygın olarak kullanılan birçok veri türü bulunur. sağlık ve fitness uygulamaları. Kullanılabilir veri türleriyle depolanan veriler, kullanıcılara geçmiş sağlık, fitness ve sağlıklı yaşam durumlarıyla ilgili kapsamlı bir görünüm günlük aktiviteleriyle ilgili analizler sunar.

Her veri türü, aşağıdakileri içeren veri biçimine göre tanımlanır:

  • Alanlar: Veri türüyle ilişkili belirli veya genel alanlar. Örneğin, kandaki oksijen doygunluğu (SpO2) veri türünde Başlık, Notlar ve Yüzde.
  • Type: long, double, string veya enum.
  • Özellik: Salt okunur, zorunlu, isteğe bağlı veya doğrulama aralığı.

Veri türleri listesi

Mevcut veri türlerini anlayarak Health Platform'dan en iyi şekilde yararlanın. Health Platform, aşağıdaki tabloda gösterilen veri türlerini destekler. Veri türleri biçimlerine göre düzenlenir: örnek, aralık veya seri.

SampleData tür:

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

IntervalData tür:

DataType.ActiveEnergyDataType ACTIVE_ENERGY_BURNED Zorunlu
DataType.ActiveTimeDataType ACTIVE_TIME Sadece Okunur
DataType.ActivityEventDataType ACTIVITY_EVENT Zorunlu
DataType.ActivityLapDataType ACTIVITY_LAP İsteğe bağlı
DataType.ActivitySessionDataType ACTIVITY_SESSION Zorunlu
DataType.BasalEnergyDataType BASAL_ENERGY_BURNED Sadece Okunur
DataType.DistanceDataType DISTANCE Zorunlu
DataType.ElevationGainedDataType ELEVATION_GAINED Zorunlu
DataType.FloorsClimbedDataType FLOORS_CLIMBED Zorunlu
DataType.HydrationDataType HYDRATION Zorunlu
DataType.NutritionDataType NUTRITION İsteğe bağlı
DataType.RepetitionsDataType REPETITIONS Zorunlu
DataType.SleepSessionDataType SLEEP_SESSION İsteğe bağlı
DataType.SleepStageDataType SLEEP_STAGE Zorunlu
DataType.StepsDataType STEPS Zorunlu
DataType.SwimmingStrokesDataType SWIMMING_STROKES Zorunlu ve İsteğe Bağlı
DataType.TotalEnergyDataType TOTAL_ENERGY_BURNED Sadece Okunur

SeriesData tür:

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

Geliştirici işlevleri

Aşağıda, Google Analytics 4'te bulunan standart veri işlevleri kümesi Sağlık Platformu. Platform, standart ekleme, güncelleme ve silme işlevleri sunar ham veriler için farklı fonksiyonlar kullanır.

AggregatedData Okuma

Platform, müşterilerin aşağıdaki türlerde bir toplama işlevi uygulamasına olanak tanır: AggregatedData:

  • StatisticalData: bir minimum ve maksimum kalp gibi SampleData veya SeriesData grupları oranını ölçmenizi sağlar.
  • CumulativeData: IntervalData değerlerinin toplamı; örneğin günlük aralıktaki toplam adım sayısı
  • CountData: Temel RawData sayısının basit bir sayısı sayısı gibi nesnelerin sayısını ölçer. Sayım verileri örnek, aralık ve seri veri türleri için hesaplanabilir.

Health Platform API'ye bağlanma

HealthDataClient, Health Platform API'ye giriş noktasıdır.

Aşağıdaki adımlarda Health Platform'a bağlanma süreci açıklanmaktadır:

  1. Yeni HealthDataClient örnekleri oluşturmak için HealthDataService.getClient politikasını kullanın.
  2. Ardından, istemci uygulaması requestPermissions (Set) yöntemini çağırın.
ziyaret edin.

HealthDataClient, temel alanla bağlantısını otomatik olarak yönetir depolama katmanını sağlar ve tüm Süreçler Arası İletişim (IPC) ile giden isteklerin serileştirilmesini ve tıklayın.

. ziyaret edin.