इतिहास एपीआई आपके ऐप्लिकेशन को फ़िटनेस स्टोर पर बल्क ऑपरेशन करने देता है: स्वास्थ्य और स्वास्थ्य से जुड़ा पुराना डेटा पढ़ना, डालना, अपडेट करना, और मिटाना. यह करने के लिए इतिहास एपीआई का इस्तेमाल करें:
- अन्य ऐप्लिकेशन का इस्तेमाल करके डाला गया या रिकॉर्ड किया गया स्वास्थ्य और तंदुरुस्ती का डेटा पढ़ें.
- Google Fit में बैच डेटा इंपोर्ट करें.
- Google Fit में डेटा अपडेट करें.
- अपने ऐप्लिकेशन पर पहले सेव किया गया पुराना डेटा मिटाएं.
सेशन मेटाडेटा वाला डेटा डालने के लिए, सेशन एपीआई का इस्तेमाल करें.
डेटा पढ़ने की अनुमति दें
नीचे दिए गए सेक्शन में, अलग-अलग तरह का एग्रीगेट डेटा पढ़ने का तरीका बताया गया है.
ज़्यादा जानकारी और पूरा डेटा पढ़ें
पुराना डेटा पढ़ने के लिए, DataReadRequest
इंस्टेंस बनाएं.
Kotlin
// Read the data that's been collected throughout the past week. val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()) val startTime = endTime.minusWeeks(1) Log.i(TAG, "Range Start: $startTime") Log.i(TAG, "Range End: $endTime") val readRequest = DataReadRequest.Builder() // The data request can specify multiple data types to return, // effectively combining multiple data queries into one call. // This example demonstrates aggregating only one data type. .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA) // Analogous to a "Group By" in SQL, defines how data should be // aggregated. // bucketByTime allows for a time span, whereas bucketBySession allows // bucketing by <a href="/fit/android/using-sessions">sessions</a>. .bucketByTime(1, TimeUnit.DAYS) .setTimeRange(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build()
Java
// Read the data that's been collected throughout the past week. ZonedDateTime endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()); ZonedDateTime startTime = endTime.minusWeeks(1); Log.i(TAG, "Range Start: $startTime"); Log.i(TAG, "Range End: $endTime"); DataReadRequest readRequest = new DataReadRequest.Builder() // The data request can specify multiple data types to return, // effectively combining multiple data queries into one call. // This example demonstrates aggregating only one data type. .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA) // Analogous to a "Group By" in SQL, defines how data should be // aggregated. // bucketByTime allows for a time span, while bucketBySession allows // bucketing by sessions. .bucketByTime(1, TimeUnit.DAYS) .setTimeRange(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build();
पिछले उदाहरण में, एग्रीगेट किए गए डेटा पॉइंट का इस्तेमाल किया गया है. यहां हर DataPoint
एक दिन में चले गए कदमों की संख्या दिखाता है. उपयोग के इस खास मामले में,
एग्रीगेट किए गए डेटा पॉइंट के दो फ़ायदे हैं:
- आपके ऐप्लिकेशन और फ़िटनेस स्टोर में कम डेटा मिलता है.
- आपके ऐप्लिकेशन को मैन्युअल रूप से डेटा इकट्ठा करने की ज़रूरत नहीं है.
गतिविधि के कई टाइप के लिए डेटा इकट्ठा करना
कई तरह के डेटा को वापस पाने के लिए, आपका ऐप्लिकेशन डेटा के अनुरोधों का इस्तेमाल कर सकता है. नीचे दिए गए उदाहरण में बताया गया है कि समयसीमा के अंदर किए गए हर गतिविधि के लिए खर्च हुई कैलोरी का हिसाब लगाने के लिए, DataReadRequest
कैसे बनाया जाता है. नतीजे के तौर पर मिलने वाला डेटा, Google Fit ऐप्लिकेशन में रिपोर्ट की गई
हर गतिविधि की कैलोरी से मेल खाता है. इसमें हर गतिविधि को कैलोरी के डेटा की अपनी बकेट मिलती है.
Kotlin
val readRequest = DataReadRequest.Builder() .aggregate(DataType.AGGREGATE_CALORIES_EXPENDED) .bucketByActivityType(1, TimeUnit.SECONDS) .setTimeRange(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build()
Java
DataReadRequest readRequest = new DataReadRequest.Builder() .aggregate(DataType.AGGREGATE_CALORIES_EXPENDED) .bucketByActivityType(1, TimeUnit.SECONDS) .setTimeRange(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build();
DataReadRequest
इंस्टेंस बनाने के बाद, HistoryClient.readData()
तरीके का इस्तेमाल करके एसिंक्रोनस तरीके से डेटा पढ़ें.
नीचे दिए गए उदाहरण में DataSet
से DataPoint
इंस्टेंस पाने का तरीका बताया गया है:
Kotlin
Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .readData(readRequest) .addOnSuccessListener { response -> // The aggregate query puts datasets into buckets, so flatten into a // single list of datasets for (dataSet in response.buckets.flatMap { it.dataSets }) { dumpDataSet(dataSet) } } .addOnFailureListener { e -> Log.w(TAG,"There was an error reading data from Google Fit", e) } fun dumpDataSet(dataSet: DataSet) { Log.i(TAG, "Data returned for Data type: ${dataSet.dataType.name}") for (dp in dataSet.dataPoints) { Log.i(TAG,"Data point:") Log.i(TAG,"\tType: ${dp.dataType.name}") Log.i(TAG,"\tStart: ${dp.getStartTimeString()}") Log.i(TAG,"\tEnd: ${dp.getEndTimeString()}") for (field in dp.dataType.fields) { Log.i(TAG,"\tField: ${field.name.toString()} Value: ${dp.getValue(field)}") } } } fun DataPoint.getStartTimeString() = Instant.ofEpochSecond(this.getStartTime(TimeUnit.SECONDS)) .atZone(ZoneId.systemDefault()) .toLocalDateTime().toString() fun DataPoint.getEndTimeString() = Instant.ofEpochSecond(this.getEndTime(TimeUnit.SECONDS)) .atZone(ZoneId.systemDefault()) .toLocalDateTime().toString()
Java
Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .readData(readRequest) .addOnSuccessListener (response -> { // The aggregate query puts datasets into buckets, so convert to a // single list of datasets for (Bucket bucket : response.getBuckets()) { for (DataSet dataSet : bucket.getDataSets()) { dumpDataSet(dataSet); } } }) .addOnFailureListener(e -> Log.w(TAG, "There was an error reading data from Google Fit", e)); } private void dumpDataSet(DataSet dataSet) { Log.i(TAG, "Data returned for Data type: ${dataSet.dataType.name}"); for (DataPoint dp : dataSet.getDataPoints()) { Log.i(TAG,"Data point:"); Log.i(TAG,"\tType: ${dp.dataType.name}"); Log.i(TAG,"\tStart: ${dp.getStartTimeString()}"); Log.i(TAG,"\tEnd: ${dp.getEndTimeString()}"); for (Field field : dp.getDataType().getFields()) { Log.i(TAG,"\tField: ${field.name.toString()} Value: ${dp.getValue(field)}"); } } } private String getStartTimeString() { return Instant.ofEpochSecond(this.getStartTime(TimeUnit.SECONDS)) .atZone(ZoneId.systemDefault()) .toLocalDateTime().toString(); } private String getEndTimeString() { return Instant.ofEpochSecond(this.getEndTime(TimeUnit.SECONDS)) .atZone(ZoneId.systemDefault()) .toLocalDateTime().toString(); }
रोज़ का कुल डेटा पढ़ें
Google Fit, बताए गए डेटा टाइप की रोज़ की कुल परफ़ॉर्मेंस का भी आसान ऐक्सेस देता है. डेटा के उस टाइप को वापस पाने के लिए
HistoryClient.readDailyTotal()
तरीका का इस्तेमाल करें जिसे आप डिवाइस के मौजूदा
समय क्षेत्र की आधी रात
के तौर पर बताते हैं. उदाहरण के लिए, हर दिन के
सभी चरणों को फिर से पाने के लिए, इस तरीके में
TYPE_STEP_COUNT_DELTA
डेटा टाइप को पास करें. आप इंस्टैंट डेटा का टाइप पास कर सकते हैं, जिसका हर दिन का कुल डेटा होता है. किस तरह के डेटा पर काम किया जा सकता है, इसके बारे में ज़्यादा जानकारी के लिए,
DataType.getAggregateType
देखें.
जब इस तरीके को डिफ़ॉल्ट खाते का इस्तेमाल करके कॉल किया जाता है, तो Google Fit को HistoryClient.readDailyTotal()
तरीके से TYPE_STEP_COUNT_DELTA
अपडेट की सदस्यता लेने के लिए अनुमति की ज़रूरत नहीं होती. साथ ही, कोई भी
दायरा नहीं बताया जाता है.
यह तब काम आ सकता है, जब आपको उन जगहों पर इस्तेमाल करने के लिए चरण डेटा की ज़रूरत हो जहां आप अनुमति पैनल नहीं दिखा सकते. उदाहरण के लिए, Wear OS स्मार्ट वॉच के फ़ेस पर.
उपयोगकर्ता Google Fit ऐप्लिकेशन, दूसरे ऐप्लिकेशन, और Wear OS पर स्मार्ट वॉच की होम स्क्रीन पर, चरणों की एक जैसी संख्या देखना पसंद करते हैं. ऐसा इसलिए, क्योंकि इससे उन्हें लगातार और भरोसेमंद अनुभव मिलता है. कदमों की गिनती एक जैसी रखने के लिए, अपने ऐप्लिकेशन या स्मार्ट वॉच की होम स्क्रीन पर, Google Fit प्लैटफ़ॉर्म में शामिल चरणों की सदस्यता लें. इसके बाद, गिनती को अपडेट करें onExitAmbient()
.
इस डेटा को स्मार्ट वॉच की होम स्क्रीन पर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, स्मार्ट वॉच की होम स्क्रीन से जुड़ी समस्याएं
और Android WatchFace का सैंपल ऐप्लिकेशन देखें.
डेटा डालें
पुराना डेटा डालने के लिए, पहले एक DataSet
इंस्टेंस बनाएं:
Kotlin
// Declare that the data being inserted was collected during the past hour. val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()) val startTime = endTime.minusHours(1) // Create a data source val dataSource = DataSource.Builder() .setAppPackageName(this) .setDataType(DataType.TYPE_STEP_COUNT_DELTA) .setStreamName("$TAG - step count") .setType(DataSource.TYPE_RAW) .build() // For each data point, specify a start time, end time, and the // data value -- in this case, 950 new steps. val stepCountDelta = 950 val dataPoint = DataPoint.builder(dataSource) .setField(Field.FIELD_STEPS, stepCountDelta) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build() val dataSet = DataSet.builder(dataSource) .add(dataPoint) .build()
Java
// Declare that the data being inserted was collected during the past hour. ZonedDateTime endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()); ZonedDateTime startTime = endTime.minusHours(1); // Create a data source DataSource dataSource = new DataSource.Builder() .setAppPackageName(this) .setDataType(DataType.TYPE_STEP_COUNT_DELTA) .setStreamName("$TAG - step count") .setType(DataSource.TYPE_RAW) .build(); // For each data point, specify a start time, end time, and the // data value -- in this case, 950 new steps. int stepCountDelta = 950; DataPoint dataPoint = DataPoint.builder(dataSource) .setField(Field.FIELD_STEPS, stepCountDelta) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build(); DataSet dataSet = DataSet.builder(dataSource) .add(dataPoint) .build();
DataSet
इंस्टेंस बनाने के बाद,
HistoryClient.insertData
मैथड का इस्तेमाल करके, पुराना डेटा जोड़ें.
Kotlin
Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .insertData(dataSet) .addOnSuccessListener { Log.i(TAG, "DataSet added successfully!") } .addOnFailureListener { e -> Log.w(TAG, "There was an error adding the DataSet", e) }
Java
Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .insertData(dataSet) .addOnSuccessListener (unused -> Log.i(TAG, "DataSet added successfully!")) .addOnFailureListener(e -> Log.w(TAG, "There was an error adding the DataSet", e)); }
विरोधी डेटा बिंदु प्रबंधित करें
आपके ऐप्लिकेशन में हर
DataPoint
DataSet
में, एक startTime
और endTime
होना चाहिए, जो उस DataSet
में एक यूनीक इंटरवल की जानकारी देता हो. साथ ही, इसमें DataPoint
के इंस्टेंस के बीच कोई ओवरलैप नहीं होता है.
अगर आपका ऐप्लिकेशन, ऐसे नए DataPoint
को शामिल करने की कोशिश करता है जो किसी मौजूदा
DataPoint
इंस्टेंस से मेल नहीं खाता है, तो नया DataPoint
खारिज कर दिया जाता है. मौजूदा डेटा पॉइंट को ओवरलैप करने वाला नया
DataPoint
डालने के लिए, डेटा अपडेट करें में बताए गए
HistoryClient.updateData
तरीके का इस्तेमाल करें.
पहला डायग्राम. insertData()
का तरीका, ऐसे नए डेटा पॉइंट को हैंडल कैसे करता है
जो मौजूदा DataPoint
के साथ मेल नहीं खाते.
डेटा अपडेट करना
Google Fit आपके ऐप्लिकेशन को ऐतिहासिक डेटा और सेहत का डेटा अपडेट करने देता है. नए DataSet
के नए डेटा का डेटा जोड़ने या नए DataPoint
इंस्टेंस का इस्तेमाल करने के लिए,
मौजूदा डेटा पॉइंट के साथ टकराव
HistoryApi.insertData
वाले तरीके का इस्तेमाल करें.
पुराना डेटा अपडेट करने के लिए, HistoryClient.updateData
तरीके का इस्तेमाल करें. इस तरीके से, DataPoint
इस इंस्टेंस का इस्तेमाल करके जोड़े गए मौजूदा DataPoint
इंस्टेंस मिट जाते हैं.
स्वास्थ्य और सेहत का पुराना डेटा अपडेट करने के लिए, पहले DataSet
इंस्टेंस बनाएं:
Kotlin
// Declare that the historical data was collected during the past 50 minutes. val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()) val startTime = endTime.minusMinutes(50) // Create a data source val dataSource = DataSource.Builder() .setAppPackageName(this) .setDataType(DataType.TYPE_STEP_COUNT_DELTA) .setStreamName("$TAG - step count") .setType(DataSource.TYPE_RAW) .build() // Create a data set // For each data point, specify a start time, end time, and the // data value -- in this case, 1000 new steps. val stepCountDelta = 1000 val dataPoint = DataPoint.builder(dataSource) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .setField(Field.FIELD_STEPS, stepCountDelta) .build() val dataSet = DataSet.builder(dataSource) .add(dataPoint) .build()
Java
// Declare that the historical data was collected during the past 50 minutes. ZonedDateTime endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()); ZonedDateTime startTime = endTime.minusMinutes(50); // Create a data source DataSource dataSource = new DataSource.Builder() .setAppPackageName(this) .setDataType(DataType.TYPE_STEP_COUNT_DELTA) .setStreamName("$TAG - step count") .setType(DataSource.TYPE_RAW) .build(); // Create a data set // For each data point, specify a start time, end time, and the // data value -- in this case, 1000 new steps. int stepCountDelta = 1000; DataPoint dataPoint = DataPoint.builder(dataSource) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .setField(Field.FIELD_STEPS, stepCountDelta) .build(); DataSet dataSet = DataSet.builder(dataSource) .add(dataPoint) .build();
इसके बाद, डेटा अपडेट का नया अनुरोध करने के लिए, DataUpdateRequest.Builder()
का इस्तेमाल करें और
अनुरोध करने के लिए, HistoryClient.updateData
तरीके का इस्तेमाल करें:
Kotlin
val request = DataUpdateRequest.Builder() .setDataSet(dataSet) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build() Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .updateData(request) .addOnSuccessListener { Log.i(TAG, "DataSet updated successfully!") } .addOnFailureListener { e -> Log.w(TAG, "There was an error updating the DataSet", e) }
Java
DataUpdateRequest request = new DataUpdateRequest.Builder() .setDataSet(dataSet) .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .build(); Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .updateData(request) .addOnSuccessListener(unused -> Log.i(TAG, "DataSet updated successfully!")) .addOnFailureListener(e -> Log.w(TAG, "There was an error updating the DataSet", e));
डेटा मिटाएं
Google Fit आपके ऐप्लिकेशन को सेहत और सेहत का पुराना डेटा मिटाने की सुविधा देता है.
पुराना डेटा मिटाने के लिए, HistoryClient.deleteData
तरीका अपनाएं:
Kotlin
// Declare that this code deletes step count information that was collected // throughout the past day. val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()) val startTime = endTime.minusDays(1) // Create a delete request object, providing a data type and a time interval val request = DataDeleteRequest.Builder() .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .addDataType(DataType.TYPE_STEP_COUNT_DELTA) .build() // Invoke the History API with the HistoryClient object and delete request, and // then specify a callback that will check the result. Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .deleteData(request) .addOnSuccessListener { Log.i(TAG, "Data deleted successfully!") } .addOnFailureListener { e -> Log.w(TAG, "There was an error with the deletion request", e) }
Java
// Declare that this code deletes step count information that was collected // throughout the past day. ZonedDateTime endTime = LocalDateTime.now().atZone(ZoneId.systemDefault()); ZonedDateTime startTime = endTime.minusDays(1); // Create a delete request object, providing a data type and a time interval DataDeleteRequest request = new DataDeleteRequest.Builder() .setTimeInterval(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS) .addDataType(DataType.TYPE_STEP_COUNT_DELTA) .build(); // Invoke the History API with the HistoryClient object and delete request, and // then specify a callback that will check the result. Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .deleteData(request) .addOnSuccessListener (unused -> Log.i(TAG, "Data deleted successfully!")) .addOnFailureListener(e -> Log.w(TAG, "There was an error with the deletion request", e));
ऐप्लिकेशन, खास सेशन का डेटा मिटा सकते हैं या
पूरा डेटा मिटा सकते हैं. ज़्यादा जानकारी के लिए, DataDeleteRequest
का एपीआई रेफ़रंस देखें.
डेटा अपडेट के लिए रजिस्टर करें
आपका ऐप्लिकेशन, SensorsClient
के साथ रजिस्टर करके, रॉ सेंसर के डेटा को रीयल टाइम में पढ़ सकता है.
बार-बार इस्तेमाल किए जाने वाले और मैन्युअल तौर पर गिने जाने वाले दूसरी तरह के डेटा के लिए,
आपके ऐप्लिकेशन को अपडेट मिल सकते हैं. ये अपडेट तब मिलते हैं, जब इन मेज़रमेंट को Google Fit के डेटाबेस में डाला जाता है. इन डेटा टाइप के उदाहरणों में ऊंचाई, वज़न, और वेट लिफ़्टिंग जैसी कसरतें शामिल हैं. ज़्यादा जानकारी के लिए, काम करने वाले डेटा टाइप की पूरी सूची देखें.
अपडेट के लिए रजिस्टर करने के लिए, HistoryClient.registerDataUpdateListener
का इस्तेमाल करें.
जब उपयोगकर्ता अपने वज़न के लिए नई वैल्यू डालता है, तो नीचे दिए गए कोड स्निपेट की मदद से ऐप्लिकेशन को इसकी सूचना दी जाती है:
Kotlin
val intent = Intent(this, MyDataUpdateService::class.java) val pendingIntent = PendingIntent.getService(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT) val request = DataUpdateListenerRegistrationRequest.Builder() .setDataType(DataType.TYPE_WEIGHT) .setPendingIntent(pendingIntent) .build() Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .registerDataUpdateListener(request) .addOnSuccessListener { Log.i(TAG, "DataUpdateListener registered") }
Java
Intent intent = new Intent(this, MyDataUpdateService.class); PendingIntent pendingIntent = PendingIntent.getService(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT) DataUpdateListenerRegistrationRequest request = new DataUpdateListenerRegistrationRequest.Builder() .setDataType(DataType.TYPE_WEIGHT) .setPendingIntent(pendingIntent) .build(); Fitness.getHistoryClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions)) .registerDataUpdateListener(request) .addOnSuccessListener(unused -> Log.i(TAG, "DataUpdateListener registered"));
अपडेट की सूचनाएं पाने के लिए, IntentService
का इस्तेमाल किया जा सकता है:
Kotlin
class MyDataUpdateService : IntentService("MyDataUpdateService") { override fun onHandleIntent(intent: Intent?) { val update = DataUpdateNotification.getDataUpdateNotification(intent) // Show the time interval over which the data points were collected. // To extract specific data values, in this case the user's weight, // use DataReadRequest. update?.apply { val start = getUpdateStartTime(TimeUnit.MILLISECONDS) val end = getUpdateEndTime(TimeUnit.MILLISECONDS) Log.i(TAG, "Data Update start: $start end: $end DataType: ${dataType.name}") } } }
Java
public class MyDataUpdateService extends IntentService { public MyDataUpdateService(String name) { super("MyDataUpdateService"); } @Override protected void onHandleIntent(@Nullable Intent intent) { if (intent != null) { DataUpdateNotification update = DataUpdateNotification.getDataUpdateNotification(intent); // Show the time interval over which the data points // were collected. // To extract specific data values, in this case the user's weight, // use DataReadRequest. if (update != null) { long start = update.getUpdateStartTime(TimeUnit.MILLISECONDS); long end = update.getUpdateEndTime(TimeUnit.MILLISECONDS); } Log.i(TAG, "Data Update start: $start end: $end DataType: ${dataType.name}"); } } }
IntentService
का एलान आपकी AndroidManifest.xml
फ़ाइल में किया जाना चाहिए.