Aby zapewnić dokładność danych i spójne agregacje, interfejs Google Health API modernizuje sposób raportowania aktywności użytkownika. Dzięki wprowadzeniu parametrów true zeros i on-wrist filtering interfejs API umożliwia dokładne rozróżnianie okresów, w których użytkownik był w ruchu, od okresów, w których nie miał na sobie urządzenia.
True Zeros
Prawdziwe zero to wyraźny punkt danych, który wskazuje, że użytkownik nosił urządzenie i aktywnie śledził dane, ale w przypadku konkretnego wskaźnika zarejestrował wartość zero. Na przykład użytkownik może zarejestrować 0 kroków lub 0 metrów w ciągu 1-minutowego interwału, gdy ma na sobie urządzenie.
W przeszłości brakujące dane były niejednoznaczne. Może to oznaczać, że użytkownik był w stanie braku aktywności lub że urządzenie nie było na nadgarstku. Interfejs API rozwiązuje ten problem, wyraźnie przechowując i zwracając wartość 0, gdy urządzenie jest noszone, ale nieaktywne. Dzięki temu możesz wyraźnie odróżnić okresy, w których zegarek był nieruchomy na nadgarstku, od brakujących danych.
Filtrowanie na zegarku
Filtrowanie na nadgarstku to proces sprawdzania, czy użytkownik ma urządzenie na nadgarstku. Dzięki temu interfejs API może odfiltrowywać zbędne dane, takie jak „fałszywe” kroki zarejestrowane z powodu wibracji pojazdu, gdy urządzenie znajduje się w torbie.
Obsługiwane typy danych
Te typy danych obsługują zachowanie prawdziwego zera i filtrowanie na nadgarstku:
- Wysokość
- Odległość
- Piętra
- Kroki
- Wszystkie kalorie
Wpływ na Twoją aplikację
Wprowadzenie prawdziwych zer zwiększa dokładność interpretacji luk w danych i obliczeń danych, takich jak średnie dzienne.
Działanie list i usług o pełnym zakresie
Domyślnie interfejs Google Health API zwraca tylko dane z urządzenia na nadgarstek w przypadku tych typów danych:
- Operacje na liście: zwraca punkty danych tylko z okresów, w których urządzenie było noszone. Luki na liście oznaczają, że urządzenie nie było na nadgarstku lub nie było synchronizowane.
- Operacje zbiorcze: zero w odpowiedzi oznacza prawdziwe zero (użytkownik miał na sobie urządzenie, ale się nie poruszał). Jeśli urządzenie śledzące nie było noszone w określonym przedziale czasu, interfejs API nie zwraca żadnych danych dla tego okna zbiorczego.
Porównanie z interfejsem Fitbit Web API
Interfejs Fitbit Web API często zwracał dane, w tym zera, nawet wtedy, gdy urządzenie śledzące nie było noszone. Interfejs Google Health API zapewnia dokładniejsze odzwierciedlenie ruchu.
| Funkcja | Fitbit Web API | Google Health API |
|---|---|---|
| Niejednoznaczność braku aktywności | Brak danych może oznaczać brak aktywności lub zdjęcie urządzenia z nadgarstka. | Prawdziwe zera wyraźnie wskazują brak aktywności podczas noszenia urządzenia. |
| Luki w danych | Luki w danych mogą być domyślnie wypełniane przesunięciami względem czasu UTC. | Jawne przechowywanie rozwiązuje problemy ze strefą czasową i czasem urzędowym. |
| Filtrowanie | Ograniczone filtrowanie na zegarku. | Ścisłe filtrowanie na nadgarstku zapewnia dokładność fizjologiczną. |