---
id: "bearing"
kind: "datatype"
status: "draft"
is_pii: false
name: "Bearing (heading in degrees)"
regexp: "^(?:360(?:[.,]0+)?|3[0-5]\\d(?:[.,]\\d+)?|[12]?\\d{1,2}(?:[.,]\\d+)?)$"
categories: ["geo", "transport", "values"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/bearing"
---

# Bearing (heading in degrees) (`bearing`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Direction a vehicle, a vessel or a person travels or faces, in degrees clockwise from true north: 0 is north and 90 is east. GPS receivers and the vehicle positions of GTFS Realtime feeds report it as a decimal number (126.87); fleet tracking exports call it bearing, heading or course. A number from 0 to 360 alone can be any angle, so a value is a bearing only in a field named after it; a compass point in letters (NE) is compass_point, the direction a wind blows from wind_direction.

- Parent datatype: [`numeric`](https://registry.apicrafter.io/datatype/numeric.md)
- Personal data (PII): no
- Categories: Geographic identifiers (geo), Transportation (transport), All measurable values (percentage, amount and e.t.c) (values)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^(?:360(?:[.,]0+)?|3[0-5]\d(?:[.,]\d+)?|[12]?\d{1,2}(?:[.,]\d+)?)$
```

## Examples

- `126.8724594116211` — bearing of a Canberra Metro light rail vehicle (GTFS Realtime archive)
- `0` — north
- `270` — west
- `NE` (invalid example) — a compass point
- `361` (invalid example)

## Metacrafter rules

1 rules: 1 match the field name, 0 match values.

- `bearingbyname` (field, `common/transport.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Курс (азимут движения, градусы)

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Bearing_(angle)>
- doc: <https://gtfs.org/documentation/realtime/reference/>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/bearing.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/transport/bearing.yaml>
