Cara Merekam Latihan Fisik

Dokumen ini menjelaskan cara mencatat latihan fisik 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: Autentikasikan 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 Mengotorisasi Permintaan.

Langkah 3: Buat sumber data

Sumber data mewakili sumber data sensor jenis tertentu. Semua data yang dimasukkan ke penyimpanan kebugaran harus dikaitkan dengan sumber data. Anda dapat membuat sumber data sekali dan menggunakannya kembali untuk sesi mendatang.

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

Metode HTTP
POSTING
Resource

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

ID pengguna me merujuk ke pengguna yang token aksesnyanya 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 menyediakan data kebugaran jenis com.google.heart_rate.bpm. Anda harus menentukan ID sumber data, dan itu dapat berupa nilai apa pun. ID sumber data dalam contoh ini mengikuti konvensi penamaan yang wajar yang dapat Anda gunakan. 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 resource 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 ke set data tersebut, kirimkan permintaan HTTP yang telah diautentikasi dengan parameter ini:

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 berisi 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 yang berisi tiga titik data detak jantung dalam waktu satu jam untuk sumber data pada 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.

Membuat stempel waktu yang valid

Stempel waktu pada contoh di atas ditampilkan 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 memasukkan data ke penyimpanan kebugaran, Anda dapat menyisipkan sesi untuk memberikan metadata tambahan untuk olahraga ini. Sesi menunjukkan interval waktu saat pengguna melakukan aktivitas kebugaran.

Untuk membuat sesi bagi latihan fisik ini, kirimkan permintaan HTTP yang diautentikasi 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 terautentikasi.

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 untuk sesi adalah dalam milidetik (bukan nanodetik). Gunakan nama paket yang sama untuk sesi dan sumber data Anda; 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 resource Users.sessions.

Langkah 6: Buat segmen aktivitas

Segmen aktivitas membantu Anda mewakili berbagai aktivitas dalam satu sesi. Segmen aktivitas adalah segmen waktu yang mencakup satu aktivitas. Misalnya, jika pengguna berlari selama satu jam, Anda dapat membuat segmen aktivitas jenis running (8) untuk seluruh jam. Jika pengguna berjalan selama 25 menit, beristirahat selama 5 menit, kemudian berjalan selama setengah jam lagi, 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, pertama-tama buat sumber data segmen aktivitas, lalu buat set data dan tambahkan titik data segmen aktivitas ke dalamnya.

Contoh berikut membuat tiga segmen (berjalan, istirahat, dan berjalan) dalam jangka waktu yang sama dengan pembacaan detak jantung, dengan asumsi Anda sudah membuat sumber data segmen aktivitas 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 sebaiknya gunakan kembali salah satu yang dikhususkan untuk jenis sesi tertentu, seperti berjalan.

Sesi yang menentukan jenis aktivitas, yang harus cocok dengan keseluruhan aktivitas pengguna. Meskipun pengguna sedang beristirahat saat berlari, latihan fisik secara keseluruhan tetap berjalan. Secara umum, jenis aktivitas untuk sesi ini akan cocok dengan jenis segmen aktivitas yang dominan.

Gunakan jenis aktivitas yang 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 mengetahui bahwa pengguna tidak berpindah, Anda dapat menggunakan masih (3).

Untuk daftar mendetail jenis aktivitas, lihat Jenis Aktivitas.

Ringkasan

Dalam tutorial ini, Anda membuat sumber data untuk jenis data dan segmen aktivitas; Anda menyisipkan titik data ke dalam penyimpanan kebugaran; Anda membuat segmen aktivitas untuk mewakili berbagai aktivitas yang berlangsung selama olahraga; dan Anda menyisipkan sesi yang mencakup seluruh olahraga.

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