Siga estas diretrizes para atender aos padrões de qualidade de dados e oferecer a melhor experiência possível para os usuários do Google Transit.
Acesse os resultados do controle de qualidade
É possível acessar os resultados de controle de qualidade do seu feed em tempo real no painel do parceiro do Google Transit. Esse relatório de validação diária contém informações sobre as métricas de qualidade de dados e inclui ajuda para resolver problemas.
Conheça as métricas essenciais de qualidade
Para ajudar a manter informações confiáveis sobre o transporte público para os usuários do Google Transit, há três métricas de qualidade principais referentes a dados em tempo real:
- Qualidade: o que os usuários precisam
- Estabilidade: quando os usuários precisam disso
- Cobertura: onde os usuários precisam
1. Qualidade
Trabalhamos muito para aderir totalmente à Especificação Geral sobre Feeds de Transporte Público (GTFS), que é administrada pela comunidade, e otimizar a experiência do usuário. Saiba mais sobre nossos padrões no arquivo da GTFS no GitHub (link em inglês). Se as suas informações não estiverem de acordo com a especificação da GTFS Realtime, os erros de aviso e bloqueio serão listados no relatório de validação, como:
- Inconsistências com o feed estático
- Formato e precisão das entidades
- Presença de campos obrigatórios
- Períodos que correspondem aos valores esperados do feed estático
Saiba mais sobre feeds e entidades na planilha de referência da GTFS Realtime (link em inglês).
Tolerâncias e expectativas
- A tolerância para avisos e erros referentes à porcentagem de entidades afetadas é de 2% e 0%, respectivamente. Há mais detalhes disponíveis no relatório de validação.
- É esperada uma distribuição regular, estável e cíclica de entidades do feed ao longo do tempo, sem picos ou quedas no número de entidades (por exemplo, o número de veículos).
- Os alertas de serviço exigem linguagem adequada, consistência e informações de causa e efeito.
Solução de problemas
Problemas com tolerâncias e expectativas podem resultar na exibição de dados incompletos ou imprecisos aos usuários, o que geralmente bloqueia lançamentos. Possíveis causas e correções estão incluídas no relatório. Saiba como monitorar seus feeds em tempo real.
2. Estabilidade
Exigimos um fluxo consistente e semanal de feeds de dados com push e pull de informações para oferecer a melhor experiência aos usuários. Um tempo de inatividade é esperado durante a configuração e a realização de melhorias no sistema, mas os sistemas em tempo real precisam permanecer estáveis e oferecer dados analisáveis ao longo do ano (incluindo fins de semana e feriados).
Erros de tempo de atividade do servidor
O Google monitora a estabilidade dos feeds de entrada por 8 a 16 dias. Erros em formatos de dados e protobuffers corrompidos contam como pushes ou pulls com falha (por exemplo, não aceitamos código ASCII em produção). No relatório de validação diária, esperamos encontrar ocorrências de 1% ou menos dos seguintes tipos de erros de tempo de atividade do servidor:
- Erros de protobuf (formato e análise)
- Erros de fetcher
Vários erros consecutivos de fetch geram uma experiência negativa para o usuário, são sinalizados, bloqueiam lançamentos e causam a suspensão do feed.
Idade do feed
Os carimbos de data/hora do feed são usados para calcular a idade dele e são medidos em segundos desde a época (UTC). A idade do feed não deve ser superior a 90 segundos no momento em que o recebermos. A idade do feed para alertas de serviço pode ser de até 10 minutos.
3. Cobertura
O Google Transit fornece aos usuários informações completas para viagens em solo. Mais especificamente, o Google Transit oferece o seguinte:
- Atualizações de viagens
- Dados completos de áreas perto dos centros urbanos e com trânsito intenso
- Atualizações recebidas do feed estático para a maioria das viagens, principalmente trajetos centrais e movimentados (cobertura total e parcial)
- Dados precisos e atualizados sempre que possível com alertas de serviço e posições de veículos