Google Fit 是開放的生態系統。這項工具可讓開發人員將健康與保健資料上傳至中央存放區,讓使用者在單一位置存取來自不同裝置和應用程式的資料。即使使用者升級至新裝置,也能存取自己的資料。
健康與保健應用程式可以儲存任何穿戴式裝置或感應器的資料,以及存取其他應用程式建立的資料。
請詳閱《Google Fit 開發人員與使用者資料政策》全文,確認應用程式符合相關規定。使用 Google Fit 前,請詳閱《Google Fit 條款及細則》。使用 API 即表示您同意 Google Fit 條款及細則。
元件
Google Fit 是由下列元件組成:
- 健身商店
- 儲存各種裝置和應用程式資料的中央存放區。這項產品是對客戶公開透明的雲端服務。
- 感應器架構
- 這組高階表示法可讓你輕鬆使用健身商店。這些表示法可搭配 Google Fit API 使用。
- 權限和使用者控制項
- 一組授權範圍,用於要求使用者授權以處理健康與保健資料。Google Fit 必須取得使用者同意,才能存取健康與保健資料。
- Google Fit API
- 使用 Android 和 REST API 存取健身商店。您可以在多個平台和裝置 (例如 Android、iOS 和網頁應用程式) 上建立支援 Google Fit 的應用程式。
健身商店
健身商店是一項雲端服務,會使用 Google 的基礎架構保留健康與保健資料。不同平台和裝置上的應用程式可以儲存資料,以及存取其他應用程式建立的資料。Google Fit 提供一組 API,可讓您輕鬆插入資料及查詢健身商店。
感應器架構
感應器架構定義了感應器、資料類型、資料點和工作階段的高階表示法。透過這些表示法,您可以輕鬆在任何平台上使用健身商店。
- 資料來源
- 資料來源代表感應器,包含名稱、收集的資料類型和其他感應器詳細資料。資料來源可能代表硬體感應器或軟體感應器。您可以定義應用程式中的軟體感應器。
- 資料類型
- 資料類型代表不同類型的健康與保健資料,例如步數或心率。資料類型建立結構定義,讓不同應用程式瞭解彼此的資料。資料類型包含名稱和欄位的排序清單,其中每個欄位都代表一個維度。例如,位置的資料類型包含三個欄位 (緯度、經度和精確度),而權重的資料類型則只包含一個欄位。
- 資料點
- 資料點是由資料類型的值加上時間戳記的陣列所組成,並從資料來源讀取。您可以使用資料點在健身儲存庫中記錄及插入健康與保健資料,以及從資料來源讀取原始資料。包含開始時間的點代表時間範圍,而不是立即讀取。
- 資料集
- 資料集代表一組來自特定資料來源的一組同類型資料點,範圍涵蓋一段時間間隔。您可以使用資料集將資料插入健身商店。從健身商店讀取資料的查詢也會傳回資料集。
- 工作階段
- 工作階段是指使用者進行健身活動的時段,例如跑步、騎單車等。時段有助於整理資料,並在健身商店上針對健身活動執行詳細或匯總查詢。
權限和使用者控制項
Google Fit 需要取得使用者同意,才能讀取或儲存健康與保健資料。 Google Fit 定義了對應至多個權限群組的 OAuth 範圍,並具備不同的讀取和寫入權限:活動、身體、位置、營養和健康相關資料類型 (健康相關資料類型會以精細程度分組)。每個權限群組都會授予應用程式一組資料類型的存取權。應用程式可指定其中一或多個範圍來處理健康與保健資料,而 Google Fit 會要求使用者提供對應的權限。
Google Fit API
Google Fit 提供下列 API:
- Android 應用程式適用的 Android API。
- REST API 適用於任何平台上的應用程式。