> ## 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.

# Localização

> Dados relacionados à geolocalização e orientação

## latitude

Latitude

* Descrição: coordenada geográfica que indica a posição no sentido norte-sul da terra
* Formato: numérico
* Unidade: °
* Casas decimais: 7
  * O dado tratado pela mobway sempre terá no máximo 7 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 7 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Faixa: -90° a 90°
  * A faixa de latitude foi definida com base nos valores limite por definição
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Variação mínima e máxima: - 0.001° e 0.001° por segundo
  * As variações mínima e máxima de latitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma trajetória no sentido norte-sul da terra, considerando uma margem de segurança
  * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes
  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## longitude

Longitude

* Descrição: coordenada geográfica que indica a posição no sentido leste-oeste da terra
* Formato: numérico
* Unidade: °
* Casas decimais: 7
  * O dado tratado pela mobway sempre terá no máximo 7 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 7 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Faixa: -180° a 180°
  * A faixa de longitude foi definida com base nos valores limite por definição
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Variação mínima e máxima: - 0.001° e 0.001° por segundo
  * As variações mínima e máxima de longitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma trajetória no sentido leste-oeste da terra, considerando uma margem de segurança
  * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes

  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## altitude

Altitude

* Descrição: elevação do veículo em relação ao mar
* Formato: numérico
* Unidade: m
* Casas decimais: 2
  * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Faixa: -500 a 9000 m
  * A faixa de altitude foi definida com base nos valores limite encontrados na terra
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Variação mínima e máxima: - 30 m e 30 m por segundo
  * As variações mínima e máxima de altitude foram definidas com base na distância percorrida por um veículo a 400 km/h, considerando uma inclinação de 15°, considerando uma margem de segurança
  * Dados com variação fora do limite permitido em relação ao dado anterior são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes

  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## heading

Orientação

* Descrição: orientação do veículo em relação aos pontos cardeais
  * 0º: Norte
  * 90º: Leste
  * 180º: Sul
  * 270º: Oeste
* Formato: numérico
* Unidade: °
* Casas decimais: 2
  * O dado tratado sempre terá 2 casas decimais, porém a precisão do dado original depende da montadora
* Faixa: 0º a 360º
  * A faixa do sentido de orientação foi definida com base nos valores limite por definição
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes
  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## geolocation\_horizontal\_error

Erro Horizontal da Geolocalização

* Descrição:  valor do erro das medidas de latitude e longitude
* Formato: numérico
* Unidade: m
* Casas decimais: 2
  * O dado tratado pela mobway sempre terá no máximo 2 casas decimais, porém a precisão do dado original depende da montadora. O dado apresentará menos de 2 casas decimais, quando for terminado em 0, devido a formatação automática do formato float
* Faixa: 0 a 100 m
  * A faixa do erro horizontal da geolocalização foi definida com base nos valores geralmente encontrados em GPS, considerando uma margem de segurança
  * Dados fora desta faixa são considerados como errôneos
  * O valor é substituído por um valor nulo
  * É gerada uma flag indicando o erro e o valor original, no seguinte formato:

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

* Dados faltantes

  * É gerada uma flag indicando que o dado originalmente estava faltando, no seguinte formato:

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

* Exemplo:

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

## geolocation\_anonymization

Anonimização da Geolocalização

* Descrição: indica se os dados de geolocalização estão anonimizados

* Formato: categórico

* Valores:
  * anonymized (anonimizado)
    * Descrição: indica que os dados de geolocalização estão anonimizados
  * not anonymized (não anonimizado)
    * Descrição: indica que os dados de geolocalização não estão anonimizados

* Exemplo:

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