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

# Viagens

> Dados gerados pela mobway relacionados as viagens

Uma viagem é definida pelos seguintes casos:

* Início
  * Veículo é ligado
  * Fim de uma parada para reabastecimento ou carregamento
* Fim
  * Veículo é desligado
  * Início de uma parada para reabastecimento ou carregamento

## start\_date\_time

Data e Horário de Início

* Descrição: data e horário de início da viagem
* Formato: yyyy-mm-ddThh:mm:ss
* Exemplo:

```json theme={null}
{
  "start_date_time": "2023-08-09T20:02:45"
}
```

## end\_date\_time

Data e Horário de Fim

* Descrição: data e horário de fim da viagem
* Formato: yyyy-mm-ddThh:mm:ss
* Exemplo:

```json theme={null}
{
  "end_date_time": "2023-08-09T20:02:45"
}
```

## duration

Duração

* Descrição: duração da viagem
* Formato: hh:mm:ss
* Exemplo:

```json theme={null}
{
  "duration": "02:02:45"
}
```

## avg\_speed

Velocidade Média

* Descrição: velocidade média da viagem
* Formato: numérico
* Unidade: km/h
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do odometro do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "avg_speed": 54.45
}
```

## max\_speed

Velocidade Máxima

* Descrição: velocidade máxima da viagem
* Formato: numérico
* Unidade: km/h
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do dado de velocidade do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "max_speed": 148.05
}
```

<Info>
  O valor calculado não representa totalmente a realidade, uma vez que está limitado às amostras de velocidade enviadas pelo veículo. Quanto maior for a frequência de envio, mais confiável será o valor calculado.

  Por este mesmo motivo, pode não ser possível identificar a velocidade máxima. Quando o valor identificado é menor que a valocidade média, é considerado como um erro, e não é apresentado nenhum valor.
</Info>

## start\_odometer

Odômetro Inicial

* Descrição: odômetro inicial da viagem
* Formato: numérico
* Unidade: km
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do odometro do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "start_odometer": 56234.23
}
```

## final\_odometer

Odômetro Final

* Descrição: odômetro final da viagem
* Formato: numérico
* Unidade: km
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do odometro do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "final_odometer": 61274.80
}
```

## distance

Distância

* Descrição: distância percorrida durante a viagem
* Formato: numérico
* Unidade: km
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do odometro do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "distance": 3.54
}
```

## avg\_fuel\_consumption

Consumo de Combustível

* Descrição: consumo médio de combustível da viagem
* Formato: numérico
* Unidade: km/l
* Casas decimais: 2
  * Apesar do valor apresentar 2 casas demais, a precisão é limitada pela precisão do odometro e do dado do nível de combustível do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "avg_fuel_consumption": 8.95
}
```

## start\_latitude

Latitude Inicial

* Descrição: latitude do início da viagem
* Formato: numérico
* Unidade: °
* Casas decimais: 6
  * Apesar do valor apresentar 6 casas decimais, a precisão é limitada pela precisão do dado de latitude do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "start_latitude": 56.234045
}
```

## end\_latitude

Latitude Final

* Descrição: latitude do fim da viagem
* Formato: numérico
* Unidade: °
* Casas decimais: 6
  * Apesar do valor apresentar 6 casas decimais, a precisão é limitada pela precisão do dado de latitude do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "end_latitude": 56.446475
}
```

## start\_longitude

Longitude Inicial

* Descrição: longitude do início da viagem
* Formato: numérico
* Unidade: °
* Casas decimais: 6
  * Apesar do valor apresentar 6 casas decimais, a precisão é limitada pela precisão do dado de longitude do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "start_longitude": 36.453095
}
```

## end\_longitude

Longitude Final

* Descrição: longitude do fim da viagem
* Formato: numérico
* Unidade: °
* Casas decimais: 6
  * Apesar do valor apresentar 6 casas decimais, a precisão é limitada pela precisão do dado de longitude do veículo, variando de acordo com a montadora
* Exemplo:

```json theme={null}
{
  "end_longitude": 36.579531
}
```