Typy danych

Google Fit udostępnia zestaw typów danych o zdrowiu i samopoczuciu w przestrzeni nazw com.google.

Typy danych określają format wartości w punktach danych. Punkt danych może reprezentować:

• odczyt lub obserwację w danym momencie;
• zagregowane dane ze statystykami z określonego przedziału czasu.

Google Fit definiuje typy danych dla obserwacji w danym momencie i typy danych dla danych zbiorczych. Punkty danych składają się z wartości pól typu danych i informacji o sygnaturze czasowej. Punkty reprezentujące obserwacje w danym momencie zawierają sygnaturę czasową, a punkty zagregowanego typu danych zawierają też czas rozpoczęcia przedziału.

Google Fit umożliwia też definiowanie nowych typów danych.

Grupy typów danych

Google Fit ma te typy danych:

Publiczne typy danych

Standardowe typy danych udostępniane przez platformę mają prefiks „com.google”. Na przykład com.google.step_count.delta. Te typy danych rejestrują odczyty w danym momencie dotyczące danych o zdrowiu i samopoczuciu, w tym aktywności fizycznej, snu i odżywiania. Każda aplikacja może poprosić o odpowiednie uprawnienia do odczytywania i zapisywania tych typów danych, z wyjątkiem kilku typów danych o lokalizacji, które mogą być odczytywane tylko przez aplikację, która je zapisała.

Więcej informacji znajdziesz w tych artykułach:

• Typy danych o aktywności
• Typy danych o lokalizacji
• Typy danych o odżywianiu

Typy danych o zdrowiu

Typy danych udostępniane przez platformę, do których dostęp jest ograniczony ze względu na potencjalnie dane wrażliwe. Więcej informacji znajdziesz w artykule Typy danych o zdrowiu.

Zagregowane typy danych

Typy danych do odczytywania informacji o zdrowiu i samopoczuciu zagregowanych według czasu lub typu aktywności. Więcej informacji znajdziesz w artykule Zagregowane typy danych.

Prywatne niestandardowe typy danych

Niestandardowe typy danych zdefiniowane przez konkretną aplikację. Tylko aplikacja, która definiuje typ danych, może odczytywać i zapisywać dane tego typu. Więcej informacji znajdziesz w artykule Niestandardowe typy danych.

Korzystanie z typów danych

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

Zakresy autoryzacji

Zakresy autoryzacji obejmują grupy typów danych, do których użytkownik może autoryzować dostęp aplikacji. Pomagają one użytkownikom zrozumieć, do jakich danych aplikacja chce uzyskać dostęp. Ułatwiają też przyznawanie aplikacjom uprawnień do korzystania z tych danych, ponieważ nie trzeba zatwierdzać każdego typu danych z osobna. Użytkownicy przyznają te uprawnienia po pobraniu aplikacji.

Po przetestowaniu aplikacji przez niewielką liczbę użytkowników musisz przed jej uruchomieniem poprosić o weryfikację na podstawie zakresów związanych z tymi typami danych. Przeczytaj strony dotyczące typów danych, do których linki znajdziesz powyżej, aby dowiedzieć się, które zakresy mają zastosowanie do poszczególnych typów danych.

Jeśli na przykład Twoja aplikacja musi odczytywać i zapisywać dane ciśnienia krwi, musi zadeklarować, że wykonuje zarówno odczyt, jak i zapis, oraz poprosić o oba zakresy. Jeśli zapisuje tylko dane ciśnienia krwi na platformie Google Fit, musi poprosić tylko o zakres zapisu.

Wybieraj typy danych odpowiedzialnie. Nie proś o każdy typ danych na wypadek, gdyby Twoja aplikacja mogła go potrzebować. Określone typy danych decydują o tym, o jakie zakresy użytkownik zostanie poproszony o przyznanie uprawnień. Proś tylko o typy danych, których potrzebuje Twoja aplikacja, aby użytkownicy chętniej przyznawali dostęp. Użytkownicy chętniej przyznają dostęp do ograniczonych, jasno opisanych zakresów.

Z tej tabeli dowiesz się, czy zakresy, do których Twoja aplikacja potrzebuje dostępu, są wrażliwe lub objęte ograniczeniami (co określa kroki weryfikacji, które musisz wykonać):

Dodawanie nowych zakresów do istniejącej aplikacji

Gdy zaktualizujesz aplikację, aby poprosić o nowy zakres (np. jeśli dodasz nowe zakresy snu lub tętna albo zakres odczytu), użytkownicy zobaczą prośbę o dostęp do tych zakresów i będą mogli przyznać lub odrzucić dostęp.

Najlepiej jest prosić użytkowników o autoryzację zasobów w momencie, gdy są one potrzebne. Postępuj zgodnie ze wskazówkami dotyczącymi proszenia o autoryzację stopniową.

Użytkownicy chętniej przyznają dostęp, jeśli rozumieją, dlaczego i jak Twoja aplikacja korzysta z tych danych:

• Rozważ dodanie ekranu, który ostrzega lub informuje użytkowników, że zostaną poproszeni o te zakresy.
• Jasno wyjaśnij, dlaczego Twoja aplikacja prosi o dostęp do tych zakresów lub danych, aby użytkownicy mogli podjąć świadomą decyzję.

Więcej informacji o sprawdzonych metodach dotyczących uprawnień aplikacji na Androida.