Circulações
Monitorização de circulações em tempo real.
Visão Geral
Este módulo é responsável por transformar a informação contida nos GTFS estáticos (planos de operação) em circulações e analisar cada uma individualmente, combinando as posições GPS dos veículos e as transações de bilhética APEX.
Chamamos a uma circulação de ride, para diferenciar de trip. Todas as rides têm a mesma estrutura:
- informações planeadas do GTFS estático: hora de início planeada, percurso, destino, etc.
- informações da componente em tempo real: hora de início observada, motorista, etc.
- informações da componente de bilhética: número de passageiros transportados, vendas a bordo, etc.
- resultado das análises: se chegou a horas, se serviu todas as paragens, etc.
Conversão UNIX timestamp para hora - [Célula com timestamp]/1000/86400 + DATE(1970,1,1)
Dados disponíveis
| Campo | Descrição | Origem | Exemplo |
|---|---|---|---|
| _id | ID único da ride | GTFS | O9AXB-41-20260302-1001_0_1_0700_0729_0_1 |
| agency_id | Código do operador | GTFS | 41 |
| apex_locations_qty | Quantidade de transações de localização APEX | APEX | - |
| apex_on_board_refunds_amount | Valor monetário, em cêntimos de euro, dos reembolsos de vendas de bilhetes de bordo | APEX | - |
| apex_on_board_refunds_qty | Quantidade de reembolsos realizados | APEX | - |
| apex_on_board_sales_amount | Valor monetário, em cêntimos de euro, das vendas de bilhetes de bordo | APEX | - |
| apex_on_board_sales_qty | Quantidade de vendas de bilhetes de bordo | APEX | - |
| apex_validations_qty | Quantidade de validações de passes ou títulos ocasionais, válidas e inválidas | APEX | - |
| created_at | Data de criação da Ride, em Unix Timestamp (campo interno do GO) | Base de Dados | 10000000 |
| driver_ids | IDs dos motoristas que abriram a circulação. Na grande maioria dos casos este campo terá apenas um valor, mas pode ter mais se vários motoristas partilharam a circulação. | GTFS-RT | [1234, 5678] |
| end_time_observed | Hora de fim observada em Unix Timestamp | GTFS-RT | 10000000 |
| end_time_scheduled | Hora de fim planeada em Unix Timestamp | GTFS | 10000000 |
| extension_observed | Extensão percorrida com base no valor reportado no odómetro | GTFS-RT | |
| extension_scheduled | extensão prevista em plano | GTFS | |
| hashed_shape_id | Identificador do percurso | GTFS | |
| hashed_trip_id | Identificador da sequência de paragens | GTFS | |
| headsign | Bandeira do veículo (destino/percurso) | GTFS | |
| line_id | ID da linha | GTFS | |
| operational_date | Data Operacional | GTFS | |
| passengers_estimated | Nº total de passageiros estimados pelos sensores | ||
| passengers_observed | Nº total de passageiros observados | ||
| passengers_observed_on_board_sales_amount | "apex_on_board_refunds_amount" - "apex_on_board_sales_amount" | ||
| passengers_observed_on_board_sales_qty | Nº de títulos vendidos durante a viagem | ||
| passengers_observed_prepaid_amount | Valor monetário total da receita gerada em zappings | ||
| passengers_observed_prepaid_qty | Nº de bilhetes validados de zapping | ||
| passengers_observed_subscription_qty | Nº de bilhetes validados tipo pass | ||
| pattern_id | Id do percurso | ||
| plan_id | Id do plano (id interno GO) | ||
| route_id | Id da rota | ||
| seen_first_at | Hora do primeiro evento recebido (UNIX timestamp) | ||
| seen_last_at | Hora do último evento recebido (UNIX timestamp) | ||
| start_time_observed | hora de início observada (UNIX timestamp) | [[Algoritmo de deteção início-fim viagem#Deteção início de viagem]] | |
| start_time_scheduled | hora de início planeada (UNIX timestamp) | ||
| status | Estado do processamento da circulação | ||
| system_status | Estado global da circulação - "complete" quando finalizada com sucesso | ||
| trip_id | Id da circulação | ||
| updated_at | Timestamp da última atualização do registo | ||
| vehicle_ids | lista de ids de veículos que tiveram a circulação selecionada |