Cara Merekam Latihan Fisik

Dokumen ini menjelaskan cara merekam olahraga menggunakan Fitness REST API.

Langkah 1: Siapkan project

Anda perlu menyiapkan project di Konsol API Google dan mengaktifkan akses ke Fitness REST API, seperti yang dijelaskan dalam Memulai.

Langkah 2: Lakukan autentikasi aplikasi Anda

Aplikasi Anda perlu mengautentikasi permintaan ke Fitness API menggunakan token akses. Untuk mendapatkan token akses, aplikasi Anda menyertakan kredensial khusus klien dan cakupan akses, seperti yang dijelaskan dalam Meminta Otorisasi.

Langkah 3: Buat sumber data

Sumber data mewakili sumber data sensor dari jenis tertentu. Semua data yang disisipkan ke fitness store harus dikaitkan dengan sumber data. Anda dapat membuat sumber data sekali dan menggunakannya kembali untuk sesi berikutnya.

Untuk membuat sumber data, kirim permintaan HTTP yang diautentikasi dengan parameter berikut:

Metode HTTP
SESUDAH
Resource

https://www.googleapis.com/fitness/v1/users/me/dataSources

ID pengguna me mengacu pada pengguna yang token aksesnya mengizinkan permintaan.

Isi permintaan
{
"name": "example-fit-heart-rate",
"dataStreamId":
    "raw:com.google.heart_rate.bpm:1234567890:Example Fit:example-fit-hrm-1:123456",
"dataType": {
    "field": [{
        "name": "bpm",
        "format": "floatPoint"
    }],
    "name": "com.google.heart_rate.bpm"
},
"application": {
    "packageName": "com.example.fit.someapp",
    "version": "1.0"
},
"device": {
    "model": "example-fit-hrm-1",
    "version": "1",
    "type": "watch",
    "uid": "123456",
    "manufacturer":"Example Fit"
},
"type": "raw"
}

Permintaan ini membuat sumber data yang mewakili monitor detak jantung yang memberikan data kebugaran jenis com.google.heart_rate.bpm. Anda harus menentukan ID sumber data, dan nilainya dapat berupa nilai apa pun. ID sumber data dalam contoh ini mengikuti konvensi penamaan yang wajar yang dapat Anda adopsi. Komponen perangkat bersifat opsional jika data hanya dihasilkan oleh aplikasi.

Jika permintaan berhasil, responsnya adalah kode status 200 OK.

Untuk informasi selengkapnya tentang sumber data, lihat referensi API untuk Referensi Users.dataSources.

Langkah 4: Tambahkan titik data

Anda menggunakan set data untuk menyisipkan titik data di penyimpanan kebugaran. Set data adalah kumpulan titik data dari satu sumber data yang dibatasi oleh waktu.

Untuk membuat set data dan menambahkan titik, kirim permintaan HTTP yang diautentikasi dengan parameter:

Metode HTTP
PATCH
Resource

https://www.googleapis.com/fitness/v1/users/me/dataSources/
raw:com.google.heart_rate.bpm:1234567890:Example%20Fit:example-fit-hrm-1:123456/datasets/1411053997000000000-1411057556000000000

URL mencakup ID sumber data serta waktu mulai dan berakhir set data dalam nanodetik.

Isi permintaan
{
"minStartTimeNs": 1411053997000000000,
"maxEndTimeNs": 1411057556000000000,
"dataSourceId":
  "raw:com.google.heart_rate.bpm:1234567890:Example Fit:example-fit-hrm-1:123456",
"point": [
{
  "startTimeNanos": 1411053997000000000,
  "endTimeNanos": 1411053997000000000,
  "dataTypeName": "com.google.heart_rate.bpm",
  "value": [
    {
      "fpVal": 78.8
    }
  ]
},
{
  "startTimeNanos": 1411055000000000000,
  "endTimeNanos": 1411055000000000000,
  "dataTypeName": "com.google.heart_rate.bpm",
  "value": [
    {
      "fpVal": 89.1
    }
  ]
},
{
  "startTimeNanos": 1411057556000000000,
  "endTimeNanos": 1411057556000000000,
  "dataTypeName": "com.google.heart_rate.bpm",
  "value": [
    {
      "fpVal": 62.45
    }
  ]
}
]
}

Permintaan ini membuat set data dengan tiga titik data detak jantung dalam satu jam untuk sumber data di langkah sebelumnya.

Jika permintaan berhasil, responsnya adalah kode status 200 OK.

Untuk informasi selengkapnya tentang set data, lihat referensi API untuk resource Users.dataSources.datasets.

Buat stempel waktu yang valid

Stempel waktu dalam contoh di atas dalam nanodetik. Untuk membuat stempel waktu yang valid, Anda dapat menggunakan skrip Python berikut:

from datetime import datetime, timedelta
import calendar

def date_to_nano(ts):
    """
    Takes a datetime object and returns POSIX UTC in nanoseconds
    """
    return calendar.timegm(ts.utctimetuple()) * int(1e9)

if __name__ == '__main__':
    print 'Current time is %d' % date_to_nano(datetime.now())
    print 'Time 1 hour ago was %d' % date_to_nano(datetime.now() +
       timedelta(hours=-1))

Langkah 5: Buat sesi

Setelah menyisipkan data ke penyimpanan kebugaran, Anda dapat menyisipkan sesi untuk memberikan metadata tambahan untuk olahraga ini. Sesi mewakili interval waktu saat pengguna melakukan aktivitas kebugaran.

Untuk membuat sesi olahraga ini, kirim permintaan HTTP terautentikasi dengan parameter berikut:

Metode HTTP
PUT
Resource

https://www.googleapis.com/fitness/v1/users/me/sessions/sessionId

sessionId bersifat arbitrer dan harus unik untuk semua sesi yang terkait dengan pengguna yang diautentikasi.

Isi permintaan
{
"id": "example-fit-1411053997",
"name": "Example Fit Run on Sunday Afternoon",
"description": "Example Fit Running Session",
"startTimeMillis": 1411053997000,
"endTimeMillis": 1411057556000,
"application": {
"name": "Foo Example App",
"version": "1.0"
},
"activityType": 8
}

Pilih nama sesi yang dapat dibaca manusia dan deskriptif, karena dapat digunakan oleh aplikasi lain untuk meringkas sesi. Waktu mulai dan berakhir sesi dalam milidetik (bukan nanodetik). Gunakan nama paket yang sama untuk sesi dan sumber data Anda; hal ini membuat data lebih konsisten dan memastikan bahwa atribusi data akan ditautkan kembali ke aplikasi Anda.

Interval waktu yang ditentukan dalam sesi ini mencakup data detak jantung yang disisipkan sebelumnya, sehingga Google Fit mengaitkan titik data tersebut dengan sesi ini.

Untuk informasi selengkapnya tentang sesi, lihat referensi API untuk Referensi Users.sessions.

Langkah 6: Buat segmen aktivitas

Segmen aktivitas membantu Anda mewakili berbagai aktivitas dalam sebuah sesi. Segmen aktivitas adalah segmen waktu yang mencakup satu aktivitas. Misalnya, jika pengguna menggunakan untuk lari satu jam, Anda dapat membuat segmen aktivitas jenis running (8) untuk dalam satu jam. Jika pengguna berlari selama 25 menit, beristirahat selama 5 menit, lalu berlari lagi selama setengah jam, Anda dapat membuat tiga segmen aktivitas berturut-turut dari jenis running, unknown, dan running.

Membuat segmen aktivitas sama dengan menambahkan titik data lainnya. Untuk membuat segmen aktivitas, buat sumber data segmen aktivitas terlebih dahulu, lalu buat set data dan tambahkan titik data segmen aktivitas ke dalamnya.

Contoh berikut membuat tiga segmen (berlari, istirahat, dan berlari) dalam jangka waktu yang sama sebagai pembacaan detak jantung, dengan asumsi Anda sudah membuat segmen aktivitas sumber data dan ID sumber data adalah "raw:com.google.activity.segment:1234567890:Example Fit:example-fit-hrm-1:123456":

Metode HTTP
PATCH
Resource
https://www.googleapis.com/fitness/v1/users/me/dataSources/
raw:com.google.activity.segment:1234567890/datasets/1411053997000000000-1411057556000000000
Isi permintaan
{
"minStartTimeNs": 1411053997000000000,
"maxEndTimeNs": 1411057556000000000,
"dataSourceId":
  "raw:com.google.activity.segment:1234567890",
"point": [
{
  "startTimeNanos": 1411053997000000000,
  "endTimeNanos": 1411053997000000000,
  "dataTypeName": "com.google.activity.segment",
  "value": [
    {
      "intVal": 8
    }
  ]
},
{
  "startTimeNanos": 1411055000000000000,
  "endTimeNanos": 1411055000000000000,
  "dataTypeName": "com.google.activity.segment",
  "value": [
    {
      "intVal": 4
    }
  ]
},
{
  "startTimeNanos": 1411057556000000000,
  "endTimeNanos": 1411057556000000000,
  "dataTypeName": "com.google.activity.segment",
  "value": [
    {
      "intVal": 8
    }
  ]
}
]
}

Titik data segmen aktivitas ini ditambahkan ke sumber data yang telah dibuat secara khusus untuk menangani segmen aktivitas. Anda dapat membuat sumber data baru untuk setiap kumpulan segmen, tetapi Anda harus menggunakan kembali sumber data yang didedikasikan untuk jenis sesi tertentu, seperti berlari.

Sesi menentukan jenis aktivitas, yang harus cocok dengan keseluruhan aktivitas yang dilakukan pengguna. Meskipun pengguna beristirahat saat berlari, keseluruhan olahraga masih berupa lari. Secara umum, jenis aktivitas untuk sesi akan cocok dengan jenis segmen aktivitas yang dominan.

Gunakan jenis aktivitas tidak diketahui (4) untuk menunjukkan bahwa pengguna sedang beristirahat, karena Anda mungkin tidak mengetahui apa yang dilakukan pengguna: mereka mungkin diam, atau melakukan peregangan, minum air, dan sebagainya. Jika Anda mengetahui bahwa pengguna tidak bergerak, Anda dapat menggunakan still (3).

Untuk mengetahui daftar mendetail jenis aktivitas, lihat Jenis Aktivitas.

Ringkasan

Dalam tutorial ini, Anda membuat sumber data untuk jenis data dan segmen aktivitas; Anda sisipkan {i>data point<i} ke dalam toko kebugaran; Anda membuat segmen aktivitas untuk mewakili berbagai aktivitas yang terjadi selama latihan fisik; dan Anda memasukkan sesi yang mencakup seluruh latihan fisik.

Google Fit mengaitkan data yang Anda masukkan dan data lain yang tersedia untuk interval waktu tersebut dengan sesi yang mewakili latihan fisik pengguna.