Integração baseada na GTFS

A Especificação Geral sobre Feeds de Transporte Público (GTFS) é um formato atual para horários de transporte público e informações geográficas relacionadas. A integração baseada em GTFS usa a GTFS e as extensões de emissão de passagens do Google Transit para realizar a etapa 1 da integração de transporte de viagens, fornecendo um feed de dados estáticos.

A API Partner Server usa identificadores como o ticketing_trip_id fornecido pelo GTFS. Portanto, um feed GTFS válido precisa existir antes que a API possa ser usada. Siga as etapas abaixo para fornecer um feed GTFS válido.

Como criar o feed GTFS estático

Para permitir que os usuários pesquisem e encontrem rotas e horários de viagens intermunicipais usando a integração baseada em GTFS, é necessário um feed GTFS dos parceiros. Os dados do feed GTFS contêm informações estáticas sobre horários, trajetos e bilhetes, que são usadas pelo Google para se conectar à API do parceiro.

1. Como criar uma conta de transporte

Se ainda não tiver feito isso, acesse Começar a usar o Google Transit e use o formulário para solicitar uma conta. Depois que a revisão for concluída, uma conta será criada e o painel do GTFS será disponibilizado. Consulte Acessar o painel do parceiro do Google Transit para detalhes sobre como acessar e configurar o painel.

2. Como criar seu Feed GTFS com extensões

Crie seu feed GTFS, incluindo as seções obrigatórias das extensões de venda de passagens do Google Transit. Para mais detalhes, consulte a seção de extensões da GTFS. Para garantir a melhor experiência do usuário, leia e siga os requisitos de qualidade e as práticas recomendadas da GTFS.

3. Nomear seu feed

A convenção de nomenclatura de feed recomendada é: agency-region-country_code, como 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, como test-gbus-ca-us ou test-gbus-br.

4. Como fazer upload e atualizar seu feed

Siga o guia Publicar os dados do seu Feed GTFS para fazer upload e atualizar seus dados do GTFS. Cada vez que os dados são enviados, eles passam por uma validação automatizada (que leva até 30 minutos), e um relatório de validação é gerado. Corrija os erros antes de passar para a próxima etapa.

5. Solicitar ambiente de visualização

Depois que os dados do 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 do feed enviados ficam visíveis no Google Maps dos usuários permitidos. Neste ponto, os dados do GTFS também podem ser usados para testes com o servidor da API.

6. Solicitar revisão de controle de qualidade do lançamento

Depois que todos os avisos problemáticos e problemas de qualidade de dados forem resolvidos no ambiente de prévia, será necessária uma revisão final de controle de qualidade do Google antes do lançamento público. Os problemas encontrados no processo de revisão de controle de qualidade vão ficar visíveis no painel. Depois que todos os problemas pendentes forem resolvidos, o GTFS estará pronto para lançamento.

7. Como lançar o feed

Consulte Publicar seu feed para instruções sobre como disponibilizar o feed ao público.