Jenis data

Google Fit menyediakan sekumpulan jenis data kesehatan dan kebugaran di bawah namespace com.google.

Tipe data menentukan format nilai di dalam titik data. Titik data dapat mewakili:

• Bacaan atau pengamatan instan
• Agregat dengan statistik selama interval waktu

Google Fit menentukan jenis data untuk pengamatan instan dan jenis data untuk agregat layanan otomatis dan data skalabel. Titik data terdiri dari nilai untuk kolom jenis data dan informasi stempel waktu. Poin-poin yang mewakili pengamatan instan termasuk stempel waktu, dan poin-poin jenis data gabungan juga menyertakan waktu mulai untuk interval.

Google Fit juga memungkinkan Anda menentukan jenis data baru.

Grup jenis data

Google Fit memiliki jenis data berikut:

Jenis data publik

Jenis data standar yang disediakan oleh platform memiliki 'com.google' . Misalnya, com.google.step_count.delta. Tipe data ini menangkap bacaan instan untuk data kesehatan dan kebugaran, termasuk aktivitas kebugaran, tidur, dan nutrisi. Apa saja aplikasi dapat meminta izin akses yang relevan untuk membaca dan menulis ke tipe data ini, kecuali beberapa jenis data lokasi yang hanya dapat dibaca oleh aplikasi yang menulisnya.

Untuk informasi selengkapnya, lihat:

• Jenis data aktivitas
• Jenis data lokasi
• Jenis data gizi

Jenis data kesehatan

Jenis data yang disediakan oleh platform yang memiliki akses terbatas karena data yang berpotensi sensitif. Untuk informasi selengkapnya, lihat Data kesehatan jenis file.

Jenis data agregat

Jenis data untuk membaca informasi kesehatan dan kebugaran yang dikumpulkan menurut waktu atau jenis aktivitas. Untuk informasi selengkapnya, lihat Data gabungan jenis file.

Jenis data kustom pribadi

Jenis data kustom yang ditentukan oleh aplikasi tertentu. Hanya aplikasi yang menentukan tipe data dapat membaca dan menulis data berjenis ini. Untuk informasi selengkapnya, lihat Jenis data kustom.

Menggunakan tipe data

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"
},
...
}

Cakupan otorisasi

Cakupan otorisasi mencakup grup jenis data yang dapat diizinkan oleh pengguna untuk aplikasi akses. Mereka membantu pengguna memahami jenis data apa yang ingin diakses oleh sebuah aplikasi. Izin ini juga mempermudah pemberian izin kepada aplikasi untuk menggunakan data tersebut dengan tidak memiliki untuk menyetujui setiap jenis data individual. Pengguna memberikan izin ini setelah mereka mengunduh aplikasi Anda.

Setelah menguji aplikasi dengan sejumlah kecil pengguna, sebelum meluncurkan aplikasi, Anda harus meminta verifikasi berdasarkan cakupan yang relevan dengan jenis data tersebut. Baca halaman tipe data yang ditautkan di atas untuk memahami cakupan mana yang berlaku untuk setiap jenis data.

Misalnya, jika aplikasi Anda perlu membaca dan menulis tulis tekanan darah, aplikasi perlu mendeklarasikan bahwa ia melakukan pembacaan dan penulisan dan permintaan kedua cakupan. Jika ya hanya menulis data tekanan darah ke platform Google Fit, dan hanya perlu meminta cakupan operasi tulis.

Memilih jenis data secara bertanggung jawab. Jangan meminta setiap jenis data jika aplikasi Anda mungkin membutuhkannya. Jenis yang ditentukan menentukan cakupan yang diminta oleh pengguna yang akan diberi izin. Hanya minta jenis data yang dibutuhkan aplikasi Anda sehingga pengguna lebih mungkin untuk memberikan akses. Pengguna lebih mudah memberikan akses kepada cakupan yang dijelaskan.

Gunakan tabel ini untuk memeriksa apakah cakupan yang perlu diakses aplikasi Anda bersifat sensitif atau dibatasi (yang menentukan izin verifikasi langkah-langkah yang harus Anda ikuti):

Menambahkan cakupan baru ke aplikasi yang ada

Saat Anda mengupdate aplikasi untuk meminta cakupan baru (misalnya, jika Anda menambahkan yang baru tidur atau detak jantung, atau menambahkan cakupan baca), pengguna akan ditanya aplikasi Anda meminta akses ke cakupan ini dan aplikasi dapat memilih untuk memberikan atau menolak akses.

Praktik terbaiknya adalah meminta otorisasi dari pengguna untuk resource pada saat itu saat dibutuhkan. Ikuti panduan tentang cara meminta inkremental otorisasi.

Pengguna akan lebih cenderung memberikan akses jika mereka memahami mengapa/bagaimana aplikasi Anda menggunakan data ini:

• Pertimbangkan untuk menambahkan layar yang memperingatkan/memberi tahu pengguna bahwa mereka akan diminta cakupan tersebut.
• Jelaskan dengan jelas alasan aplikasi Anda meminta akses ke cakupan/data ini sehingga pengguna dapat membuat keputusan yang tepat.

Pelajari lebih lanjut praktik terbaik seputar izin aplikasi untuk Android.