Health Platform API'si

Health Platform API, geliştiricilere kullanıcının geçmiş sağlık, zindelik ve fitness verilerini okuma, yazma ve paylaşma için tek bir arayüz sağlayan bir Android API'sidir. Sağlık Platformu ile kullanıcılar verilerini kontrol edebilir. Kullanıcılar, farklı veri türlerine hangi uygulamaların okuma veya yazma erişimine sahip olacağını kontrol eder. Sağlık Platform API veri türleri arasında boy, kalp atış hızı ve daha fazlası yer alır.

Health Platform API, kullanıcılara kişisel sağlık, fitness ve sağlıklı yaşam verilerine hangi uygulamaların erişebileceğini ve bu verileri hangi uygulamaların gösterebileceğini seçmelerine olanak tanıyan bir depolama ve paylaşım mekanizması sunar. Bu sayede uygulama geliştiriciler, kullanıcılara sağlıklarıyla ilgili daha kapsamlı bir görünüm sunabilir ve kullanıcılar verilerini daha etkili bir şekilde izleyebilir.

Health Platform API yazılım geliştirme kiti, Android uygulama geliştiricilere belirli Samsung cihazlarda kullanıcının sağlık ve zindelik verilerine erişim sağlamak için ihtiyaç duydukları her şeyi sunar. Ayrıca uygulamaların veri ekleme, silme ve okuma gibi toplu işlemler gerçekleştirmesine olanak tanır.

Başlayın

Sağlık Platformu'nu 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ı, izinleri reddedebilir veya daha sonra herhangi bir zamanda iptal edebilir.
• Sağlık Platformu API'si yalnızca belirli Samsung cihazları destekler.
• HealthDataClient, Health Platform'un istemcisidir ve Health Platform'a giriş noktasıdır.

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

Yayın dosyaları

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

• Client SDK: Health Platform API'yi kullanmak için bu SDK'yı uygulamanıza ekleyin. SDK, uygulamanızın Gradle derleme dosyalarına doğrudan ekleyebileceğiniz bir Maven deposudur.

Sağlık Platformu'nu yükleme

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

Uygulamanın kök build.gradle dosyasında, aşağıdaki örnekte gösterildiği gibi depoyu ekleyin:

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

Modülünüzün build.gradle dosyasında Health Platform SDK'ya bağımlılık ekleyin. Aşağıdaki örnekte bu işlem gösterilmektedir:

Veri

Sağlık Platformu, sağlık ve fitness verilerini depolayıp yapılandırır. Ayrıca, farklı türlerdeki verilerin ölçülme şekilleri arasındaki temel farkları da dikkate alır. Örneğin, kalp atış hızı ölçümü anında yapılırken adım sayısı belirli bir süre boyunca alınır.

Sağlık Platformu'ndaki temel nesneler ve aralarındaki farklar aşağıda açıklanmıştır:

• RawData: Ölçüm ve veri kaydı.
• DataType: Kalp atış hızı, vücut yağı veya vücut sıcaklığı gibi yaygın sağlık ve fitness verilerinin ve bunların biçimlerinin (ör. alanlar, salt okunur veya isteğe bağlı) belirleyicisi.
• SampleData: Kalp atış hızı, kan basıncı veya koşu hızı gibi anlık ölçüm olan bir RawData nesnesi.
• IntervalData: Belirli bir süre boyunca yapılan kümülatif ölçümler olan RawData nesnesi (ör. atılan adım sayısı, gidilen mesafe veya yakılan kalori).
• SeriesData: Belirli bir süre boyunca yapılan ölçümler dizisini kapsayan bir RawData nesnesi. SeriesData özellikle bir aktivite oturumu sırasında sürekli nabız örnekleri gibi yüksek frekanslı sensör verileri için uygundur.

Üç RawData sınıfının her biri DataType sınıfının belirli bir alt sınıfına karşılık gelir: SampleData, IntervalData ve SeriesData sırasıyla SampleDataType, IntervalDataType ve SeriesDataType sınıflarına karşılık gelir.

Her RawData nesnesine, eklendiğinde Health Platform tarafından benzersiz bir tanımlayıcı (UID) atanır. Bu UID'yi, okuma, güncelleme veya silme isteklerinde belirli bir RawData nesneye referans vermek için kullanabilirsiniz.

Veri türleri

Sağlık Platformu, sağlık ve fitness uygulamalarında yaygın olarak kullanılan çok çeşitli veri türlerini içerir. Kullanılabilir veri türleriyle depolanan veriler, kullanıcılara geçmiş sağlık, fitness ve sağlıklı yaşam verileri hakkında kapsamlı bir görünüm sunarak günlük aktiviteleri hakkında bilgi verir.

Her veri türü, veri biçimiyle tanımlanır. Veri biçimi şunları içerir:

• 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 gibi alanlar bulunur.
• Tür: long, double, string veya enum.
• Özellik: Salt okunur, zorunlu, isteğe bağlı veya doğrulama aralığı.

Veri türlerinin listesi

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

SampleData türleri:

IntervalData türleri:

SeriesData türleri:

Geliştirici işlevleri

Aşağıda, Health Platform'da kullanılabilen standart veri işlevleri açıklanmaktadır. Platform, ham veriler için standart ekleme, güncelleme ve silme işlevleri sunar.

Read AggregatedData

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

• StatisticalData: SampleData veya SeriesData kümesindeki ortalama, minimum ya da maksimum değerler (ör. bir aktivite oturumu sırasındaki minimum ve maksimum kalp atış hızı).
• CumulativeData: Günlük aralıktaki toplam adım sayısı gibi IntervalData değerlerinin toplamı.
• CountData: Belirli bir haftadaki etkinlik oturumlarının sayısı gibi temel RawData nesnelerin sayısının basit bir şekilde hesaplanması. Sayım verileri; örnek, aralık ve seri veri türleri için hesaplanabilir.

Sağlık Platformu API'sine bağlanma

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

Aşağıdaki adımlarda, Health Platform'a nasıl bağlanılacağı açıklanmaktadır:

1. Yeni HealthDataClient örnekleri oluşturmak için HealthDataService.getClient simgesini kullanın.
2. Ardından, istemci uygulaması requestPermissions (Set) yöntemini kullanarak kullanıcıdan izin istemelidir.

HealthDataClient, temel depolama katmanıyla bağlantısını otomatik olarak yönetir ve tüm süreçler arası iletişimi (IPC) ve giden isteklerin ve gelen yanıtların serileştirilmesini işler.