Health Connect veri türlerini planlama ve inceleme

Health Connect, sağlık ve fitness verilerini saklar ve yapılandırır. Ayrıca, farklı veri türlerinin nasıl ölçüldüğünü de hesaba katar. Bu veri türleri arasında anında alınan nabız ölçümleri, zaman içinde alınan adım sayısı ve oturumlar halinde alınan uyku verileri yer alır.

Uygulamanızın gereksinimlerini planlayabilmek için öncelikle Health Connect'in hangi veri türlerini ve izinleri sunduğunu anlamanız önemlidir. Bu nedenle, şartlarınızı tamamlamadan önce veri türlerinizi incelemeniz gerekir.

Veri türü kategorileri

Health Connect, mümkün olduğunca fazla çeşitlilik sunmak için çoğu sağlık ve fitness uygulamasında kullanılan veri türlerini destekler. Health Connect, sağlık ve fitness verileri için kapsamlı bir görünüm ve depolama alanı sunmayı amaçlar. Bu veri türleri aşağıdaki kategorilere ayrılır:

  • Etkinlik: Kullanıcının yaptığı tüm etkinlikleri yakalar. Koşu ve yüzme gibi sağlık ve fitness aktivitelerini içerebilir.
  • Vücut Ölçümü: Kullanıcının ağırlığı ve bazal metabolizma hızı gibi vücutla ilgili yaygın verileri yakalar.
  • Âdet Döngüsü Takibi: Bu özellik, âdet döngülerini ve ilgili veri noktalarını (ör. ovülasyon testinin ikili sonucu) kaydeder.
  • Beslenme: Sıvı alımı ve beslenme veri türlerini yakalar. Birincisi, kullanıcının tek bir içecekte ne kadar su tükettiğini gösterir. İkincisi, kalori, şeker ve magnezyum gibi isteğe bağlı alanları içerir.
  • Uyku: Kullanıcının uyku süresi ve türüyle ilgili aralık verilerini yakalar.
  • Temel bilgiler: Kullanıcının genel sağlığıyla ilgili temel bilgileri yakalar. Vücut ısısı, kan şekeri, tansiyon ve kandaki oksijen doygunluğu gibi veriler içerir.

Veri türü biçimi

Health Connect'teki veri türleri, Record alt sınıfları olan nesnelerde depolanır.

Her veri türü için time ve zoneOffset gibi genel veya title, count ve percentage gibi özel ilişkili alanlar vardır. Bazı alanlar uzun, çift veya dize gibi basit türleri kullanırken diğerleri numaralandırmalar ve Instant ve ZoneOffset gibi sınıflar gibi karmaşık türleri kullanır. Bu alanların özellikleri zorunlu veya isteğe bağlı olabilir. Bazı özellikler salt okunur, bazı özellikler ise belirli bir değer aralığıyla sınırlıdır.

Kullanılabilir veri türlerinin ve alanlarının tam listesi için Jetpack'teki sınıflara bakın.

Ek veri özellikleri

Health Connect API'deki veriler, aşağıdaki listede açıklanan meta veri özelliklerini de içerir:

  • Health Connect kimliği: Her veri noktasına, oluşturulurken benzersiz bir tanımlayıcı (UID) atanır. Bu, standart okuma ve yazma işlemleri için kullanışlıdır. Daha fazla bilgi için Health Connect kimliği başlıklı makaleyi inceleyin.
  • Son değiştirilme zamanı: Bir kaydın son güncelleme zaman damgasını gösterir. Kayıt ilk oluşturulduğunda veya her güncellemede otomatik olarak oluşturulur.
  • Veri kaynağı: Health Connect, verilerin geldiği uygulama hakkındaki bilgileri depolar. Bu kaynakların paket adını içerir ve oluşturma sırasında otomatik olarak eklenir.
  • Cihaz: Health Connect, verilerin geldiği cihazla ilgili bilgileri saklar. Bu cihazın üreticisini ve modelini içerir. Değeri manuel olarak siz sağlarsınız.
  • İstemci kimliği: Health Connect, istemci uygulamalarının kendi kimliklerini kullanarak verilere başvurabilmesi için istemci kimlikleri sağlar. Bu, çakışma çözümüne yardımcı olur ve senkronizasyonu kolaylaştırır. Bu, kayda manuel olarak girilir.
  • İstemci kaydı sürümü: Health Connect, istemci kimliğinin yanı sıra veri senkronizasyonu sırasında değişikliklerin izlenmesine yardımcı olmak için sürüm oluşturma özelliği de sunar. Bu, kayda manuel olarak girilir.
  • Kayıt yöntemi: Health Connect, verilerin nasıl kaydedildiğini anlamanıza olanak tanır. Bu yöntemler arasında verileri pasif olarak (otomatik) kaydeden uygulamalar ve verileri aktif olarak veya manuel olarak kaydeden kullanıcılar yer alır.

Health Connect kimliği

Health Connect, yeni eklenen veri nesnelerine, veri nesnelerini tanımlayan ve diğerlerinden ayıran benzersiz tanımlayıcılar (UID) atar. Health Connect kimlikleri, okuma veya yazma isteklerinde faydalıdır. Health Connect kimlikleri, istemci kimlikleriyle aynı değildir. İstemci uygulaması, istemci kimlikleri atarken Health Connect yalnızca Health Connect kimlikleri atar.

Health Connect kimlikleriyle çalışırken aşağıdaki notları göz önünde bulundurun:

  • Oturumların tek bir Health Connect kimliği vardır ancak oturumlardaki verilerin kendi Health Connect kimlikleri vardır.
  • Health Connect kimlikleri, zaman damgalarıyla bağlı veya ilişkili değildir.
  • Bazı kullanım alanlarında, iş akışı sırasında belirli bir Health Connect kimliğinin saklanması gerekebilir. Örneğin, kullanıcının yeni kaydettiği veri girişini almak ve göstermek için belirli bir kimlik gerekir.

Health Connect'te geçirilen süre

Health Connect'e yazılan tüm verilerde saat dilimi farkı bilgisi belirtilmelidir. Bölge farkının belirtilmesi, uygulamaların verileri okuyarak sivil saatte göstermesini sağlar. Sivil saat, kullanıcının yerel ve alakalı olduğu saattir ancak Eşgüdümlü Evrensel Saat (UTC) olmayabilir.

Nadir durumlarda, saat dilimi farkı kullanılamayabilir. Bu durum Android 14'te (API düzeyi 34) gerçekleştiğinde Health Connect, saat dilimi farkını cihazın sistem varsayılan saat dilimine göre ayarlar. Android 13 ve önceki sürümlerde (API düzeyi 33 ve önceki sürümler) herhangi bir saat dilimi farkı bilgisi belirtmeden Health Connect'e yazmak mümkündür. Bu durum mümkün olduğunda önlenmelidir.

Saat ve saat dilimi ayarı

Veri yazarken bölge saat farkı bilgilerini belirtmek, Health Connect'te veri okurken saat dilimi bilgilerini sağlar. Ancak, bölge farkı sağlanmadığında olduğu gibi belirli durumlarda bunu yapamayabilir. Uygulamanız, her iki veri türünü de özel durumunuza uygun bir şekilde işleyecek şekilde hazırlanmalıdır.

İzinler

Uygulamanız, herhangi bir izin isteğinde bulunmadan önce bunları manifest dosyasında bildirmelidir. Veri türlerinin ve izinlerinin tam eşlemesi için aşağıdaki tablolara bakın.

1.0.0-alpha10 ve sonraki sürümler için

İzin referansı İzin beyanını okuma
Arka planda okuma android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
Geçmiş okumalar android.permission.health.READ_HEALTH_DATA_HISTORY

Kayıt sınıfı türü İzin beyanını okuma ve yazma
ActiveCaloriesBurned android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED
BasalBodyTemperature android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE
BasalMetabolicRate android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE
BloodGlucose android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE
BloodPressure android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE
BodyFat android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT
BodyTemperature android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE
BodyWaterMass android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS
BoneMass android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS
CervicalMucus android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS
CyclingPedalingCadence android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE
Mesafe android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE
ElevationGained android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED
ExerciseSession android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

Egzersiz türü

EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_HAND
EXERCISE_TYPE_BIKING_MOUNTAIN
EXERCISE_TYPE_BIKING_ROAD
EXERCISE_TYPE_BIKING_SPINNING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BIKING_UTURN
EXERCISE_TYPE_CANOEING
EXERCISE_TYPE_CROSSFIT
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_HORSEBACK_RIDING
EXERCISE_TYPE_KAYAKING
EXERCISE_TYPE_KICKBOXING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_ROLLERBLADING
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_JOGGING
EXERCISE_TYPE_RUNNING_SAND
FloorsClimbed android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED
HeartRate android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE
HeartRateVariabilityRmssd android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY
Yükseklik android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT
Hidrasyon android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION
IntermenstrualBleeding android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING
LeanBodyMass android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS
MenstruationFlow android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION
MindfulnessSession android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS
Beslenme (Nutrition) android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION
OvulationTest android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST
OxygenSaturation android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION
PlannedExerciseSession android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE
Güç android.permission.health.READ_POWER
android.permission.health.WRITE_POWER
RespiratoryRate android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE
RestingHeartRate android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE
SexualActivity android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY
SkinTemperature android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE
SleepSession android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP
Hız android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED
Uygulanacak adımlar android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
StepsCadence android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
TotalCaloriesBurned android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED
VO2Max android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX
Ağırlık android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT
WheelchairPushes android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES

1.0.0-alpha09 ve önceki sürümler için

Kayıt sınıfı türü İzin beyanını okuma ve yazma
ActiveCaloriesBurned androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE
BasalBodyTemperature androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE
BasalMetabolicRate androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE
BloodGlucose androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE
BloodPressure androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE
BodyFat androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE
BodyTemperature androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE
BodyWaterMass androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE
BoneMass androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE
CervicalMucus androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE
CyclingPedalingCadence androidx.health.permission.Exercise.READ
androidx.health.permission.Exercise.WRITE
Mesafe androidx.health.permission.Distance.READ
androidx.health.permission.Distance.WRITE
ElevationGained androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.WRITE
ExerciseSession androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE

Egzersiz türü

EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_HAND
EXERCISE_TYPE_BIKING_MOUNTAIN
EXERCISE_TYPE_BIKING_ROAD
EXERCISE_TYPE_BIKING_SPINNING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BIKING_UTURN
EXERCISE_TYPE_CANOEING
EXERCISE_TYPE_CROSSFIT
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_HORSEBACK_RIDING
EXERCISE_TYPE_KAYAKING
EXERCISE_TYPE_KICKBOXING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_ROLLERBLADING
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_JOGGING
EXERCISE_TYPE_RUNNING_SAND
FloorsClimbed androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE
HeartRate androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE
HeartRateVariabilityRmssd androidx.health.permission.HeartRateVariability.READ
androidx.health.permission.HeartRateVariability.WRITE
Yükseklik androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE
Hidrasyon androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE
IntermenstrualBleeding androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE
LeanBodyMass androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE
MenstruationFlow androidx.health.permission.Menstruation.READ
androidx.health.permission.Menstruation.WRITE
Beslenme (Nutrition) androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE
OvulationTest androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE
OxygenSaturation androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE
PlannedExerciseSession androidx.health.permission.PlannedExerciseSession.READ
androidx.health.permission.PlannedExerciseSession.WRITE
Güç androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE
RespiratoryRate androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE
RestingHeartRate androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE
SexualActivity androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE
SleepSession androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE
Hız androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE
Uygulanacak adımlar androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE
StepsCadence androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE
TotalCaloriesBurned androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE
VO2Max androidx.health.permission.VO2Max.READ
androidx.health.permission.VO2Max.WRITE
Ağırlık androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE
WheelchairPushes androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelchairPushes.WRITE

Veri türlerinizi ve izinlerinizi inceleme

Veri türlerinizi ve izinlerinizi planladığınıza göre bunları geliştirme sırasında uygulayabilirsiniz.

Uygulamanızı Play Store'a yüklemeden önce incelerken uygulamanızın gerektirdiği veri türleri ve izinler listesini tekrar kontrol edin. Bu sayede uygulamanızın veri kullanımını doğru bir şekilde beyan edebilirsiniz.

Uygulamanızı Play Store'da yayınlamaya hazırlanırken uygulamanızın kullandığı Health Connect veri türlerine erişimi beyan edin. Aksi takdirde, kullanıcılara uygulamanızın özel onay gerektiren Health Connect veri türlerine erişemediğiyle ilgili bir hata mesajı gösterilebilir.