Visão geral
Se você não for o provedor dos feeds GTFS para o Google Maps, sua integração será somente de paradas. Para essa integração, precisamos entender como você identifica as diferentes paradas de trem ou ônibus.
Especificações gerais do feed
Ao iniciar a integração, criamos um identificador exclusivo para cada integração, por exemplo: ch_google_test (código de país, nome do parceiro, integração) ou eu_google (código de região, nome do parceiro).
Os parceiros podem fornecer um arquivo ZIP com arquivos de texto no formato CSV que são aplicados globalmente ou por integração:
Exemplo 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Exemplo 2:
- stops.txt (aplicado a todas as integrações)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Especificação do feed de interrupção (obrigatório)
O arquivo de parada precisa ter as seguintes colunas:
| Nome do campo | Tipo (consulte a GTFS). | Descrição |
|---|---|---|
stop_id |
ID (obrigatório) | O identificador exclusivo que identifica uma parada ou estação. Estações maiores devem ter apenas uma entrada. Ele é usado ao fazer chamadas para a API do servidor do parceiro e nos links diretos de venda de passagens. |
stop_name |
Texto (obrigatório) | Um nome legível por humanos para depurar o mapeamento de paradas, o preenchimento de cache e os dados de precisão de preço. |
stop_lat |
Latitude (obrigatório) | Latitude da parada. |
stop_lon |
Longitude (obrigatório) | Longitude da parada. |
Vamos usar um processo de transferência automatizado em que os parceiros podem enviar arquivos ZIP atualizados continuamente quando as informações neles contidas mudarem. Por exemplo, um parceiro pode expandir o inventário fornecido estendendo a lista de paradas. No entanto, assim como na GTFS, os stop_ids precisam ser estáveis.
Especificação do feed do conjunto de mercados (opcional)
Com as paradas mapeadas, geramos o conjunto de mercado para essa integração (uma lista que contém pares de origem / destino populares). Depois, você tem a opção de reduzir esse conjunto de mercados fornecendo um feed de conjunto de mercados.
O conjunto de mercados funciona como uma lista de permissões: se nenhum conjunto de mercados for fornecido, todos os mercados serão ativados na integração. Se um conjunto de mercados for fornecido, qualquer mercado que não estiver na lista será desativado.
O arquivo de conjunto de mercado precisa conter as seguintes colunas:
| Nome do campo | Tipo (consulte a GTFS). | Descrição |
|---|---|---|
origin_stop_id |
ID (obrigatório) | A origem stop_id do mercado. |
destination_stop_id |
ID (obrigatório) | O destino stop_id do mercado. |
Configuração do parceiro
Ao usar a integração somente com paradas, precisamos de informações extras para a configuração do parceiro estático, conforme descrito na seção Configuração do parceiro.
Links diretos de venda de passagens
O formato e os parâmetros de um link direto são definidos em Links de venda de ingressos.
Parâmetros da API Partner
Os parâmetros de SegmentKeys para a API Partner
(GetBulkTripOptionsRequest)
são baseados na especificação de link direto. Usamos
SegmentKeys
incluindo apenas from_ticketing_stop_time_id, to_ticketing_stop_time_id,
service_date, boarding_time e arrival_time, deixando ticketing_trip_id
vazio. Vamos especificar totalmente o trajeto, incluindo todas as transferências, especificando várias SegmentKeys, uma por segmento.