헬스 커넥트 플랫폼은 주로 웰빙 및 피트니스 사용 사례를 다루는 다양한 데이터 유형을 제공하므로 Android 생태계의 앱이 고비용 일대일 API 통합 없이 데이터를 공유할 수 있습니다. 개인 건강 기록 (PHR)은 이 기능을 확장하여 다음과 같은 Fast Healthcare Interoperability Resources (FHIR®) 형식의 기본 의료 데이터를 포함합니다.
- 의료 데이터를 작성하는 애플리케이션을 위한 API입니다.
- 다운스트림 읽기를 허용하는 세분화된 권한과 함께 헬스 커넥트에 새 의료 데이터 유형으로 저장된 의료 데이터를 위한 사용자 대상 브라우저 환경입니다.
- 사용자가 부여한 권한을 기반으로 의료 데이터를 읽는 애플리케이션용 API입니다.
PHR API는 Android 16 SDK를 통해 제공됩니다. 시작에 관한 안내는 Android 16 SDK 설정을 참고하세요.
제한사항
이러한 API는 아직 개발 중이므로 몇 가지 제한사항이 있으며 일부 구성요소는 완전히 사용할 수 없습니다.
- 헬스 커넥트 Jetpack SDK는 일반적으로 헬스 커넥트 API를 래핑하여 통합을 간소화하는 데 사용되지만 아직 사용할 수 없으므로 기본 Android 프레임워크 API를 사용해야 합니다.
- PHR 액세스에 대한 Play 정책은 아직 개발 중이며 앱을 Play 스토어에 출시하기 전에 추가 요구사항을 충족해야 할 수 있습니다.
- 변경 로그 기반 API와 같은 일부 기능은 아직 PHR API용으로 개발되지 않았습니다.
PHR 데이터 형식
PHR 데이터는 HL7 FHIR 형식으로 저장되며 처음에는 버전 R4만 지원합니다.
데이터 검증
PHR API는 유효한 R4 FHIR 리소스를 수락하며, Health Connect는 FHIR R4 사양이 준수되는지 확인하기 위해 몇 가지 유효성 검사를 실행합니다.
출시 예정으로 표시된 유효성 검사는 아직 시행되지 않지만 향후 출시에서는 시행될 예정입니다. 향후 출시에서 문제가 발생하지 않도록 나열된 모든 유효성 검사에 따라 개발하는 것이 좋습니다.
| 등급 | 유효성 검사 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 유효한 JSON | 데이터가 JSON 형식을 준수합니다. | ||||||||
| 지원되는 FHIR | 작성 애플리케이션에서 선언한 FHIR 버전이 지원됩니다. 헬스 커넥트에서 지원하는 FHIR 버전은 다음과 같습니다.
|
||||||||
| 지원되는 FHIR | 리소스 인스턴스에 기록된 FHIR 리소스 유형이 지원됩니다. 헬스 커넥트에서 지원되는 FHIR 리소스 유형은 다음과 같습니다.
|
||||||||
| 고유한 리소스 ID | 리소스에 정규 표현식 요구사항을 충족하는 값이 있는 ID 필드가 있습니다. | ||||||||
| 고유한 리소스 ID | 리소스가 동일한 MedicalDataSource의 동일한 리소스 유형의 다른 FHIR 리소스와 ID를 공유하지 않습니다. |
||||||||
| 비즈니스 규칙 | 포함된 FHIR 리소스를 포함하지 않습니다. 포함된 리소스는 '상위' 리소스 내에 중첩된 FHIR 리소스입니다. 상위 리소스가 다른 리소스를 참조해야 하지만 시스템에 독립적으로 존재하는 독립형 리소스를 만들기에 충분한 정보가 없는 경우에 사용됩니다. |
||||||||
| 유효한 기본 FHIR | FHIR JSON의 최상위 필드는 지정된 리소스 유형의 FHIR 사양에 있습니다. | ||||||||
| 유효한 기본 FHIR | 최상위 필드에는 JSON null 값이 없습니다. | ||||||||
| 유효한 기본 FHIR | FHIR의 반복 요소로 정의된 최상위 필드에는 JSON array 데이터 유형이 있습니다. |
||||||||
| 유효한 기본 FHIR | FHIR에서 복잡한 유형으로 정의된 최상위 필드 (JSON array 내 요소 포함)에는 JSON object 데이터 유형이 있습니다. |
||||||||
| 유효한 기본 FHIR | FHIR에서 원시 유형으로 정의된 최상위 필드 (JSON array 내 요소 포함)에는 올바른 JSON 데이터 유형이 있습니다.
|
||||||||
| 유효한 기본 FHIR | FHIR에서 원시 유형으로 정의된 최상위 필드는 정규 표현식 요구사항을 충족합니다. 출시 예정 |
||||||||
| 유효한 기본 FHIR | 기본 유형 확장 프로그램은 FHIR 사양에 있으며 JSON object 데이터 유형을 사용합니다. |
||||||||
| 유효한 기본 FHIR | 선택 필드(fieldname[x])에는 하나 이상의 필드가 기록되지 않습니다.예를 들어 effectiveDateTime와 effectivePeriod가 모두 동일한 리소스 인스턴스에 있을 수는 없습니다. |
||||||||
| 유효한 기본 FHIR | 복잡한 데이터 유형에는 FHIR 사양과 일치하는 필드와 데이터 유형이 포함됩니다. 출시 예정 |
||||||||
| 유효한 기본 FHIR | 백본 요소 (및 복합 유형 내 요소)에는 FHIR 사양과 일치하는 필드와 데이터 유형이 포함됩니다. 출시 예정 |
||||||||
| 유효한 기본 FHIR | 확장 프로그램 요소
value[x] 필드는 유효한 유형이며 해당 데이터 유형에 따라 콘텐츠를 포함합니다.확장 프로그램 요소는 기본 사양에 포함되지 않은 추가 정보를 나타내기 위해 모든 리소스에 포함될 수 있습니다. 확장 프로그램의 정의에 연결되는 필드 url와 확장 프로그램 값을 포함하는 필드 value[x]가 포함됩니다.
value[x]는 허용되는 데이터 유형의 설정된 목록에 있어야 합니다.
출시 예정 |
||||||||
| 유효한 기본 FHIR | 최상위 필수 입력란이 모두 있습니다. |
데이터 카테고리
지원되는 FHIR 리소스 및 해당 카테고리는 대략 국제 환자 요약 섹션을 기반으로 합니다.
- 알레르기 과민증 카테고리: AllergyIntolerance 리소스가 포함됩니다.
- 조건 카테고리: 조건 리소스가 포함됩니다.
- 방문 카테고리: 만남, 위치, 조직 리소스가 포함됩니다.
- 백신 카테고리: 예방접종 리소스가 포함되어 있습니다.
- 개인 세부정보 카테고리: 환자 리소스가 포함됩니다.
- 의료인 세부정보 카테고리: Practitioner, PractitionerRole 리소스가 포함되어 있습니다.
- 절차 카테고리 - 절차 리소스가 포함됩니다.
- 의약품 카테고리: Medication, MedicationRequest, MedicationStatement 리소스가 포함됩니다.
관찰 리소스는 콘텐츠에 따라 분류됩니다.
- 임신: 임신 LOINC 코드를 기반으로 합니다.
- 사회력: 사회력 LOINC 코드 또는 'social-history' FHIR 카테고리를 기반으로 합니다.
- Vital Signs: 생체 신호 LOINC 코드 또는 'vital-signs' FHIR 카테고리를 기반으로 합니다.
- 실험실: '실험실' FHIR 카테고리를 기반으로 합니다.
이러한 카테고리에 속하지 않는 관찰값은 헬스 커넥트에 기록되지 않습니다.
환자 리소스
헬스 커넥트는 현재 한 개인의 PHR 데이터만 저장하도록 설계되었습니다. 따라서 작성된 모든 FHIR 리소스는 동일한 사용자에게 속해야 합니다.
한 개인에 대해 시스템에 여러 FHIR 환자 리소스가 있는 것은 드문 일이 아닙니다. 데이터를 조정하고 헬스 커넥트에 단일 환자 리소스를 쓰는 앱을 작성하는 것이 좋습니다. 그러나 이는 존재할 수 있는 다양한 조직 구조를 수용하기 위해 시행되지는 않습니다.
변환된 FHIR 데이터
일부 앱은 자체 요구사항을 충족하기 위해 FHIR 데이터를 변환합니다. 예를 들면 다음과 같습니다.
- 다양한 소스 (일반적으로 FHIR API)의 데이터 병합
- 코드를 전 세계 용어 (예: SNOMED, LOINC, ICD)에 매핑하고 단위를 표준화합니다.
- 데이터 통합 및 중복 삭제
- 형식 지정 또는 기타 데이터 품질 문제를 해결합니다.
- 앱별 비즈니스 규칙에 따라 레코드 필터링
변환되지 않은 FHIR 데이터와 변환된 FHIR 데이터는 FHIR R4 사양을 준수하는 경우 헬스 커넥트에 쓸 수 있습니다. 가능하면 변환된 데이터를 쓰는 것이 좋습니다. 하지만 다음 사항에 유의하세요.
- 사용 사례가 좁은 앱은 생태계의 다른 앱에서 사용자 가치를 창출할 수 있는 상당수의 레코드를 필터링할 수 있습니다. 이러한 경우 더 완전한 변환되지 않은 FHIR를 작성하는 것이 좋습니다. 하지만 이 확장된 데이터 세트가 공유되고 있음을 사용자에게 알려야 합니다.
- 서로 다른 소스에서 가져온 데이터를 병합하는 경우 헬스 커넥트의 단일
MedicalDataSource에 데이터를 쓸 수 있습니다. 충돌을 방지하기 위해 각 리소스에 새 ID를 할당하고 새 ID를 가리키도록 리소스 참조를 업데이트해야 합니다. - 여러 소스의 데이터를 단일
MedicalDataSource로 병합하면 데이터 출처가 숨겨질 수 있습니다. 데이터 소비자가 데이터 출처를 파악하는 것이 종종 유용하므로 각 리소스의meta.source필드를 레코드의 원본 소스 (일반적으로 FHIR 기본 URL)로 채우는 것이 좋습니다.
사용자 환경
이 섹션에서는 사용자 환경에 관한 일반적인 정보를 제공합니다.
권한
의료 기록 읽기 또는 쓰기 권한을 요청하는 작업은 기존 헬스 커넥트 권한 화면과 유사하지만 별도의 건강 기록 화면이 표시됩니다.
데이터 탐색
헬스 커넥트는 기존 헬스 커넥트 데이터 유형과 마찬가지로 저장된 PHR 데이터의 기본 시각화 및 탐색도 제공합니다.
