A posição de um veículo é usada para fornecer informações geradas automaticamente sobre a localização do veículo, como por um dispositivo de GPS a bordo. Uma única posição deve ser fornecida para cada veículo capaz de fornecer essa informação.
A viagem que o veículo está realizando deve ser informada usando um descritor de viagem. Você pode especificar um descritor de veículo, que determina a posição exata do transporte a que se referem as atualizações. A documentação é fornecida abaixo.
Pode ser fornecido um carimbo de data e hora mostrando quando a leitura de posição foi feita. Esse carimbo de data/hora é diferente daquele no cabeçalho do feed, que mostra a hora em que a mensagem foi gerada pelo servidor.
A passagem atual também pode ser indicada (como stop_sequence ou stop_id) para determinar a parada a que o veículo se dirige ou em que está no momento.
Posição
O campo position contém os dados de local na VehiclePosition. A latitude e a longitude são obrigatórias, e os outros campos são opcionais. Esses tipos de dados são:
- Latitude: graus Norte, no sistema de coordenadas WGS-84
- Longitude: graus Leste, no sistema de coordenadas WGS-84
- Rumo: direção que o veículo está seguindo
- Odômetro: a distância que o veículo percorreu
- Velocidade: velocidade no momento medida pelo veículo, em metros por segundo
Nível de congestionamento
A posição do veículo também permite que a agência especifique o nível de congestionamento que o veículo está enfrentando no momento. O congestionamento pode ser classificado nas seguintes categorias:
- Nível de congestionamento desconhecido
- Fluxo estável
- Paradas frequentes
- Congestionamento
- Congestionamento grave
É responsabilidade da agência decidir como um tipo de congestionamento deve ser classificado. Nossa orientação é que "Congestionamento grave" só seja usado em condições em que o tráfego está tão congestionado que as pessoas estão saindo dos seus carros.
Status de ocupação
A posição do veículo também permite que a agência especifique o grau de ocupação de passageiros do veículo. O status de ocupação pode ser classificado nas seguintes categorias:
- Vazio
- Muitos assentos disponíveis
- Poucos assentos disponíveis
- Não há mais assentos vagos
- Pouco espaço para ficar de pé
- Cheio
- Não aceita passageiros
Este campo ainda é experimental e está sujeito a alterações. Ele pode ser formalmente incluído no futuro.
Status de parada do veículo
O status de parada do veículo informa melhor sobre o status de um veículo em relação a uma parada que está se aproximando ou em que ele esteja. Ele pode ter estes valores:
- Chegando em: o veículo está prestes a chegar na parada em questão
- Parado em: o veículo está parado na parada em questão
- Em direção a: a parada em questão é a próxima parada do veículo - padrão
Descritor do veículo
O descritor do veículo descreve um veículo físico exato e pode conter qualquer um destes atributos:
- Código: sistema interno de identificação do veículo. Deve ser exclusiva.
- Etiqueta: uma etiqueta visível ao usuário, como, por exemplo, o nome de um trem
- Placa: a placa real do veículo