Vehicle properties
Fuel & energy
RANGE_REMAINING
What it is
Range remaining
Meters remaining of fuel and charge. Range remaining shall account for all energy sources in a vehicle. For example, a hybrid car's range will be the sum of the ranges based on fuel and battery.
This property is defined as VehiclePropertyAccess.READ_WRITE because a navigation app could update the range if it has a more accurate estimate based on the upcoming route. However, this property can be implemented as VehiclePropertyAccess.READ only at the OEM's discretion.
How the ID is built
A property ID is a 32-bit value packing four fields. Reading 0x11600308 apart:
| Field | Mask | Value | Means |
|---|---|---|---|
| Group | 0xf0000000 | 0x10000000 | SYSTEM |
| Area | 0x0f000000 | 0x01000000 | GLOBAL |
| Type | 0x00ff0000 | 0x00600000 | FLOAT |
| Ordinal | 0x0000ffff | 0x00000308 | 0x308 |
Reading it from an app
CarPropertyManager mgr = (CarPropertyManager)
car.getCarManager(Car.PROPERTY_SERVICE);
mgr.registerCallback(callback,
VehiclePropertyIds.RANGE_REMAINING,
CarPropertyManager.SENSOR_RATE_ONCHANGE);This property can be read and written, though an OEM may implement it as read-only. It changes continuously, so subscribe at a sample rate rather than polling.