Neste guia, explicamos como fazer a integração com o Google para oferecer aos usuários uma experiência de pesquisa de transporte integrada em várias plataformas do Google, incluindo o Google Maps e a Pesquisa Google. Em geral, as principais especificações de integração incluem:
- Duas opções para fornecer dados estáticos:
- Integração baseada na GTFS: forneça um feed da GTFS com extensões de bilhetagem nos casos em que você é o provedor dos dados de programação. Temos alguns requisitos adicionais para a integração baseada no GTFS.
- Integração somente de paradas: forneça apenas uma lista de paradas para casos em que o Google já tem os dados de horários de outra fonte.
- Uma especificação da API de parceiro para fornecer dados dinâmicos:
- Configuração de parceiro: forneça informações do parceiro, como branding e detalhes de contato.
- Servidor do parceiro: implementação de servidores que oferecem suporte às APIs do servidor do parceiro.
Etapas para integração com o Travel Transport
Confira abaixo uma visão geral das etapas necessárias para criar e testar um sistema de ponta a ponta que ofereça suporte aos recursos de transporte do Google. Há três etapas principais para a integração:
- Revisar os requisitos de participação.
- Fornecer um feed de dados estáticos ao Google.
- Suporte à API Travel Transport para ativar consultas dinâmicas de dados que mudam rapidamente, como preços e disponibilidade. A API usa identificadores fornecidos pelo feed de dados estáticos da etapa 1, por exemplo, o
ticketing_stop_id, para identificar paradas.
1. Requisitos de participação
A unidade de recursos de transporte do Google mostra itinerários e opções de reserva com preços. Para que sua oferta apareça na lista, é necessário ter um link de boa qualidade e um preço final correspondente. Para mais detalhes, consulte nossos requisitos de participação.
2. Como fornecer um feed de dados estáticos
Há duas opções para fornecer dados estáticos, cada uma aplicável em circunstâncias específicas. O principal critério para decidir qual opção usar é se você é o provedor dos dados de programação das conexões de trânsito para as quais quer oferecer funcionalidade de reserva. A maneira mais fácil de verificar se o Google já tem dados de horários é tentar encontrar conexões de uma determinada operadora no Google Maps.
| Recurso | Integração baseada na GTFS | Integração somente de parada |
|---|---|---|
| Caso de uso | Você já fornece a GTFS com horários e informações de venda de passagens. | O Google já tem os dados de programação do operador de outra fonte. |
| Dados obrigatórios | Os IDs da GTFS. | Uma lista dos seus IDs de parada, com as coordenadas geográficas. |
| Esforço | Baixo | Médio |
A opção 1 se aplica se você for o provedor do feed GTFS de um operador. Nesse caso, também é necessário configurar um feed GTFS para fornecer as informações de programação ao Google primeiro. Em seguida, siga as instruções na seção de integração baseada no GTFS.
A opção 2 se aplica se o Google já recebe dados de programação do operador de uma fonte diferente. Nesse caso, não precisamos das informações completas da programação, mas ainda precisamos de uma lista dos IDs de parada que podemos usar na API Travel Transport (veja abaixo). Para fornecer a lista de paradas, siga as instruções na seção de integração somente de paradas.
3. Suporte à API Travel Transport
Para ser listado como um parceiro de reservas com preços na Unidade de transporte, o Google precisa conseguir buscar as informações mais recentes sobre preços e disponibilidade dos parceiros. Para isso, os parceiros precisam fornecer um serviço que implemente as APIs do servidor de parceiro.
3.1. Como implementar a API Partner Server
Confira detalhes sobre como implementar a API Partner Server na referência da API e no guia do servidor do parceiro. A API permite que o Google receba as informações de preços e disponibilidade mais atualizadas dos parceiros e será chamada pelo Google para:
- Gerar um cache para retornar preços rapidamente.
- Receba os preços mais recentes quando um usuário clicar em um itinerário específico.
A implementação da API Partner Server é necessária se o parceiro quiser que os preços sejam mostrados pelo Google.
3.2. Validação e teste de API
Quando a implementação da API estiver quase concluída e o serviço que a implementa estiver funcionando, entre em contato com transport-help@google.com com as informações do servidor para que possamos começar a validar sua implementação.
No futuro, planejamos oferecer ferramentas automatizadas para validar a implementação da API, mas isso ainda não está disponível.