Geçmiş verilerle çalışma

History API, uygulamanızın fitness mağazasında toplu işlemler (geçmiş sağlık ve sağlıklı yaşam verilerini okuma, ekleme, güncelleme ve silme) gerçekleştirmesini sağlar. Şunları yapmak için History API'yi kullanın:

  • Diğer uygulamalar kullanılarak eklenen veya kaydedilen sağlık ve sağlıklı yaşam verilerini okuma.
  • Toplu verileri Google Fit'e aktarın.
  • Google Fit'teki 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ürlerdeki birleştirilmiş verilerin nasıl okunacağı ele alınmaktadır.

Ayrıntılı ve birleştirilmiş verileri okuma

Geçmiş verileri okumak için bir 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 birleştirilmiş veri noktaları kullanılmıştır. Her DataPoint, bir gün içinde yürünan adım sayısını temsil eder. Bu özel kullanım alanında, birleştirilmiş veri noktalarının iki avantajı vardır:

  • Uygulamanız ve fitness mağazası daha az miktarda veri alışverişinde bulunur.
  • Uygulamanızın verileri manuel olarak toplaması gerekmez.

Birden çok etkinlik türü için verileri birleştirme

Uygulamanız birçok farklı veri türünü almak için veri isteklerini kullanabilir. Aşağıdaki örnek, belirtilen zaman aralığında gerçekleştirilen her aktivitede yakılan kalori miktarını almak için nasıl DataReadRequest oluşturulacağı gösterilmektedir. Elde edilen veriler, Google Fit uygulamasında bildirilen aktivite başına kalorilerle eşleşir. Google Fit uygulamasında her aktivite kendi kalori verisi paketine sahiptir.

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 örnek, bir DataSet öğesinden DataPoint örneklerinin nasıl alınacağını gösterir:

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 belirli bir veri türünün günlük toplamına kolay erişim sağlar. Belirtilen veri türünü, cihazın mevcut saat diliminde, o günün gece yarısından itibaren almak için HistoryClient.readDailyTotal() yöntemini kullanın. Örneğin, günlük toplam adımları almak için TYPE_STEP_COUNT_DELTA veri türünü bu yönteme geçirin. Toplu günlük toplamı olan bir anlık veri türünü iletebilirsiniz. Desteklenen veri türleri hakkında daha fazla bilgi için DataType.getAggregateType adresini inceleyin.

Bu yöntem varsayılan hesap kullanılarak çağrıldığında ve herhangi bir kapsam belirtilmediğinde Google Fit, HistoryClient.readDailyTotal() yöntemindeki TYPE_STEP_COUNT_DELTA güncellemelerine abone olmak için yetkilendirme gerektirmez. Bu özellik, izin panelini gösteremediğiniz alanlarda (ör. Wear OS kadranlar) kullanım için adım verilerine ihtiyaç duyuyorsanız yararlı olabilir.

Kullanıcılar Google Fit uygulaması, diğer uygulamalar ve Wear OS saat yüzlerinde tutarlı adım sayıları görmeyi tercih ederler, çünkü bu onlara tutarlı ve güvenilir bir deneyim sağlar. Adım sayılarının tutarlı olması için uygulamanızdan veya kadranınızdan Google Fit platformundaki adımlara abone olun, ardından onExitAmbient() sayfasında sayıyı güncelleyin. Bu verilerin kadranda nasıl kullanılacağı hakkında daha fazla bilgi için Kadran özellikleri'ne 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önet

Uygulamanızın DataSet öğesindeki her DataPoint, DataPoint örnekleri arasında çakışma olmadan söz konusu 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.

Süresi mevcut herhangi bir veri noktasıyla çakışan bir veri noktası eklenemez

Şekil 1. 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üncellemesine olanak tanır. Geçmiş verileri yeni bir DataSet 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 bir veri güncelleme isteği oluşturmak için DataUpdateRequest.Builder() yöntemini kullanın ve istekte bulunmak 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 oturumlardaki verileri veya tüm verileri silebilir. Daha fazla bilgi için DataDeleteRequest API referansına bakın.

Veri güncellemeleri için kaydolun

Uygulamanız SensorsClient'e kaydolarak ham sensör verilerini gerçek zamanlı olarak okuyabilir.

Daha az sıklıkta gerçekleşen ve manuel olarak sayılan diğer veri türleri için uygulamanız, bu ölçümler Google Fit veritabanına eklendiğinde güncelleme almak üzere kaydolabilir. Boy, kilo ve ağırlık kaldırma gibi antrenmanlar, bu veri türlerine örnek olarak gösterilebilir. Daha ayrıntılı bilgi için desteklenen veri türlerinin tam listesine bakın. Güncellemelere kaydolmak için HistoryClient.registerDataUpdateListener adresini kullanın.

Aşağıdaki kod snippet'i, kullanıcı ağırlığı için yeni bir değer girdiğinde uygulamanın bilgilendirilmesini 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"));

IntentService, güncelleme bildirimlerini almak için 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}");
        }
    }
}

AndroidManifest.xml dosyanızda IntentService belirtilmelidir.