รูปแบบการส่งออก JSON

เอกสารครบถ้วนสำหรับโครงสร้างรูปแบบการส่งออก JSON

Last updated: April 5, 2026

ในหน้านี้

ภาพรวมรูปแบบการส่งออก JSON

เมื่อคุณส่งออกข้อมูลสุขภาพในรูปแบบ JSON ข้อมูลทั้งหมดจะอยู่ในไฟล์เดียวตามโครงสร้างที่นำเข้าฐานข้อมูล วิเคราะห์ด้วยโปรแกรม หรือเชื่อมต่อกับแอปพลิเคชันอื่นได้ง่าย

โครงสร้างไฟล์

ข้อมูลที่ส่งออกทั้งหมดอยู่ภายในอ็อบเจ็กต์ data ซึ่งมีอาร์เรย์สำหรับแต่ละประเภทข้อมูลที่รองรับ:

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

ประเภทข้อมูล

รูปแบบการส่งออก JSON รองรับประเภทข้อมูลดังนี้:

ตัวชี้วัดสุขภาพ (metrics)

อาร์เรย์ที่มีข้อมูลตัวชี้วัดสุขภาพทั้งหมด เช่น จำนวนก้าว อัตราการเต้นของหัวใจ ความดันโลหิต การนอน และอื่น ๆ แต่ละตัวชี้วัดมีโครงสร้างร่วมกัน ประกอบด้วยชื่อตัวชี้วัด หน่วย และอาร์เรย์ของจุดข้อมูล

เรียนรู้เพิ่มเติม: เอกสารตัวชี้วัดสุขภาพ

การออกกำลังกาย (workouts)

อาร์เรย์ที่มีเซสชันการออกกำลังกายทั้งหมด รวมถึงประเภทกิจกรรม ระยะเวลา ระยะทาง แคลอรี่ที่เผาผลาญ ข้อมูลอัตราการเต้นของหัวใจ และเส้นทาง (ถ้ามี)

เรียนรู้เพิ่มเติม: เอกสารการออกกำลังกาย

สภาวะทางจิตใจ (stateOfMind)

อาร์เรย์ที่มีรายการอารมณ์และสภาวะจิตใจ รวมถึงคะแนน valence ป้ายกำกับ และความเชื่อมโยง

เรียนรู้เพิ่มเติม: เอกสารสภาวะทางจิตใจ

ยา (medications)

อาร์เรย์ที่มีบันทึกยา รวมถึงชื่อยา ขนาดยา เวลาที่กำหนด และข้อมูลการปฏิบัติตามการรับประทาน

เรียนรู้เพิ่มเติม: เอกสารยา

อาการ (symptoms)

อาร์เรย์ที่มีรายการอาการ พร้อมเวลาเริ่มและสิ้นสุด ความรุนแรง และแหล่งที่มา

เรียนรู้เพิ่มเติม: เอกสารอาการ

การติดตามรอบเดือน (cycleTracking)

อาร์เรย์ที่มีข้อมูลรอบเดือน รวมถึงปริมาณเลือด คุณภาพของเมือกปากมดลูก อุณหภูมิร่างกายพื้นฐาน และผลการทดสอบการตกไข่

เรียนรู้เพิ่มเติม: เอกสารการติดตามรอบเดือน

ECG (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. เลือก Export Version 2 สำหรับโครงสร้างข้อมูลล่าสุด (แนะนำ)
  4. อ่านเอกสาร แต่ละประเภทข้อมูลเพื่อเข้าใจโครงสร้าง

เอกสารที่เกี่ยวข้อง