個人健康記錄

Health Connect 平台提供各種資料類型，主要涵蓋身心健康和健身用例，讓 Android 生態系統中的應用程式能夠分享資料，而無需進行高成本的一對一 API 整合作業。個人健康記錄 (PHR) 可擴充這項功能，納入 快速醫療照護互通資源 (FHIR®) 格式的基本醫療資料，包括：

  • 用於寫入醫療資料的應用程式 API。
  • 針對儲存在 Health Connect 中以新醫療資料類型形式儲存的醫療資料，提供使用者面向瀏覽器的體驗，以及允許下游讀取的細微權限。
  • 應用程式可根據使用者授予的權限，讀取醫療資料的 API。
概略說明個人健康記錄如何與 Health Connect 搭配運作。
圖 1. 個人健康記錄與 Health Connect 的運作方式。

個人健康記錄 API 可透過 Android 16 SDK 取得。如需入門操作說明，請參閱「設定 Android 16 SDK」。

限制

由於這些 API 仍在開發中，因此仍有部分限制，且無法完全使用某些元件。

  • Health Connect Jetpack SDK 通常用於透過包裝 Health Connect API 來簡化整合作業，但這些 API 尚未推出，因此必須使用底層 Android 架構 API。
  • 個人健康記錄存取權的 Play 政策仍在開發中，應用程式可能需要符合額外規定，才能在 Play 商店發布。
  • 部分功能 (例如以變更記錄為基礎的 API) 尚未針對 PHR API 開發。

個人健康記錄資料格式

個人健康記錄資料會以 HL7 FHIR 格式儲存，一開始僅支援 R4 版本。

資料驗證

PHR API 會接受有效的 R4 FHIR 資源，Health Connect 會執行一些驗證作業，確保遵循 FHIR R4 規格。

標示為「即將推出」的驗證檢查項目尚未強制執行，但會在日後發布的版本中實施。建議您根據所有列出的驗證檢查項目進行開發，以免日後發生問題。

表 1：Health Connect 對 FHIR 資料的驗證
等級 驗證檢查
有效的 JSON 資料符合 JSON 格式。
支援的 FHIR

系統支援寫入應用程式宣告的 FHIR 版本。Health Connect 支援下列 FHIR 版本：

  • 4.0.1
  • 4.3.0
支援的 FHIR

支援在資源例項中記錄的 FHIR 資源類型。 Health Connect 支援下列 FHIR 資源類型：

  • 過敏/不耐症
  • Condition
  • Encounter
  • 免疫接種
  • 位置
  • 藥物
  • MedicationRequest
  • MedicationStatement
  • 觀察事項
  • 機構
  • 病患
  • 醫事人員
  • PractitionerRole
  • 流程
不重複的資源 ID 資源的 ID 欄位值符合規則運算式規定。
不重複的資源 ID 資源不會與相同 MedicalDataSource 中其他相同資源類型的 FHIR 資源共用 ID。
業務規則 不含包含的 FHIR 資源。

包含的資源是巢狀於「父項」資源中的 FHIR 資源。當父項資源需要參照其他資源，但系統沒有足夠的資訊來建立這個獨立資源時，就會使用這些資源。
有效的基礎 FHIR FHIR JSON 中的頂層欄位會出現在指定資源類型的 FHIR 規格中。
有效的基礎 FHIR 頂層欄位沒有 JSON 空值。
有效的基礎 FHIR 頂層欄位若定義為 FHIR 中的重複元素，則會採用 JSON array 資料類型。
有效的基礎 FHIR 在 FHIR 中，頂層欄位 (包括 JSON array 中的元素) 定義為複雜類型，則會具有 JSON object 資料類型。
有效的基礎 FHIR 在 FHIR 中，頂層欄位 (包括 JSON array 中的元素) 定義為原始類型，因此具有正確的 JSON 資料類型。

FHIR 資料類型 JSON 資料類型
integer、unsignedInt、positiveInt、decimal 號碼
布林值 布林值
即時、時間、日期、日期時間、字串、程式碼、Markdown、ID URI、網址、OID、UUID、標準、整數 64、Base64 二進位 號碼
即將推出
有效的基礎 FHIR 在 FHIR 中定義為原始類型的頂層欄位符合規則運算式規定。

即將推出
有效的基礎 FHIR FHIR 規格中提供基本類型的擴充功能，並具有 JSON object 資料類型。
有效的基礎 FHIR 選擇欄位 (fieldname[x]) 最多只能記錄一個欄位。

舉例來說，effectiveDateTime 和 effectivePeriod 不能同時出現在同一個資源執行個體中。
有效的基礎 FHIR 複雜資料類型包含符合 FHIR 規格的欄位和資料類型。

即將推出
有效的基礎 FHIR 主幹元素 (以及複雜類型中的元素) 包含與 FHIR 規格相符的欄位和資料類型。

即將推出
有效的基礎 FHIR Extensions 元素 value[x] 欄位是有效類型，並包含該資料類型的內容。

擴充功能元素可納入任何資源，用於代表不屬於基本規格的其他資訊。這些元素包含一個連結至擴充功能定義的欄位 url，以及包含擴充功能值的欄位 value[x]。value[x] 必須來自已接受的資料類型清單。

即將推出
有效的基礎 FHIR 頂層必填欄位都已填妥。

資料類別

支援的 FHIR 資源組合和對應類別大致根據國際病患摘要章節：

  • 過敏/不耐症類別：包含 AllergyIntolerance 資源。
  • 條件類別：包含條件資源。
  • 造訪類別：包含接觸、地點和機構資源。
  • 疫苗類別：包含免疫接種資源。
  • 個人資料類別：包含病患資源。
  • 醫事人員詳細資料類別：包含醫事人員和醫事人員角色資源。
  • 程序類別：包含程序資源。
  • 藥物類別：包含 Medication、MedicationRequest、MedicationStatement 資源。

觀察資源會根據內容分類：

  • 懷孕 - 根據懷孕 LOINC 代碼。
  • 社交活動記錄：根據社交活動記錄 LOINC 代碼或「social-history」FHIR 類別。
  • 生命徵象：根據生命徵象 LOINC 代碼或「vital-signs」FHIR 類別。
  • 實驗室：根據 FHIR 類別「實驗室」。

不屬於上述任何類別的觀察值不會寫入 Health Connect。

病患資源

Health Connect 目前只會儲存單一使用者的個人健康記錄資料。因此，所有 FHIR 資源都應屬於同一個使用者。

在單一系統中，為單一個人提供多個 FHIR 病患資源並不少見。我們建議您編寫應用程式，以便協調資料並將單一病患資源寫入 Health Connect。不過，這並未強制執行，以便因應可能存在的不同組織架構。

已轉換的 FHIR 資料

部分應用程式會轉換 FHIR 資料，以符合自身需求。例如：

  • 合併來自不同來源的資料 (通常是 FHIR API)。
  • 將代碼對應至全球術語 (例如 SNOMED、LOINC、ICD)，並標準化單位。
  • 整合和去除重複資料。
  • 修正格式或其他資料品質問題。
  • 根據應用程式專屬的業務規則篩選記錄。

只要符合 FHIR R4 規格，未經轉換和經過轉換的 FHIR 資料都可以寫入 Health Connect。建議您盡可能寫入轉換後的資料。但請注意下列考量事項：

  • 應用程式如果用途狹隘，可能會篩除大量記錄，而這些記錄是生態系統中其他應用程式可為使用者創造價值的來源。在這種情況下，編寫未轉換的 FHIR 可能會更完整。不過，請務必告知使用者您要分享這項更廣泛的資料集。
  • 如果要合併來自不同來源的資料，您可以將資料寫入 Health Connect 中的單一 MedicalDataSource。您也必須為每個資源指派新的 ID，以免發生衝突，並更新資源參照，指向新的 ID。
  • 將來自多個來源的資料合併至單一 MedicalDataSource 可能會掩蓋資料來源。資料使用者通常需要瞭解資料來源，因此建議您為每個資源的 meta.source 欄位填入記錄的原始來源 (通常為 FHIR 基礎網址)。

使用者體驗

本節提供使用者體驗的一般資訊。

權限

要求讀取或寫入醫療記錄權限的行為與現有的 Health Connect 權限畫面類似，但會顯示獨立的健康記錄畫面：

權限

資料瀏覽

Health Connect 也提供基本可視化功能，可瀏覽儲存的個人健康記錄資料，類似現有的 Health Connect 資料類型。

瀏覽