Tworzenie funkcji związanych z liczbą kroków za pomocą interfejsu Google Health API

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:

Tabela: typy danych Google Health API Steps
Typ danych Dostępne operacje
 Zakres
Kroki
dataType: steps
filter 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. 60s dla 1 minuty lub 3600s dla 1 godziny) za pomocą parametru windowSize. Dane o krokach są rejestrowane w interwałach 1-minutowych (60s), dlatego ustaw windowSize na co najmniej 60s. Żądania z oknami mniejszymi niż minuta (np. 10s lub 30s) nie dzielą sum poszczególnych minut, ale umieszczają pełną liczbę minut w pierwszym pasującym podzasobniku. Więcej informacji znajdziesz w artykule Okno zestawienia i rozdzielczość miejsca na dane.
  • 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 w czasie rzeczywistym za pomocą webhooków

Zasubskrybuj kolekcję typu danych steps, aby otrzymywać powiadomienia w czasie rzeczywistym, gdy nowe dane o krokach zostaną zaimportowane lub zsynchronizowane. Zamiast odpytywać punkty końcowe REST, aktualizuj dynamicznie panele po stronie klienta w odpowiedzi na te powiadomienia webhooka. Szczegółowe informacje o konfigurowaniu subskrypcji znajdziesz w artykule Subskrypcje webhooków.

Wstecz
Odżywianie i nawadnianie
Dalej
Sen i regeneracja