Entidades de feed

A GTFS Realtime oferece suporte a três tipos diferentes de dados em tempo real: atualizações de viagens, alertas de serviço e posições de veículos. O Google Transit recomenda que cada feed em tempo real tenha apenas um tipo de entidade. Quando for o caso, também recomendamos que as empresas separem o feed em tempo real em subtipos de entidade com base no tipo de trajeto, na empresa ou em outros critérios.

Por exemplo, a entidade de atualizações de viagens pode ter uma subcategoria de tipo de trajeto. Se uma empresa precisar dar essas informações para todos os serviços de transporte público, ela poderá incluir atualizações sobre serviços de ônibus em um feed e sobre metrô em outro.

Para evitar um ponto único de falha, separe o feed em tempo real em tipos únicos e partes menores. Assim, uma parte da entrada incorreta não afeta o feed inteiro.

Para transformar um feed mesclado em tempo real em um feed por esquema de tipo, use esta ferramenta de exemplo.

As seções abaixo documentam os três tipos de feed da GTFS Realtime.

Atualizações de viagens

Exemplo: "O ônibus X está atrasado em 5 minutos."

As atualizações de viagens representam variações nos horários. Esperamos receber esse tipo de informação para todas as viagens que aceitam atualizações em tempo real. Elas oferecem uma previsão para os horários de partida e de chegada nas paradas do trajeto. As atualizações de viagens também dão informações em casos mais complexos, por exemplo, quando viagens são canceladas, adicionadas aos horários ou redirecionadas.

Para mais detalhes, consulte Atualizações de viagens.

Alertas de serviço

Exemplo: "A estação Y está fechada devido a obras".

Os alertas de serviço representam problemas maiores com uma entidade específica. Esses alertas geralmente incluem texto que descreve o problema. Para coletar dados mais estruturados que nos ajudam a entender quem o alerta de serviço afeta, também aceitamos URLs.

Alguns exemplos de alertas de serviço são problemas com estações, linhas ou toda a rede.

Para mais detalhes, consulte Alertas de serviço.

Posições de veículos

Exemplo: "Este ônibus está na posição X às Y".

A posição inclui alguns dados básicos sobre um veículo específico na rede. Os dados mais importantes são a latitude e a longitude da posição dele, mas também podemos usar informações sobre as leituras atuais de velocidade e do odômetro do veículo.

Para mais detalhes, consulte Posição de veículos.