Schritt-Erlebnisse mit der Google Health API entwickeln

Die Google Health API erfasst Schritte und Aktivitätsdaten von Nutzern mit dem Intervalldatentyp steps. Die Schrittzahl ist ein grundlegendes Maß für die tägliche körperliche Aktivität. Sie hilft Entwicklern, Fitnessfortschritte zu verfolgen, den Energieverbrauch zu berechnen und tägliche Aktivitätszusammenfassungen für Nutzer zu erstellen.

Hier erfahren Sie, wie Sie Schrittzahldaten in Ihrer Anwendung lesen und strukturieren können, um Nutzern die bestmögliche Erfahrung zu bieten.

Unterstützte Datentypen

Die API unterstützt den folgenden Datentyp zum Erfassen von Schrittzahlen:

Tabelle: Datentypen für Schritte in der Google Health API
Datentyp
  dataType
  filter Parameter		 Datensatztyp
 Verfügbare
Vorgänge		 Bereich Webhook
Unterstützung		 Unterstützung für „Echte Nullen“
Schritte
  steps
  steps 		Intervall list, reconcile, rollup, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

In den folgenden Abschnitten finden Sie technische Details zum Datentyp steps, einschließlich Beispielen für die REST-Darstellung und Richtlinien zur Integration.

Erforderliche Bereiche

Für den Zugriff auf diesen Datentyp muss Ihre App die folgenden OAuth-Bereiche anfordern:

  • Lesen: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
  • Schreiben: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

Richtlinien

Beachten Sie beim Einbinden der Schrittverfolgung in Ihre App die folgenden Richtlinien für Design und Implementierung.

Tagesübersicht

Wenn Sie die täglichen Schrittzahlen bei Reisen, Zeitzonenänderungen oder Sommerzeit genau zusammenfassen möchten, führen Sie keine clientseitigen Berechnungen der Dauer durch. Fragen Sie stattdessen den Endpunkt dailyRollUp ab, der Lücken in den physischen Daten automatisch mit den UTC-Offsets ausgleicht. Die Zusammenfassung gibt einen StepsRollupValue mit dem Feld countSum zurück, das die Gesamtzahl der Schritte für den angeforderten Tag darstellt.

Benutzeroberflächen zeichnen (Abgleich)

Verwenden Sie den Endpunkt reconcile, wenn Sie Benutzeroberflächenelemente zum Anzeigen von Schrittdaten erstellen. Wenn mehrere Datenquellen (z. B. eine Smartwatch und ein Mobiltelefon) gleichzeitig Schritte aufgezeichnet haben, löst der Endpunkt reconcile Konflikte und führt die Streams zusammen, um einen einzelnen, abgeglichenen Datenstream zurückzugeben.

Intraday-Tracking und Histogramme

So zeigen Sie detaillierte Nutzeraktivitäten im Laufe des Tages an (z. B. Diagramme):

  • Stündliche Schritt-Histogramme:Fragen Sie den Endpunkt rollUp ab und geben Sie die Dauer mit dem Parameter windowSize an (z.B. 3600s für 1 Stunde).
  • Alle Schrittdatensätze:Verwenden Sie den Endpunkt list, um die detailliertesten Rohdatensätze für Schritte abzurufen.

Sowohl der Endpunkt rollUp als auch der Endpunkt reconcile akzeptieren den Abfrageparameter dataSourceFamily, mit dem Sie Daten aus bestimmten Quellgruppen filtern können.

Echtzeitsynchronisierung mit Webhooks

Abonnieren Sie die Datentypsammlung steps, um in Echtzeit benachrichtigt zu werden, wenn neue Schrittdaten importiert oder synchronisiert werden. Anstatt REST-Endpunkte abzufragen, aktualisieren Sie clientseitige Dashboards dynamisch als Reaktion auf diese Webhook-Benachrichtigungen. Weitere Informationen zum Einrichten von Abos finden Sie unter Webhook-Abos.

„Echte Nullen“ verarbeiten

Die Google Health API implementiert „Echte Nullen“, um Intervalle ohne Aktivität aufzulösen. Wenn ein Nutzer aktiv ist oder einen Tracker trägt, aber nicht geht, schreibt der Tracker explizite Schrittintervalle mit einem count von "0". So können Sie zwischen Zeiträumen unterscheiden, in denen ein Nutzer keine Schritte gemacht hat, während er das Gerät getragen hat, und Zeiträumen, in denen er es gar nicht getragen hat. Weitere Informationen finden Sie im Leitfaden zur Datenpräsenz und zu „Echten Nullen“ für mehr Details.

Zurück
Ernährung