Este glossário define os termos principais usados na documentação da integração de parceiros de transporte.
Token de reserva:uma string opcional gerada pelo parceiro que pode ser transmitida no link direto de emissão de passagens para ajudar a manter a consistência de preço e itinerário entre os resultados da pesquisa do Google e a página de reserva do parceiro.
Mapeamento JSON canônico:um conjunto específico de regras definidas pelos buffers de protocolo para converter uma mensagem proto em um objeto JSON. Essa integração exige o uso deste mapeamento com opções específicas para que as solicitações e respostas sejam formatadas corretamente.
GTFS (Especificação Geral sobre Feeds de Transporte Público): um formato de dados padrão que as empresas de transporte público usam para fornecer informações sobre horários, trajetos e tarifas aos passageiros. Nessa integração, é uma das duas maneiras de fornecer dados estáticos ao Google.
Integração baseada na GTFS:um método de integração para parceiros que fornecem os próprios dados de horários ao Google em um feed GTFS. Usado quando o Google ainda não tem as programações do operador.
known_itineraries:uma opção na configuração de parceiro que permite
que os parceiros recebam uma lista de itinerários conhecidos do Google para otimizar a
resposta.
Conjunto de mercados: (somente para integração de parada) um feed opcional fornecido pelo parceiro para definir uma lista específica de pares de origem-destino (mercados) para os quais ele vai fornecer preços. Se fornecido, ele atua como uma lista de permissões.
API do parceiro / API do servidor do parceiro:o conjunto de APIs que os parceiros precisam implementar para fornecer ao Google dados dinâmicos, como preços e disponibilidade em tempo real.
Teste de qualidade do preço:processo contínuo em que os rastreadores do Google coletam amostras de itinerários no site do parceiro para verificar se os preços mostrados aos usuários correspondem aos preços fornecidos pela API Partner.
QPS (consultas por segundo): a taxa média em que o Google envia solicitações (uma consulta é uma solicitação) ao servidor da API Partner. Essa taxa pode variar, com períodos de tráfego um pouco mais alto ou mais baixo.
SegmentKey:um objeto usado na API Partner para identificar exclusivamente um trecho de uma viagem, incluindo origem, destino e datas/horários de serviço.
service_date:a data específica em que um serviço de transporte público opera,
formatada como YYYYMMDD. Ele é usado em combinação com outros identificadores para especificar uma instância de viagem exclusiva.
Integração somente de parada:um método de integração para parceiros que não são a fonte dos dados de programação. Isso é usado quando o Google já recebe os horários da operadora de outra fonte. Os parceiros só precisam fornecer uma lista dos IDs de parada.
ticketing_stop_id:o identificador exclusivo do parceiro para uma parada ou estação.
Esse ID é fornecido no feed de dados estáticos (GTFS ou somente paradas) e usado na API Partner e nos links diretos de bilhetes.
ticketing_trip_id: (para integração baseada em GTFS) o identificador exclusivo do parceiro para uma viagem específica, fornecido no arquivo trips.txt do feed GTFS. Somente integrações baseadas na GTFS.
Link direto de emissão de passagens:um URL que direciona um usuário dos resultados da pesquisa do Google para o site do parceiro para reservar um itinerário específico. O URL contém detalhes codificados sobre a viagem selecionada.
TripOptionsErrorType:um conjunto específico de tipos de erros que podem ser retornados
na API Partner para fornecer informações mais detalhadas sobre o motivo da falha
de uma solicitação.
Valor de enumeração UNSPECIFIED:o primeiro valor obrigatório (com um valor numérico de 0) em qualquer definição de enumeração ao usar buffers de protocolo. Ele serve como o valor padrão e geralmente deve ser tratado como um erro se recebido em uma solicitação.