JSON 내보내기 형식 개요

건강 데이터를 JSON 형식으로 내보낼 때 모든 데이터는 데이터베이스로 가져오기, 프로그래밍 방식으로 분석하거나 다른 애플리케이션과 통합하기 쉽도록 구조화된 형식으로 단일 파일에 구성됩니다.

파일 구조

내보낸 모든 데이터는 지원되는 각 데이터 유형에 대한 배열을 포함하는 data 객체 내에 포함됩니다:

{
  "data": {
    "metrics": [],
    "workouts": [],
    "stateOfMind": [],
    "medications": [],
    "symptoms": [],
    "cycleTracking": [],
    "ecg": [],
    "heartRateNotifications": []
  }
}

데이터 유형

JSON 내보내기 형식은 다음 데이터 유형을 지원합니다:

건강 지표 (metrics)

걸음 수, 심박수, 혈압, 수면 등 모든 건강 지표 데이터를 포함하는 배열. 각 지표는 지표 이름, 단위 및 데이터 포인트 배열을 포함하는 공통 구조를 따릅니다.

자세히 알아보기: 건강 지표 문서

운동 (workouts)

활동 유형, 지속 시간, 거리, 소모 칼로리, 심박수 데이터 및 경로 정보(사용 가능한 경우)를 포함하여 모든 운동 세션을 포함하는 배열.

자세히 알아보기: 운동 문서

심리 상태 (stateOfMind)

가치 평가, 레이블 및 연결을 포함하여 기분 및 정신 상태 항목을 포함하는 배열.

자세히 알아보기: 심리 상태 문서

약물 (medications)

약물 이름, 용량, 예정된 시간 및 순응 정보를 포함하여 약물 기록을 포함하는 배열.

자세히 알아보기: 약물 문서

증상 (symptoms)

시작 및 종료 시간, 심각도 및 소스 정보가 있는 증상 항목을 포함하는 배열.

자세히 알아보기: 증상 문서

주기 추적 (cycleTracking)

유량, 자궁경부 점액 품질, 기저 체온 및 배란 테스트 결과를 포함하여 월경 주기 데이터를 포함하는 배열.

자세히 알아보기: 주기 추적 문서

심전도 (ecg)

분류, 심박수 측정 및 전압 데이터를 포함하여 호환 가능한 장치의 심전도(ECG) 판독값을 포함하는 배열.

자세히 알아보기: 심전도 문서

심박수 알림 (heartRateNotifications)

임계값 및 이벤트 중 상세한 심박수 측정을 포함하여 높은 심박수 및 낮은 심박수 알림 이벤트를 포함하는 배열.

자세히 알아보기: 심박수 알림 문서

날짜 형식

JSON 내보내기의 모든 날짜는 다음 형식을 사용합니다:

• 형식: yyyy-MM-dd HH:mm:ss Z
• 예: 2024-02-06 14:30:00 -0800

이 형식은 다음을 포함합니다:

• 날짜(년-월-일)
• 시간(24시간 형식: 시:분:초)
• 시간대 오프셋

JSON 형식을 사용하는 이유

JSON 형식은 다음에 이상적입니다:

• 데이터베이스 저장 - PostgreSQL, MySQL 또는 MongoDB와 같은 데이터베이스로 가져오기 쉬움
• 데이터 분석 - 데이터 분석 도구 및 프로그래밍 언어와 호환 가능
• 애플리케이션 통합 - 사용자 정의 애플리케이션에서 구문 분석하고 사용하기 간단
• 상세한 데이터 - 수면 단계 및 ECG 판독값과 같은 데이터 유형에 대한 복잡한 중첩 구조를 보존

시작하기

1. 수동 내보내기를 사용하여 데이터를 내보내거나 자동화를 설정합니다
2. 내보내기를 구성할 때 JSON 형식을 선택합니다
3. 가장 최신 데이터 구조에는 내보내기 버전 2를 선택합니다(권장)
4. 구조를 이해하기 위해 각 데이터 유형에 대한 문서를 검토합니다

관련 문서

• 수동 내보내기 가이드 - 데이터를 내보내는 방법 알아보기
• 자동화 개요 - 자동화된 내보내기 설정
• 개별 데이터 유형 문서(위에 링크됨)