Interfejs Google Health API śledzi kroki i dane o aktywności użytkownika za pomocą typu danych interwału steps. Liczba kroków to podstawowa miara codziennej aktywności fizycznej, która pomaga deweloperom śledzić postępy w ćwiczeniach, obliczać wydatek energetyczny i tworzyć podsumowania codziennej aktywności dla użytkowników.
Dowiedz się, jak odczytywać i strukturyzować dane o liczbie kroków w aplikacji, aby zapewnić użytkownikom jak najlepsze wrażenia.
Obsługiwane typy danych
Interfejs API obsługuje ten typ danych do śledzenia liczby kroków:
| Typ danych | Dostępne operacje |
Zakres |
|---|---|---|
|
Kroki
dataType:
stepsfilter parameter: steps
Typ rekordu: Interwał
Rozdzielczość pamięci masowej: 1 minuta
Zgodne urządzenia
|
list, reconcile, rollup, dailyRollup | .activity_and_fitness.readonly.activity_and_fitness.writeonly |
Wytyczne
Podczas integrowania śledzenia kroków z aplikacją postępuj zgodnie z tymi wytycznymi dotyczącymi projektowania i wdrażania.
Obliczanie prędkości i tempa
Interfejs Google Health API oblicza prędkość i tempo za pomocą standardowych wzorów:
- Prędkość =
distance / time(hour) - Tempo =
time(seconds) / distance
Nagłówek Accept-Language określony w żądaniu określa jednostkę odległości.
Codzienne podsumowanie
Aby dokładnie agregować dzienne liczby kroków podczas podróży, zmian strefy czasowej lub czasu letniego, nie wykonuj obliczeń czasu trwania po stronie klienta. Zamiast tego wyślij zapytanie do punktu końcowego dailyRollUp, który automatycznie uzupełnia luki w danych fizycznych, korzystając z przesunięć UTC. Zestawienie zwraca obiekt StepsRollupValue zawierający pole countSum, które reprezentuje łączną liczbę kroków w danym dniu. Szczegółowe informacje znajdziesz w sekcji Agregowanie danych według dni kalendarzowych w przewodniku po danych zbiorczych.
Interfejsy użytkownika do rysowania (uzgadnianie)
Podczas tworzenia elementów interfejsu do wyświetlania danych o krokach używaj punktu końcowego reconcile. Jeśli kilka źródeł danych (np. zegarek i telefon komórkowy) zarejestrowało kroki w tym samym czasie, punkt końcowy reconcile rozwiązuje konflikty i scala strumienie, aby zwrócić jeden, uzgodniony strumień danych.
Informacje o obsłudze nakładających się interwałów z synchronizacji połączonych urządzeń i zmienności sygnatur czasowych znajdziesz w przewodniku po zarządzaniu danymi.
Śledzenie i histogramy w ciągu dnia
Aby wyświetlić szczegółową aktywność użytkownika w ciągu dnia (np. wykresy):
- Histogramy kroków godzinowych lub minutowych: wyślij zapytanie do punktu końcowego
rollUp, określając czas trwania (np.60sdla 1 minuty lub3600sdla 1 godziny) za pomocą parametruwindowSize. Dane o krokach są rejestrowane w interwałach 1-minutowych (60s), dlatego ustaw parametrwindowSizena co najmniej60s. Żądania z oknami mniejszymi niż minuta (np.10slub30s) nie dzielą sum poszczególnych minut, ale umieszczają liczbę z całej minuty w pierwszym pasującym podzasobniku. Więcej informacji znajdziesz w sekcji Okno podsumowania i rozdzielczość przechowywania. - Wszystkie zapisy kroków: użyj punktu końcowego
list, aby pobrać najbardziej szczegółowe, nieprzetworzone zapisy kroków.
Punkty końcowe rollUp, dailyRollUp i reconcile akceptują parametr dataSourceFamily, który umożliwia filtrowanie danych z określonych grup źródeł. Więcej informacji i przykłady użycia znajdziesz w sekcji Filtrowanie według rodziny źródeł danych w przewodniku po filtrowaniu danych.
Synchronizacja za pomocą webhooków
Zasubskrybuj kolekcję typu danych steps, aby otrzymywać powiadomienia o zaimportowaniu lub zsynchronizowaniu nowych danych o krokach. Zamiast odpytywać punkty końcowe REST, aktualizuj panele po stronie klienta dynamicznie w odpowiedzi na te powiadomienia webhooka. Szczegółowe informacje o konfigurowaniu subskrypcji znajdziesz w artykule Subskrypcje webhooków.