A Especificação Geral sobre Feeds de Transporte Público (GTFS) é um formato que já existe para programações de transporte público e informações geográficas relacionadas. A integração baseada em GTFS usa a GTFS e as extensões de venda de passagens do Google Transit para realizar a etapa 1 da integração do transporte, fornecendo um feed de dados estáticos.
A API Partner Server usa identificadores como o ticketing_trip_id
fornecidos pela GTFS. Portanto, é preciso ter um Feed GTFS válido para usar a API.
Siga as etapas abaixo para fornecer um Feed GTFS válido.
Como criar o Feed GTFS estático
Para que os usuários pesquisem e encontrem trajetos e horários de viagens intermunicipais usando a integração com base na GTFS, é obrigatório fornecer um Feed GTFS dos parceiros. Os dados do Feed GTFS contêm informações estáticas sobre programações, trajetos e venda de passagens, que são usadas pelo Google para se conectar à API Partner.
1. Como criar uma conta de transporte público
Acesse Começar no Google Transit e use o formulário para solicitar uma conta, caso ainda não tenha feito isso. Quando a revisão for concluída, uma conta será criada, e o painel da GTFS será disponibilizado. Consulte Acessar o painel do parceiro do Google Transit para saber como acessar e configurar o painel.
2. Como criar seu Feed GTFS com extensões
Crie o Feed GTFS, incluindo as seções obrigatórias das extensões de passagens do Google Transit. Confira mais detalhes na seção de extensões da GTFS. Para garantir a melhor experiência do usuário, leia e siga os requisitos e as práticas recomendadas de qualidade da GTFS.
3. Nomear o feed
A convenção de nomenclatura do feed recomendada é: agency-region-country_code
, por exemplo, gbus-ca-us
, ou agency-country_code
se a região não for obrigatória, por exemplo, gbus-br
. Para feeds de teste, a convenção de nomenclatura recomendada é: test-agency-country_code
. Por exemplo, test-gbus-ca-us
ou test-gbus-br
.
4. Como fazer upload e atualizar seu feed
Siga o guia Publicar seus dados do Feed GTFS para fazer upload e atualizar essas informações. Sempre que os dados são enviados, eles passam por uma validação automática (levando até 30 minutos) e um relatório de validação é gerado. Corrija todos os erros antes de prosseguir para a próxima etapa.
5. Solicitar ambiente de visualização
Depois que os dados da GTFS passarem pela validação, siga as instruções em Testar os dados do feed usando a visualização particular para ativar o ambiente de visualização. Depois de ativados, os dados de feed enviados ficam visíveis no Google Maps de usuários permitidos. Agora, os dados da GTFS também podem ser usados para testes com o servidor da API.
6. Solicitando a revisão do controle de qualidade de lançamento
Assim que os avisos problemáticos e os problemas de qualidade de dados forem resolvidos no ambiente de visualização, é necessário fazer uma revisão final do controle de qualidade do Google antes do lançamento público. Os problemas encontrados no processo de revisão do controle de qualidade ficam visíveis no painel. Assim que todos os problemas pendentes forem resolvidos, a GTFS estará pronta para lançamento.
7. Como lançar o feed
Consulte Lançar seu feed para instruções sobre como disponibilizá-lo para o público.