Health प्लैटफ़ॉर्म एपीआई

Health Platform API, एक Android एपीआई है. यह डेवलपर को इंटरफ़ेस, जिसमें उपयोगकर्ता की पिछली सेहत, तंदुरुस्ती, और स्वास्थ्य की जानकारी शेयर की जा सकती है. और फ़िटनेस डेटा शामिल करें. Health Platform की मदद से, उपयोगकर्ता अपने डेटा को कंट्रोल कर सकते हैं. लोग यह कंट्रोल करें कि किन ऐप्लिकेशन के पास अलग-अलग तरह के डेटा को पढ़ने या उसमें बदलाव करने का ऐक्सेस है. स् वास् थ् य प्लैटफ़ॉर्म एपीआई के डेटा टाइप में ऊंचाई, धड़कन की दर वगैरह शामिल हैं.

Health Platform API, उपयोगकर्ताओं को स्टोरेज और डेटा शेयर करने का ऐसा तरीका देता है जिससे वे यह चुनते हैं कि कौनसे ऐप्लिकेशन उनकी सेहत और फ़िटनेस को ऐक्सेस और दिखा सकते हैं. सेहत से जुड़ा डेटा शामिल है. इससे ऐप्लिकेशन डेवलपर, लोगों को ज़्यादा जानकारी दिखा पाते हैं उपयोगकर्ताओं का व्यू स्वास्थ्य और उपयोगकर्ताओं को अपने डेटा पर असरदार तरीके से नज़र रखने में मदद करता है.

Health Platform API की सॉफ़्टवेयर डेवलपर किट, Android ऐप्लिकेशन डेवलपर को उपयोगकर्ता के स्वास्थ्य और तंदुरुस्ती से जुड़े डेटा का ऐक्सेस देने के लिए सभी ज़रूरी जानकारी Samsung के डिवाइसों को चुना जा सकता है. इससे ऐप्लिकेशन एक साथ कई काम कर सकते हैं जैसे कि डेटा डालना, मिटाना, और उसे पढ़ना.

शुरू करें

Health Platform का इस्तेमाल करते समय, इन बातों का ध्यान रखें:

  • क्लाइंट ऐप्लिकेशन को उपयोगकर्ता से, कॉन्टेंट पढ़ने या उसमें बदलाव करने का ऐक्सेस देना ज़रूरी है.
  • इसके बाद, उपयोगकर्ता किसी भी समय अनुमतियों को अस्वीकार कर सकता है या अनुमतियां रद्द कर सकता है.
  • Health Platform API सिर्फ़ चुनिंदा Samsung डिवाइसों के साथ काम करता है.
  • HealthDataClient, Health प्लैटफ़ॉर्म का क्लाइंट है और यह Health प्लैटफ़ॉर्म का एंट्री पॉइंट है.

नीचे दी गई इमेज में, इंटिग्रेशन के वे ज़रूरी चरण दिखाए गए हैं जिनका डेवलपर को पालन करना होगा:

इंटिग्रेशन के चरण

फ़ाइलें रिलीज़ करें

Health Platform V1 रिलीज़ में ये शामिल हैं:

  • क्लाइंट SDK टूल: Android SDK टूल का इस्तेमाल करने के लिए, इस SDK टूल को अपने ऐप्लिकेशन में शामिल करें Health Platform एपीआई. SDK टूल, एक Maven रिपॉज़िटरी है. इसे सीधे तौर पर Gradle बिल्ड फ़ाइलें डाउनलोड करना.

Health Platform इंस्टॉल करें

यह तरीका अपनाकर Health Platform इंस्टॉल करें:

ऐप्लिकेशन की रूट build.gradle फ़ाइल में, रेपो जोड़ें, जैसा कि यहां दिखाया गया है उदाहरण:

allprojects {
    ...
    repositories {
        ...
        google()
    }
}

अपने मॉड्यूल के build.gradle में, Health Platform SDK टूल पर डिपेंडेंसी जोड़ें फ़ाइल से मिलता-जुलता है, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

डेटा

Health प्लैटफ़ॉर्म पर मौजूद स्वास्थ्य और फ़िटनेस से जुड़े डेटा को इकट्ठा और व्यवस्थित किया जाता है. यह इन बातों पर भी ध्यान देता है अलग-अलग टाइप के डेटा को मेज़र करने के तरीके में मुख्य अंतर. उदाहरण के लिए, धड़कन की दर को तुरंत माप लिया जाता है, लेकिन समय की पाबंदी है.

यहां Health Platform के मुख्य ऑब्जेक्ट और उनके बीच के अंतर के बारे में बताया गया है:

  • RawData: मेज़रमेंट और डेटा रिकॉर्ड.
  • DataType: सेहत और फ़िटनेस से जुड़े सामान्य डेटा की खास जानकारी देने वाला प्रोग्राम, जैसे कि जैसे हार्ट रेट, बॉडी फ़ैट या शरीर का तापमान और उनके फ़ॉर्मैट, जैसे कि फ़ील्ड, रीड-ओनली या वैकल्पिक.
  • SampleData: RawData ऑब्जेक्ट जो तुरंत माप लिया जाता है, जैसे जैसे, धड़कन की दर, ब्लड प्रेशर या दौड़ने की रफ़्तार.
  • IntervalData: RawData ऑब्जेक्ट, जो कुल वैल्यू है किसी गतिविधि का रिकॉर्ड रखने में मदद मिलती है, जैसे कि पैदल चलने की संख्या, तय की गई दूरी या खर्च की गई कैलोरी.
  • SeriesData: एक RawData ऑब्जेक्ट, जो समय को मापा जाता है. SeriesData, खास तौर पर इन लोगों के लिए सही है हाई फ़्रीक्वेंसी सेंसर डेटा, जैसे कि गतिविधि सत्र.

तीनों RawData क्लास में से हर क्लास, DataType: SampleData, IntervalData, और SeriesData इससे जुड़े हैं SampleDataType, IntervalDataType और SeriesDataType.

हर RawData ऑब्जेक्ट को Health एक यूनीक आइडेंटिफ़ायर (यूआईडी) असाइन करता है सम्मिलित किए जाने पर प्लेटफ़ॉर्म. इस यूआईडी का इस्तेमाल, किसी खास RawData का रेफ़रंस देने के लिए किया जा सकता है ऑब्जेक्ट को पढ़ सकता है, अपडेट कर सकता है या मिटा सकता है.

डेटा टाइप

Health प्लैटफ़ॉर्म पर ऐसे कई तरह के डेटा मौजूद हैं जिनका इस्तेमाल आम तौर पर किया जाता है सेहत और फ़िटनेस वाले ऐप. उपलब्ध डेटा टाइप के साथ सेव किया गया डेटा, लोगों को और उनकी सेहत, फ़िटनेस, और तंदुरुस्ती के बारे में ज़्यादा जानकारी हासिल करते हैं साथ ही, उनकी रोज़ की गतिविधियों के बारे में भी जानकारी मिलती है.

हर तरह का डेटा, उसके डेटा फ़ॉर्मैट से तय होता है. इस फ़ॉर्मैट में ये चीज़ें शामिल हैं:

  • फ़ील्ड: डेटा टाइप से जुड़े खास या सामान्य फ़ील्ड. इसके लिए उदाहरण के लिए, खून में ऑक्सीजन की मात्रा (SpO2) वाले डेटा टाइप में टाइटल, नोट और प्रतिशत.
  • टाइप: लंबा, डबल, स्ट्रिंग या एनम.
  • एट्रिब्यूट: सिर्फ़ रीड-ओनली, ज़रूरी, वैकल्पिक या पुष्टि की रेंज.

डेटा टाइप की सूची

अलग-अलग तरह के डेटा को समझकर, Health प्लैटफ़ॉर्म का ज़्यादा से ज़्यादा फ़ायदा पाएं. Health Platform, नीचे दी गई टेबल में दिखाए गए डेटा टाइप के साथ काम करता है. डेटा टाइप को उनके फ़ॉर्मैट के हिसाब से व्यवस्थित किया जाता है: सैंपल, इंटरवल या सीरीज़ शामिल है.

SampleData टाइप:

DataType.BasalMetabolicRateDataType BASAL_METABOLIC_RATE ज़रूरी है
DataType.BloodGlucoseDataType BLOOD_GLUCOSE ज़रूरी है और ज़रूरी नहीं है
DataType.BloodPressureDataType BLOOD_PRESSURE ज़रूरी है और ज़रूरी नहीं है
DataType.BodyFatDataType BODY_FAT ज़रूरी है
DataType.BodyTemperatureDataType BODY_TEMPERATURE ज़रूरी है और ज़रूरी नहीं है
DataType.BoneMassDataType BONE_MASS ज़रूरी है
DataType.CervicalMucusDataType CERVICAL_MUCUS वैकल्पिक
DataType.CervicalPositionDataType CERVICAL_POSITION वैकल्पिक
DataType.CyclingPedalingCadenceDataType CYCLING_PEDALING_CADENCE ज़रूरी है
DataType.DateOfBirthDataType DATE_OF_BIRTH पठनीय मात्र
DataType.GenderDataType GENDER पठनीय मात्र
DataType.HeartRateDataType HEART_RATE ज़रूरी है
DataType.HeightDataType HEIGHT ज़रूरी है
DataType.HipCircumferenceDataType HIP_CIRCUMFERENCE ज़रूरी है
DataType.HrvDifferentialIndexDataType HRV_DIFFERENTIAL_INDEX ज़रूरी है
DataType.HrvRmssdDataType HRV_RMSSD ज़रूरी है
DataType.HrvSDataType HRV_S ज़रूरी है
DataType.HrvSd2DataType HRV_SD2 ज़रूरी है
DataType.HrvSdannDataType HRV_SDANN ज़रूरी है
DataType.HrvSdnnDataType HRV_SDNN ज़रूरी है
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX ज़रूरी है
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX ज़रूरी है
DataType.HrvSdsdDataType HRV_SDSD ज़रूरी है
DataType.HrvTinnDataType HRV_TINN ज़रूरी है
DataType.LeanBodyMassDataType LEAN_BODY_MASS ज़रूरी है
DataType.LocationDataType LOCATION ज़रूरी है
DataType.MenstruationDataType MENSTRUATION वैकल्पिक
DataType.OvulationTestDataType OVULATION_TEST ज़रूरी है
DataType.OxygenSaturationDataType OXYGEN_SATURATION ज़रूरी है
DataType.PaceDataType PACE ज़रूरी है
DataType.PowerDataType POWER ज़रूरी है
DataType.RespiratoryRateDataType RESPIRATORY_RATE ज़रूरी है
DataType.RestingHeartRateDataType RESTING_HEART_RATE ज़रूरी है
DataType.SexualActivityDataType SEXUAL_ACTIVITY ज़रूरी है
DataType.SpeedDataType SPEED ज़रूरी है
DataType.StepsCadenceDataType STEPS_CADENCE ज़रूरी है
DataType.Vo2MaxDataType VO2_MAX ज़रूरी है और ज़रूरी नहीं है
DataType.WaistCircumferenceDataType WAIST_CIRCUMFERENCE ज़रूरी है
DataType.WeightDataType WEIGHT ज़रूरी है

IntervalData टाइप:

DataType.ActiveEnergyDataType ACTIVE_ENERGY_BURNED ज़रूरी है
DataType.ActiveTimeDataType ACTIVE_TIME पठनीय मात्र
DataType.ActivityEventDataType ACTIVITY_EVENT ज़रूरी है
DataType.ActivityLapDataType ACTIVITY_LAP वैकल्पिक
DataType.ActivitySessionDataType ACTIVITY_SESSION ज़रूरी है
DataType.BasalEnergyDataType BASAL_ENERGY_BURNED पठनीय मात्र
DataType.DistanceDataType DISTANCE ज़रूरी है
DataType.ElevationGainedDataType ELEVATION_GAINED ज़रूरी है
DataType.FloorsClimbedDataType FLOORS_CLIMBED ज़रूरी है
DataType.HydrationDataType HYDRATION ज़रूरी है
DataType.NutritionDataType NUTRITION वैकल्पिक
DataType.RepetitionsDataType REPETITIONS ज़रूरी है
DataType.SleepSessionDataType SLEEP_SESSION वैकल्पिक
DataType.SleepStageDataType SLEEP_STAGE ज़रूरी है
DataType.StepsDataType STEPS ज़रूरी है
DataType.SwimmingStrokesDataType SWIMMING_STROKES ज़रूरी है और ज़रूरी नहीं है
DataType.TotalEnergyDataType TOTAL_ENERGY_BURNED पठनीय मात्र

SeriesData टाइप:

DataType.CyclingPedalingCadenceSeriesDataType CYCLING_PEDALING_CADENCE ज़रूरी है
DataType.HeartRateSeriesDataType HEART_RATE ज़रूरी है
DataType.LocationSeriesDataType LOCATION ज़रूरी है
DataType.PaceSeriesDataType PACE ज़रूरी है
DataType.PowerSeriesDataType POWER ज़रूरी है
DataType.SpeedSeriesDataType SPEED ज़रूरी है
DataType.StepsCadenceSeriesDataType STEPS_CADENCE ज़रूरी है

डेवलपर फ़ंक्शन

नीचे दिए गए में उपलब्ध स्टैंडर्ड डेटा फ़ंक्शन के सेट के बारे में बताया गया है Health प्लैटफ़ॉर्म. यह प्लैटफ़ॉर्म, स्टैंडर्ड इंसर्ट करने, अपडेट करने, और मिटाने की सुविधा देता है फ़ंक्शन का इस्तेमाल करता है.

एग्रीगेट किया गया डेटा पढ़ें

इस प्लैटफ़ॉर्म की मदद से, क्लाइंट नीचे बताए गए अलग-अलग तरह के डेटा के आधार पर एग्रीगेशन फ़ंक्शन लागू कर सकते हैं AggregatedData:

  • StatisticalData: औसत, कम से कम या ज़्यादा से ज़्यादा वैल्यू SampleData या SeriesData का सेट, जैसे कि कम से कम और ज़्यादा से ज़्यादा हार्ट रेट किया गया है.
  • CumulativeData: IntervalData वैल्यू का योग, जैसे कि एक दिन के अंतराल में कदमों की कुल संख्या.
  • CountData: RawData की कुल संख्या की आसान गिनती ऑब्जेक्ट, जैसे किसी हफ़्ते में गतिविधि के सेशन की संख्या. डेटा गिनें इसकी गिनती सैंपल, इंटरवल, और सीरीज़ के डेटा टाइप के लिए की जा सकती है.

Health Platform API से कनेक्ट करें

Health Platform API का एंट्री पॉइंट HealthDataClient है.

Health प्लैटफ़ॉर्म से कनेक्ट करने का तरीका यहां बताया गया है:

  1. HealthDataClient के नए इंस्टेंस बनाने के लिए, HealthDataService.getClient का इस्तेमाल करें.
  2. इसके बाद क्लाइंट ऐप्लिकेशन को requestPermissions (Set) तरीका.

HealthDataClient, मौजूदा डिवाइसों से अपना कनेक्शन अपने-आप मैनेज करता है स्टोरेज लेयर के साथ-साथ सभी इंटर-प्रोसेस कम्यूनिकेशन (आईपीसी) और किए जाने वाले अनुरोधों को क्रम में लगाने का काम भी मैनेज करता है और आने वाले जवाब.

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है