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

# Location

> Data related to geolocation and orientation

## latitude

Latitude

* Description: geographic coordinate that indicates the position along the Earth's north-south axis
* Format: numeric
* Unit: °
* Decimal places: 7
  * Data processed by mobway will always have up to 7 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 7 decimal places when it ends in 0 due to automatic float formatting
* Range: -90° to 90°
  * The latitude range was defined based on the boundary values by definition
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "latitude": {
    "value": 93.7435821,
    "flag": "out of range"
  }
}
```

* Minimum and maximum variation: - 0.001° and 0.001° per second
  * The minimum and maximum latitude variations were defined based on the distance traveled by a vehicle at 400 km/h, considering a trajectory along the Earth's north-south axis and applying a safety margin
  * Data with a variation outside the allowed limit compared to the previous data point is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "latitude": {
    "value": 14.3181722,
    "flag": "variation out of limit"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "latitude": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "latitude": 34.0567236
}
```

## longitude

Longitude

* Description: geographic coordinate that indicates the position along the Earth's east-west axis
* Format: numeric
* Unit: °
* Decimal places: 7
  * Data processed by mobway will always have up to 7 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 7 decimal places when it ends in 0 due to automatic float formatting
* Range: -180° to 180°
  * The longitude range was defined based on the boundary values by definition
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "longitude": {
    "value": -191.3564382,
    "flag": "out of range"
  }
}
```

* Minimum and maximum variation: - 0.001° and 0.001° per second
  * The minimum and maximum longitude variations were defined based on the distance traveled by a vehicle at 400 km/h, considering a trajectory along the Earth's east-west axis and applying a safety margin
  * Data with a variation outside the allowed limit compared to the previous data point is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "longitude": {
    "value": 43.8127712,
    "flag": "variation out of limit"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "longitude": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "longitude": -118.2451370
}
```

## altitude

Altitude

* Description: vehicle elevation relative to sea level
* Format: numeric
* Unit: m
* Decimal places: 2
  * Data processed by mobway will always have up to 2 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 2 decimal places when it ends in 0 due to automatic float formatting
* Range: -500 to 9000 m
  * The altitude range was defined based on the boundary values found on Earth
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "altitude": {
    "value": 11191.32,
    "flag": "out of range"
  }
}
```

* Minimum and maximum variation: - 30 m and 30 m per second
  * The minimum and maximum altitude variations were defined based on the distance traveled by a vehicle at 400 km/h, considering a 15° slope and applying a safety margin
  * Data with a variation outside the allowed limit compared to the previous data point is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "altitude": {
    "value": 2343.87,
    "flag": "variation out of limit"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "altitude": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "altitude": 586.10
}
```

## heading

Heading

* Description: vehicle orientation relative to the cardinal directions
  * 0º: North
  * 90º: East
  * 180º: South
  * 270º: West
* Format: numeric
* Unit: °
* Decimal places: 2
  * The processed data will always have 2 decimal places. However, the precision of the original data depends on the automaker
* Range: 0º to 360º
  * The heading range was defined based on the boundary values by definition
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "heading": {
    "value": 367.89,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "heading": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "heading": 357.92
}
```

## geolocation\_horizontal\_error

Geolocation Horizontal Error

* Description: error value for latitude and longitude measurements
* Format: numeric
* Unit: m
* Decimal places: 2
  * Data processed by mobway will always have up to 2 decimal places. However, the precision of the original data depends on the automaker. The data may have fewer than 2 decimal places when it ends in 0 due to automatic float formatting
* Range: 0 to 100 m
  * The geolocation horizontal error range was defined based on values typically found in GPS data, applying a safety margin
  * Data outside this range is considered invalid
  * The value is replaced with a null value
  * A flag is generated indicating the error and the original value, in the following format:

```json theme={null}
{
  "geolocation_horizontal_error": {
    "value": 132.00,
    "flag": "out of range"
  }
}
```

* Missing data
  * A flag is generated indicating that the data was originally missing, in the following format:

```json theme={null}
{
  "geolocation_horizontal_error": {
    "flag": "missing data"
  }
}
```

* Example:

```json theme={null}
{
  "geolocation_horizontal_error": 3.00
}
```

## geolocation\_anonymization

Geolocation Anonymization

* Description: indicates whether geolocation data is anonymized
* Format: categorical
* Values:
  * anonymized (anonymized)
    * Description: indicates that geolocation data is anonymized
  * not anonymized (not anonymized)
    * Description: indicates that geolocation data is not anonymized
* Example:

```json theme={null}
{
  "geolocation_anonymization": "anonymized"
}
```