PowerRecord: Health Connect power data
Read from Google’s documentation on 2026-10-03 · Google’s reference page last updated 2026-06-24
PowerRecord is Health Connect's power record — a Series record in Google's Activity category. Its read permission is android.permission.health.READ_POWER; its write permission is android.permission.health.WRITE_POWER. It supports 3 aggregate metrics (POWER_AVG, POWER_MAX and POWER_MIN). Mandatory fields per Google's table: endTime, samples, metadata and startTime.
What Google says PowerRecord is
Captures the power generated by the user, e.g. during cycling or rowing with a power meter. Each record represents a series of measurements.
Quoted from Google’s PowerRecord Jetpack reference, last updated 2026-06-24, read 2026-10-03.
- Class
androidx.health.connect.client.records.PowerRecord- Google's category
- Activity
- Record type
- Series
- Unit class
- none named in Google's table
- Mandatory fields
endTimesamplesmetadatastartTime- Added in (Jetpack)
1.1.0
Permissions
The exact strings Google’s data-types table declares for PowerRecord. Google’s page: “Before requesting any permissions, your app must declare them in the manifest.”
| Access | Permission string | Framework reference |
|---|---|---|
| Read | android.permission.health.READ_POWER | API 34 · U Ext 7 |
| Write | android.permission.health.WRITE_POWER | API 34 · U Ext 7 |
<uses-permission android:name="android.permission.health.READ_POWER" />
<uses-permission android:name="android.permission.health.WRITE_POWER" />import androidx.health.connect.client.permission.HealthPermission
import androidx.health.connect.client.records.PowerRecord
val permissions = setOf(
HealthPermission.getReadPermission(PowerRecord::class),
HealthPermission.getWritePermission(PowerRecord::class),
)The 6 fields of PowerRecord
Types and descriptions as Google’s reference prints them. The range column quotes Google’s own range annotation or sentence; a dash means Google states none, which is not the same as no validation.
| Field | Type | Allowed range | Google’s description |
|---|---|---|---|
endTimemandatory | Instant | — | End time of the record. |
endZoneOffset | ZoneOffset? | — | User experienced zone offset at endTime, or null if unknown. Providing these will help history aggregations results stay consistent should user travel. Queries with user experienced time filters will assume system current zone offset if the information is absent. |
metadatamandatory | Metadata | — | Set of common metadata associated with the written record. |
samplesmandatory | List<PowerRecord.Sample> | — | Google gives no description. |
startTimemandatory | Instant | — | Start time of the record. |
startZoneOffset | ZoneOffset? | — | User experienced zone offset at startTime, or null if unknown. Providing these will help history aggregations results stay consistent should user travel. Queries with user experienced time filters will assume system current zone offset if the information is absent. |
Nested types
PowerRecord.Sample— Represents a single measurement of power.
Aggregate metrics
The AggregateMetric constants Google defines on PowerRecord. The value type is the T in Google’s AggregateMetric<T> signature. Every aggregate metric across all records.
| Metric | Value type | Google’s description |
|---|---|---|
| PowerRecord.POWER_AVG | Power | Metric identifier to retrieve average power from androidx.health.connect.client.aggregate.AggregationResult. |
| PowerRecord.POWER_MAX | Power | Metric identifier to retrieve maximum power from androidx.health.connect.client.aggregate.AggregationResult. |
| PowerRecord.POWER_MIN | Power | Metric identifier to retrieve minimum power from androidx.health.connect.client.aggregate.AggregationResult. |
Google’s read-data guide: “For cumulative types like StepsRecord, use aggregate() instead of readRecords() to avoid double counting from multiple sources and improve accuracy.” and “The aggregation API also contains logic to handle duplicate records, and lessens the chances of rate limiting.”
Read PowerRecord in Kotlin
The shape of Google’s own read example, with PowerRecord and its names filled in. Get the client with HealthConnectClient.getOrCreate(context) after checking getSdkStatus.
import androidx.health.connect.client.HealthConnectClient
import androidx.health.connect.client.records.PowerRecord
import androidx.health.connect.client.request.ReadRecordsRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
suspend fun readPower(
client: HealthConnectClient,
startTime: Instant,
endTime: Instant,
): List<PowerRecord> {
val response = client.readRecords(
ReadRecordsRequest(
PowerRecord::class,
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
)
)
// One page of up to pageSize records (default 1000); follow
// response.pageToken for the rest.
return response.records
}import androidx.health.connect.client.HealthConnectClient
import androidx.health.connect.client.records.PowerRecord
import androidx.health.connect.client.request.AggregateRequest
import androidx.health.connect.client.time.TimeRangeFilter
import java.time.Instant
import androidx.health.connect.client.units.Power
suspend fun aggregatePower(
client: HealthConnectClient,
startTime: Instant,
endTime: Instant,
): Power? {
val response = client.aggregate(
AggregateRequest(
metrics = setOf(PowerRecord.POWER_AVG),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
)
)
// get() is declared as returning a nullable value.
return response[PowerRecord.POWER_AVG]
}Setting up the client, the permission flow and Play Console declaration: integrating Health Connect step by step.
HealthKit counterpart
No verified HealthKit counterpart. The cross-platform matrix only pairs metrics checked against both Apple’s and Google’s documentation, and PowerRecord is not among them yet. A similarly named Apple type may exist on the HealthKit reference, but a name match is not a verified mapping.
The metric on other platforms
This guide lists PowerRecord beside the types on the other platforms this site covers whose own descriptions name the same metric, each quoted, with how each one is read.
Questions
- What permission does PowerRecord need?
- Google's Health Connect data-types table (read 2026-10-03) declares android.permission.health.READ_POWER for reading PowerRecord and android.permission.health.WRITE_POWER for writing it, and says apps must declare permissions in the manifest before requesting them.
- Which aggregate metrics does PowerRecord support?
- Google's Jetpack reference defines 3 on PowerRecord: POWER_AVG (AggregateMetric<Power>), POWER_MAX (AggregateMetric<Power>) and POWER_MIN (AggregateMetric<Power>). Pass them in the metrics set of an AggregateRequest and read each back from the AggregationResult.
- Is PowerRecord an interval, instantaneous or series record?
- Google's data-types table lists PowerRecord as Series, and defines that column as indicating "whether the data is recorded at an instant in time or over an interval". Its mandatory fields are endTime, samples, metadata and startTime.
Other Activity records
Sources checked
- Google — PowerRecord (Jetpack reference) — last updated 2026-06-24 · read 2026-10-03
- Google — Health Connect data types · read 2026-10-03
- Google — HealthPermissions (framework reference) · read 2026-10-03
- Google — Read raw data (Health Connect guide) · read 2026-10-03
Google’s descriptions are quoted for identification; the page layout, the capsule and the cross-platform pairing are AIFitnessAPI’s. Generated from Google’s pages by a script, not typed by hand — the same data is behind every page in the Health Connect reference.