Veri türleri

Google Fit, com.google ad alanı altında bir dizi sağlık ve sağlıklı yaşam veri türü sağlar.

Veri türleri, veri noktalarındaki değerlerin biçimini tanımlar. Veri noktası şunları temsil edebilir:

• Anlık okuma veya gözlem
• Bir zaman aralığındaki istatistikleri içeren toplama

Google Fit, anlık gözlemler için veri türleri ve toplu veriler için veri türleri tanımlar. Veri noktaları, bir veri türünün alanlarının değerlerinden ve zaman damgası bilgilerinden oluşur. Anlık gözlemleri temsil eden noktalarda zaman damgası bulunur. Toplu veri türündeki noktalarda ise aralığın başlangıç zamanı da yer alır.

Google Fit, yeni veri türleri tanımlamanıza da olanak tanır.

Veri türü grupları

Google Fit'te aşağıdaki veri türleri bulunur:

Herkese açık veri türleri

Platform tarafından sağlanan standart veri türleri "com.google" önekine sahiptir. Örneğin, com.google.step_count.delta. Bu veri türleri; fitness aktivitesi, uyku ve beslenme gibi sağlık ve sağlıklı yaşam verileri için anlık okumaları yakalar. Bu veri türlerine yazmak ve bunları okumak için ilgili izinleri isteyen uygulamalar (yalnızca yazan uygulama tarafından okunabilen birkaç konum verisi türü hariç) bu verilere erişebilir.

Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

• Etkinlik veri türleri
• Konum veri türleri
• Beslenme verisi türleri

Sağlık verisi türleri

Potansiyel olarak hassas veriler nedeniyle erişimi kısıtlanmış, platform tarafından sağlanan veri türleri. Daha fazla bilgi için Sağlık verisi türleri başlıklı makaleyi inceleyin.

Toplu veri türleri

Sağlık ve sağlıklı yaşam bilgilerini zamana veya etkinlik türüne göre toplayıp okumak için kullanılan veri türleri. Daha fazla bilgi için Toplu veri türleri başlıklı makaleyi inceleyin.

Özel veri türleri

Belirli bir uygulama tarafından tanımlanan özel veri türleri. Bu türdeki verileri yalnızca veri türünü tanımlayan uygulama okuyabilir ve yazabilir. Daha fazla bilgi için Özel veri türleri başlıklı makaleyi inceleyin.

Veri türlerini kullanma

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

Yetkilendirme kapsamları

Yetkilendirme kapsamları, kullanıcının bir uygulamanın erişmesine yetki verebileceği veri türü gruplarını kapsar. Bu izinler, kullanıcıların bir uygulamanın ne tür verilere erişmek istediğini anlamasına yardımcı olur. Ayrıca, her bir veri türünü onaylamanız gerekmediği için uygulamalara bu verileri kullanma izni vermeyi kolaylaştırır. Kullanıcılar, uygulamanızı indirdikten sonra bu izinleri verir.

Uygulamanızı az sayıda kullanıcıyla test ettikten sonra, uygulamanızı kullanıma sunmadan önce bu veri türleriyle ilgili kapsamlar temelinde doğrulama isteğinde bulunmanız gerekir. Hangi kapsamların her veri türü için geçerli olduğunu anlamak üzere yukarıda bağlantısı verilen veri türleri sayfalarını inceleyin.

Örneğin, uygulamanızın tansiyonu okuması ve yazması gerekiyorsa hem okuma hem de yazma işlemi yaptığını beyan etmesi ve her iki kapsamı da istemesi gerekir. Yalnızca Google Fit platformuna tansiyon verileri yazıyorsa yalnızca yazma kapsamı isteğinde bulunması gerekir.

Veri türlerini sorumlu bir şekilde seçin. Uygulamanızın ihtiyaç duyabileceği her veri türünü istemeyin. Belirtilen türler, kullanıcıdan hangi kapsamlar için izin vermesinin isteneceği konusunda belirleyici olur. Kullanıcıların erişim izni verme olasılığını artırmak için yalnızca uygulamanızın ihtiyaç duyduğu veri türlerini isteyin. Kullanıcılar, sınırlı ve net bir şekilde açıklanmış kapsamlara daha kolay erişim izni verir.

Uygulamanızın erişmesi gereken kapsamların hassas veya kısıtlı olup olmadığını kontrol etmek için bu tabloyu kullanın (bu, uygulamanızın doğrulama adımlarını belirler):

Mevcut bir uygulamaya yeni kapsamlar ekleme

Uygulamanızı yeni bir kapsam isteyecek şekilde güncellediğinizde (ör. yeni uyku veya kalp atış hızı kapsamlarını eklediğinizde ya da bir okuma kapsamı eklediğinizde) kullanıcılara uygulamanızın bu kapsamlara erişim istediği bildirilir ve erişimi kabul edip etmeyeceklerini seçebilirler.

Kullanıcılardan kaynaklar için yetkilendirme isteğinde bulunmak en iyi uygulamadır. Aşamalı yetkilendirme isteğinde bulunmayla ilgili yönergeleri uygulayın.

Kullanıcılar, uygulamanızın bu verileri neden/nasıl kullandığını anlarsa erişim izni verme olasılığı daha yüksek olur:

• Kullanıcılardan bu kapsamlar için izin isteneceğini belirten/bildiren bir ekran eklemeyi düşünebilirsiniz.
• Uygulamanızın neden bu kapsamlar/veriler için erişim istediğini kullanıcılara net bir şekilde açıklayın. Böylece kullanıcılar bilinçli bir karar verebilir.

Android'deki uygulama izinleriyle ilgili en iyi uygulamalar hakkında daha fazla bilgi edinin.