病歷

「健康資料同步」平台提供多種資料類型,主要涵蓋健康與健身用途,讓 Android 生態系統中的應用程式分享資料,不必進行高成本的一對一 API 整合。

「醫療記錄」功能擴充了這項功能,可納入 Fast Healthcare Interoperability Resources (FHIR®) 格式的基本醫療資料。FHIR 是由 HL7 (健康照護層級七國際組織) 發布的開放原始碼全球規格,用於說明醫療資料的結構定義和語意。

「健康資料同步」的病歷功能:

  • 應用程式寫入醫療資料的 API。
  • 使用者可透過瀏覽器查看儲存在「健康資料同步」中的醫療資料 (以新的醫療資料類型呈現),並可設定細部權限,允許下游讀取資料。
  • 應用程式可透過 API 讀取使用者授權的醫療資料。
瞭解「健康記錄」如何與「健康資料同步」搭配運作。
圖 1. 瞭解「健康資料同步」如何與「病歷」搭配運作。

限制

由於這些 API 仍在開發階段,因此仍有一些限制,且部分元件尚未全面開放使用。

醫療記錄 API 標有 ExperimentalPersonalHealthRecordApi 註解,表示這些 API 仍在開發階段,隨時可能變更。

目前仍有一些限制,且部分元件尚未完全開放使用:

  • 我們仍在制定醫療記錄存取權的 Play 政策,應用程式可能需要符合其他規定,才能在 Play 商店發布。
  • 部分功能 (例如以變更記錄為基礎的 API) 尚未針對病歷 API 開發。

立即開始

由於「醫療記錄」是「健康資料同步」中的一組新記錄類型,因此「醫療記錄」的啟用程序與「健康資料同步」相同。詳情請參閱「開始使用『健康資料同步』」。

如果您曾試用最初提供的病歷架構 API,我們強烈建議您改用 Jetpack,以獲得更優質的開發人員體驗,原因如下:

  • 所有指南和程式碼範例都是為 Jetpack 編寫
  • 生態系統工具使用 Jetpack API
  • API 介面為 Kotlin 原生介面
  • Jetpack 改善了相容性支援 (例如 Feature Availability API)

您可透過 Jetpack 中的 Health Connect 1.1.0-beta02 版使用病歷 API。如要將 Jetpack 依附元件更新至這個版本,應用程式必須針對 Android 16 SDK 進行編譯。

設定完成後,您就可以在應用程式中寫入及讀取病歷資料,詳情請參閱「寫入醫療資料」和「讀取醫療資料」。

使用者體驗

這個部分提供使用者體驗的一般資訊。

權限

要求讀取或寫入醫療記錄權限的行為與現有的「健康資料同步」權限畫面類似,但系統會顯示獨立的健康記錄畫面:

醫療記錄權限畫面
圖 2:醫療記錄權限畫面

瀏覽資料

此外,Health Connect 也提供醫療記錄資料的基本視覺化和瀏覽功能,與現有的 Health Connect 資料類型類似。

醫療記錄的資料瀏覽畫面
圖 3:醫療記錄資料瀏覽畫面