Skip to content
AF
Wear OS reference

DataType.VERTICAL_RATIO: Wear OS Health Services data type

Read from Google’s documentation on 2026-10-04 · Google’s DataType reference last updated 2026-08-06

DataType.VERTICAL_RATIO is a DeltaDataType constant of Wear OS Health Services (androidx.health.services.client.data.DataType), declared as DeltaDataType<Double, SampleDataPoint<Double>>: each value is a Double delivered in a SampleDataPoint. Google describes it as: “Vertical oscillation / stride length.” Google's Health Services permissions table does not name it. The same reference defines VERTICAL_RATIO_STATS, an AggregateDataType (AggregateDataType<Double, StatisticalDataPoint<Double>>).

What Google says DataType.VERTICAL_RATIO is

Vertical oscillation / stride length.
For example, a vertical oscillation of 5.0cm and stride length .8m (80 cm) would have a vertical ratio of 0.625.

Quoted from Google’s DataType reference, last updated 2026-08-06, read 2026-10-04.

Declared type

Read from the constant’s declaration in Google’s reference: the data-type class, then the value type and the data-point class it delivers.

Constant
androidx.health.services.client.data.DataType.VERTICAL_RATIO
Declared type
DeltaDataType<Double, SampleDataPoint<Double>>
Data-type class
DeltaDataTypeGoogle: “DataType that represents a granular, non-aggregated point in time.”
Value type
Double
Data-point class
SampleDataPoint
Added in
not printed for this constant; Google’s reference prints “Added in 1.0.0” for the DataType class in androidx.health:health-services-client
Deprecated
not marked deprecated in Google's reference

Permission

Google’s Health Services permissions table does not name DataType.VERTICAL_RATIO, so this page states no permission for it rather than extending the table by analogy.

Above the table, the same page lists the permissions Health Services uses, verbatim:

  • READ_HEART_RATE for reading heart rate information.
  • ACTIVITY_RECOGNITION
  • ACCESS_FINE_LOCATION
  • BODY_SENSORS on Wear OS 5.1 (API level 35) and lower
  • BODY_SENSORS_BACKGROUND between Wear OS 4 (API level 33) and Wear OS 5.1 (API level 35), inclusive

Its aggregate counterpart

By Google’s naming on the same reference (a delta constant NAME beside an aggregate NAME_TOTAL or NAME_STATS): VERTICAL_RATIO_STATS, declared AggregateDataType<Double, StatisticalDataPoint<Double>>. Google describes it as:

Statistics on vertical oscillation / stride length.

Health Connect and HealthKit

No one-to-one pairing. This site’s cross-platform matrix pairs HealthKit types with Health Connect records only, so this page names no counterpart. What it does have is a metric guide: Running Metrics API: Speed, Power, Stride Length and Running Form Data lists DataType.VERTICAL_RATIO beside the types on the other platforms this site covers whose own descriptions name the same metric, each quoted, so you can see where they differ rather than assume they match.

Questions

What permission does DataType.VERTICAL_RATIO need on Wear OS?
Google's Health Services permissions table (read 2026-10-04) does not name DataType.VERTICAL_RATIO, so this page states no permission for it rather than extending the table by analogy.
Is DataType.VERTICAL_RATIO a delta or an aggregate data type?
A delta type: Google's reference declares it as DeltaDataType<Double, SampleDataPoint<Double>>. Google describes DeltaDataType as "DataType that represents a granular, non-aggregated point in time."
What value type does DataType.VERTICAL_RATIO deliver?
Double, in a SampleDataPoint, per the declaration DeltaDataType<Double, SampleDataPoint<Double>>. Google's description: "Vertical oscillation / stride length."
Which aggregate constant goes with DataType.VERTICAL_RATIO?
By Google's naming on the same reference, VERTICAL_RATIO_STATS (AggregateDataType<Double, StatisticalDataPoint<Double>>). Google describes it as: "Statistics on vertical oscillation / stride length."
What else does Google's reference say about DataType.VERTICAL_RATIO?
For example, a vertical oscillation of 5.0cm and stride length .8m (80 cm) would have a vertical ratio of 0.625.

Sources checked

Google’s descriptions are quoted for identification; the page layout and the capsule are AIFitnessAPI’s. Generated by scripts/fetch-health-services-data-types.mjs, not typed by hand — the same data as the full data-type table.

← All Wear OS Health Services data types