> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withterminal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Units of Measurement

> The units Terminal uses for distance, speed, fuel, and other measurements, and how to change display units in the Dashboard

## Overview

Telematics providers report measurements in different units. One provider sends odometer readings in miles, another in meters, and another lets each fleet choose. Terminal normalizes every measurement to a single standard unit, so a value means the same thing regardless of which provider it came from.

The API always returns these standard units. There are no query parameters or settings that change them. Convert values in your own application if you need to show other units.

## Standard Units

Terminal uses metric units for distance, speed, volume, and temperature. Each measurement type below is a named schema in the [API reference](https://docs.withterminal.com/api-reference), so the unit is part of the field's type.

| Measurement | Unit | Schema |
| - | - | - |
| Distance | Kilometers (km) | `DistanceInKilometers` |
| Speed | Kilometers per hour (km/h) | `SpeedInKPH` |
| Fuel volume | Liters (L) | `VolumeInLiters` |
| Temperature | Degrees Celsius (°C) | `TemperatureInCelsius` |
| Pressure | Pounds per square inch (psi) | `PressureInPSI` |
| Duration | Milliseconds (ms) | `DurationInMS` |
| Heading | Degrees | `HeadingInDegrees` |
| Fuel level, oil level, coolant level | Percentage (0–100) | `FuelPercentage`, `Percentage` |
| Battery voltage | Volts (V) | `VoltageInVolts` |
| Acceleration | G-force (g) | `GForce` |
| Coordinates | Decimal degrees | `Coordinates` |

> [!NOTE]
>
> Pressure is the one exception to metric: Terminal returns pressure in psi.

Speed, volume, temperature, pressure, voltage, and percentage values are rounded to two decimal places. Timestamps are covered separately in [Timestamps](https://docs.withterminal.com/guides/timestamps.md).

### Converting Values

If your users expect imperial units, convert the API values in your application:

| From | To | Formula |
| - | - | - |
| km | mi | `km / 1.609344` |
| km/h | mph | `kph / 1.609344` |
| L | US gal | `liters / 3.785411784` |
| °C | °F | `celsius * 9 / 5 + 32` |

The Dashboard uses the same 1.609344 factor for miles and mph.

For example, a trip with `"distance": 160.93` is 100 miles, and a location with `"speed": 104.61` is 65 mph.

## Display Units in the Dashboard

The [Terminal Dashboard](https://dashboard.withterminal.com) can show distance and speed in metric or imperial units. This is a personal setting: each Dashboard user picks their own units, and the choice follows them across applications and devices.

The setting only changes how values are displayed. It has no effect on API responses, webhooks, or data delivered to [destinations](https://docs.withterminal.com/guides/data-replication.md), which always use the standard units above.

### How to Change Your Units

**1. Open your user profile**

Click your name in the bottom-left corner of the Dashboard, then select **User Profile**. You can also open it from **Settings** > **User Profile**.

![The user menu in the Dashboard sidebar, with User Profile highlighted](https://mintcdn.com/terminal-docs/l4q-af1cOZGNAHyS/images/units/account-menu.png?fit=max\&auto=format\&n=l4q-af1cOZGNAHyS\&q=85\&s=4ab79a83727f9568124947a9e053e33c)

**2. Go to the Units page**

Select **Units** in the menu on the left.

**3. Choose your units**

Under **Distance and speed**, select **Metric (km, km/h)** or **Imperial (mi, mph)**. The change saves immediately.

![The Units page in account settings, with Imperial selected](https://mintcdn.com/terminal-docs/gPVWqsFYhE-P8EHy/images/units/units-setting.png?fit=max\&auto=format\&n=gPVWqsFYhE-P8EHy\&q=85\&s=ba80e6d0619264c95aef182323a0c7cc)

New users see metric units until they change the setting.

### Where the Setting Applies

The Dashboard uses your preference for distance and speed wherever it shows them, including:

* Vehicle and trailer live locations and maps
* Vehicle history: trips, trip start and end markers, and the event sidebar
* Safety event details, such as average speed, maximum speed, and the road speed limit

To see a value in both unit systems, hover over it. The card that appears shows the metric and imperial values, and you can click either one to copy it.

![Hovering over an odometer value shows it in both imperial and metric units](https://mintcdn.com/terminal-docs/gPVWqsFYhE-P8EHy/images/units/units-hover.png?fit=max\&auto=format\&n=gPVWqsFYhE-P8EHy\&q=85\&s=7d7c1b924436a2b13ad965f25ee040ff)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.