Prehľad formátu exportu JSON

Keď exportujete zdravotné údaje vo formáte JSON, všetky údaje sú usporiadané v jednom súbore so štruktúrou, ktorá uľahčuje import do databáz, programovú analýzu alebo integráciu s inými aplikáciami.

Štruktúra súboru

Všetky exportované údaje sú v objekte data, ktorý obsahuje polia pre každý podporovaný typ údajov:

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

Typy údajov

Formát JSON exportu podporuje tieto typy údajov:

Zdravotné metriky (metrics)

Pole so všetkými zdravotnými metrikami, napríklad počtom krokov, srdcovou frekvenciou, krvným tlakom, spánkom a ďalšími. Každá metrika má spoločnú štruktúru s názvom metriky, jednotkami a poľom dátových bodov.

Ďalšie informácie: Dokumentácia zdravotných metrík

Tréningy (workouts)

Pole so všetkými tréningmi vrátane typu aktivity, trvania, vzdialenosti, spálených kalórií, údajov o srdcovej frekvencii a informácií o trase (ak sú k dispozícii).

Ďalšie informácie: Dokumentácia tréningov

Stav mysle (stateOfMind)

Pole so záznammi nálady a duševného stavu vrátane hodnotení valencie, štítkov a asociácií.

Ďalšie informácie: Dokumentácia stavu mysle

Lieky (medications)

Pole so záznammi o liekoch vrátane názvov liekov, dávkovania, plánovaných časov a informácií o dodržiavaní.

Ďalšie informácie: Dokumentácia liekov

Príznaky (symptoms)

Pole so záznamami príznakov s časom začiatku a konca, závažnosťou a informáciami o zdroji.

Ďalšie informácie: Dokumentácia príznakov

Sledovanie cyklu (cycleTracking)

Pole s údajmi o menštruačnom cykle vrátane menštruačného toku, kvality krčkového hlienu, bazálnej telesnej teploty a výsledkov testov ovulácie.

Ďalšie informácie: Dokumentácia sledovania cyklu

EKG (ecg)

Pole so záznamami elektrokardiogramu (EKG) z kompatibilných zariadení vrátane klasifikácií, meraní srdcovej frekvencie a údajov o napätí.

Ďalšie informácie: Dokumentácia EKG

Upozornenia na srdcovú frekvenciu (heartRateNotifications)

Pole s udalosťami upozornení na vysokú a nízku srdcovú frekvenciu vrátane prahov a podrobných meraní srdcovej frekvencie počas udalostí.

Ďalšie informácie: Dokumentácia upozornení na srdcovú frekvenciu

Formát dátumu

Všetky dátumy v JSON exporte používajú tento formát:

• Formát: yyyy-MM-dd HH:mm:ss Z
• Príklad: 2024-02-06 14:30:00 -0800

Tento formát zahŕňa:

• Dátum (rok-mesiac-deň)
• Čas (24-hodinový formát: hodiny:minúty:sekundy)
• Posun časového pásma

Prečo používať formát JSON?

Formát JSON je vhodný na:

• Ukladanie do databáz – jednoduchý import do databáz ako PostgreSQL, MySQL alebo MongoDB
• Analýzu údajov – kompatibilita s analytickými nástrojmi a programovacími jazykmi
• Integráciu aplikácií – jednoduché parsovanie a použitie vo vlastných aplikáciách
• Podrobné údaje – zachovanie zložitých vnorených štruktúr pre typy údajov ako fázy spánku a záznamy EKG

Začíname

1. Exportujte údaje pomocou manuálneho exportu alebo nastavte automatizáciu
2. Pri konfigurácii exportu zvoľte formát JSON
3. Zvoľte exportnú verziu 2 pre najaktuálnejšiu štruktúru údajov (odporúčané)
4. Preštudujte si dokumentáciu ku každému typu údajov, aby ste pochopili štruktúru

Súvisiaca dokumentácia

• Príručka manuálneho exportu – ako exportovať údaje
• Prehľad automatizácií – nastavenie automatických exportov
• Dokumentácia jednotlivých typov údajov (odkazy vyššie)