History API, uygulamanızın spor salonundaki toplu işlemleri gerçekleştirmesini sağlar: Geçmiş sağlık ve sağlıklı yaşam verilerini okuma, ekleme, güncelleme ve silme. Aşağıdakileri yapmak için History API'sini kullanın:
- Diğer uygulamalar kullanılarak eklenen veya kaydedilen sağlık ve sağlıklı yaşam verilerini okuyun.
- Toplu verileri Google Fit'e aktarın.
- Google Fit'te verileri güncelleyin.
- Uygulamanızın daha önce depoladığı geçmiş verileri silin.
Oturum meta verilerini içeren veriler eklemek için Sessions API'yi kullanın.
Verileri okuma
Aşağıdaki bölümlerde, farklı türdeki verilerin nasıl okunacağı açıklanmaktadır.
Ayrıntılı ve birleştirilmiş verileri okuma
Geçmiş verileri okumak için DataReadRequest
örneği oluşturun.
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();
Önceki örnekte, her bir DataPoint
günde kaç adım yüründüğünü temsil eden toplu veri noktaları kullanılmaktadır. Bu kullanım alanında, birleştirilmiş veri noktalarının iki avantajı vardır:
- Uygulamanız ve spor salonu daha az veri alışverişinde bulunuyor.
- Uygulamanızın verileri manuel olarak toplaması gerekmez.
Birden fazla etkinlik türü için birleştirilmiş veriler
Uygulamanız birçok farklı veri türünü almak için veri isteklerini kullanabilir. Aşağıdaki örnekte, belirtilen zaman aralığında gerçekleştirilen her aktivitenin yaktığı kalorileri almak için nasıl DataReadRequest
oluşturulacağı gösterilmektedir. Sonuçta elde edilen veriler, Google Fit uygulamasında bildirilen etkinlik başına kalori miktarını eşleştirir. Burada her aktivite kendi kalori verilerini alır.
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
örneği oluşturduktan sonra, geçmiş verileri eşzamansız olarak okumak için HistoryClient.readData()
yöntemini kullanın.
Aşağıdaki örnekte, bir DataSet
öğesinden DataPoint
örneklerinin nasıl alınacağı gösterilmektedir:
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(); }
Günlük toplam verileri oku
Google Fit ayrıca, belirtilen bir veri türünün günlük toplamına kolay erişim de sağlar. Cihazın geçerli saat diliminde gece yarısı itibarıyla belirttiğiniz veri türünü almak için HistoryClient.readDailyTotal()
yöntemini kullanın. Örneğin, günlük toplam adım sayısını almak için TYPE_STEP_COUNT_DELTA
veri türünü bu yönteme iletin. Günlük toplamının toplam olduğu anlık bir veri türünü iletebilirsiniz. Desteklenen veri türleri hakkında daha fazla bilgi için DataType.getAggregateType
bölümüne bakın.
Google Fit, varsayılan hesap kullanılarak çağrıldığında ve herhangi bir kapsam belirtilmediğinde HistoryClient.readDailyTotal()
yönteminden TYPE_STEP_COUNT_DELTA
güncellemelerine abone olmak için yetkilendirme gerektirmez.
Bu, izin panelini gösteremediğiniz alanlarda (örneğin, Wear OS saat yüzlerinde) kullanmak için adım verilerini kullanmak istediğinizde yararlı olabilir.
Google Fit uygulaması, diğer uygulamalar ve Wear OS saat yüzlerinde tutarlı adım sayısı görmeyi tercih ederler. Bu da tutarlı ve güvenilir bir deneyim sağlar. Adım sayılarının tutarlı olmasını sağlamak için uygulamanızdan veya saat yüzünüzden Google Fit platformundaki adımlara abone olun, ardından sayıyı onExitAmbient()
sayfasında güncelleyin.
Bu verilerin saat yüzünde nasıl kullanılacağı hakkında daha fazla bilgi için Saat yüzü özellikleri ve Android WatchFace örnek uygulamasına bakın.
Veri girin
Geçmiş verileri eklemek için önce bir DataSet
örnek oluşturun:
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
örneği oluşturduktan sonra, bu geçmiş verileri eşzamansız olarak eklemek için HistoryClient.insertData
yöntemini kullanın.
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)); }
Çakışan veri noktalarını yönetin
Uygulamanızın DataSet
öğesindeki her bir DataPoint
, DataPoint
örneği arasında çakışma olmadan DataSet
içinde benzersiz bir aralığı tanımlayan bir startTime
ve endTime
içermelidir.
Uygulamanız mevcut bir DataPoint
örneğiyle çakışan yeni bir DataPoint
eklemeye çalışırsa yeni DataPoint
silinir. Mevcut veri noktalarıyla çakışabilecek yeni bir DataPoint
eklemek için Verileri güncelleme bölümünde açıklanan HistoryClient.updateData
yöntemini kullanın.
1. Şekil. insertData()
yönteminin, mevcut bir DataPoint
ile çakışan yeni veri noktalarını işleme şekli.
Verileri güncelle
Google Fit, uygulamanızın daha önce eklediği geçmiş sağlık ve sağlıklı yaşam verilerini güncellemesini sağlar. Yeni bir DataSet
için geçmiş verileri eklemek veya mevcut veri noktalarıyla çakışmayan yeni DataPoint
örnekleri eklemek için HistoryApi.insertData
yöntemini kullanın.
Geçmiş verileri güncellemek için HistoryClient.updateData
yöntemini kullanın. Bu yöntem, bu yöntem kullanılarak eklenen DataPoint
örnekleriyle çakışan mevcut DataPoint
örneklerini siler.
Geçmiş sağlık ve sağlıklı yaşam verilerini güncellemek için önce bir DataSet
örneği oluşturun:
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();
Ardından, yeni veri güncelleme isteği oluşturmak için DataUpdateRequest.Builder()
, isteği göndermek için HistoryClient.updateData
yöntemini kullanın:
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));
Verileri sil
Google Fit, uygulamanızın daha önce eklediği geçmiş sağlık ve sağlıklı yaşam verilerini silmesine olanak tanır.
Geçmiş verileri silmek için HistoryClient.deleteData
yöntemini kullanın:
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));
Uygulamalar belirli oturumlardan verileri veya tüm verileri silebilir. Daha fazla bilgi için DataDeleteRequest
ile ilgili API referansına bakın.
Veri güncellemeleri için kaydolun
Uygulamanız, SensorsClient
ürününe kaydolarak ham sensör verilerini gerçek zamanlı olarak okuyabilir.
Daha seyrek görülen ve manuel olarak sayılan diğer veri türleri için uygulamanız, bu ölçümler Google Fit veritabanına eklendiğinde güncellemeleri almak için kaydolabilir. Bu veri türlerine örnek olarak yükseklik, ağırlık ve ağırlık kaldırma gibi antrenmanlar verilebilir. Daha fazla ayrıntı için desteklenen veri türlerinin tam listesine göz atın.
Güncellemelere kaydolmak için HistoryClient.registerDataUpdateListener
aracını kullanın.
Aşağıdaki kod snippet'i, kullanıcı ağırlığı için yeni bir değer girdiğinde uygulamaya bildirim gönderilmesini sağlar:
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"));
Güncellemelerle ilgili bildirim almak için IntentService
kullanılabilir:
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
dosyanızda belirtilmelidir.