Skip to content

Referência de GTFS Schedule

Revisado em 9 de maio de 2022. Veja o Histórico de Revisões para mais detalhes.

Este documento define o formato e a estrutura dos arquivos que compõem um conjunto de dados GTFS.

Tabela de conteúdo

  1. Convenções de documentos
  2. Arquivos de Dataset
  3. Requisitos do arquivo
  4. Definições de campo

Convenções de documentos

As palavras-chave "DEVE", "NÃO DEVE", "REQUERIDO", "DEVERÁ", "NÃO DEVERÁ", "DEVERÁ", "NÃO DEVERÁ", "RECOMENDADO", "PODE", e "OPTATIVO" neste documento devem ser interpretadas como descrito no RFC 2119.

Definições de termo

Esta seção define os termos que são utilizados ao longo deste documento.

  • Dataset - Um conjunto completo de arquivos definidos por esta referência de especificação. A alteração do conjunto de dados cria uma nova versão do conjunto de dados. Os conjuntos de dados devem ser publicados em uma URL pública e permanente, incluindo o nome do arquivo zip. (por exemplo, https://www.agency.org/gtfs/gtfs.zip).
  • Registro - Uma estrutura básica de dados composta de uma série de diferentes valores de campo descrevendo uma única entidade (por exemplo, agência de trânsito, parada, rota, etc.). Representado, em uma tabela, como uma linha.
  • Campo - Uma propriedade de um objeto ou entidade. Representado, em uma tabela, como uma coluna.
  • Valor do campo - Uma entrada individual em um campo. Representado, em uma tabela, como uma única célula.
  • Dia de serviço - Um dia de serviço é um período de tempo usado para indicar a programação de rotas. A definição exata de dia de serviço varia de agência para agência, mas os dias de serviço muitas vezes não correspondem a dias de calendário. Um dia de serviço pode exceder 24:00:00 se o serviço começar em um dia e terminar em um dia seguinte. Por exemplo, o serviço que vai das 08:00:00 na sexta-feira às 02:00:00 no sábado, poderia ser indicado como funcionando das 08:00:00 às 26:00:00:00 em um único dia de serviço.
  • Campo texto-para-fala - O campo deve conter as mesmas informações que seu campo pai (no qual ele cai de volta se estiver vazio). Deve ser lido como texto-fala, portanto, a abreviação deve ser removida ("St" deve ser lido como "Street" ou "Saint"; "Elizabeth I" deve ser "Elizabeth the first") ou mantido para ser lido como ele ("Aeroporto JFK" é dito abreviado).
  • Perna - Viagem na qual um cavaleiro embarca e desembarca entre um par de locais subseqüentes ao longo de uma viagem.
  • Viagem - Viagem global da origem ao destino, incluindo todas as pernas e traslados intermediários.
  • Sub-journey - Duas ou mais pernas que compõem um subconjunto de uma viagem.
  • Produto tarifário - Produtos tarifários que podem ser usados para pagar ou validar a viagem.

Presença

Condições de presença aplicáveis aos campos e arquivos:

  • Obrigatório - O campo ou arquivo deve ser incluído no conjunto de dados e conter um valor válido para cada registro.
  • Opcional - O campo ou arquivo pode ser omitido do conjunto de dados.
  • Condicionalmente necessário - O campo ou arquivo deve ser incluído nas condições descritas no campo ou na descrição do arquivo.
  • Proibido condicionalmente - O campo ou arquivo não deve ser incluído sob condições descritas no campo ou na descrição do arquivo.

Tipos de campo

  • Cor - Uma cor codificada como um número hexadecimal de seis dígitos. Consulte https://htmlcolorcodes.com para gerar um valor válido (o "#" principal não deve ser incluído).
    Exemplo: FFFFFF para branco, 000000 para preto ou 0039A6 para as linhas A,C,E em NYMTA.
  • Código da moeda - Um código de moeda alfabético ISO 4217. Para a lista da moeda corrente, consulte https://en.wikipedia.org/wiki/ISO_4217#Active_codes.
    Exemplo: CAD para dólares canadenses, EUR para euros ou JPY para ienes japoneses.
  • Valor da moeda - Um valor decimal indicando um valor em moeda. O número de casas decimais é especificado pela norma ISO 4217 para o código da moeda que acompanha a moeda. Todos os cálculos financeiros devem ser processados como decimal, moeda ou outro tipo equivalente adequado para cálculos financeiros, dependendo da language programação usada para consumir os dados. O processamento de valores em moeda como flutuante é desencorajado devido a ganhos ou perdas de dinheiro durante os cálculos.
  • Data - Dia de serviço no formato AAAAMMDD. Como o tempo dentro de um dia de serviço pode estar acima das 24h00, um dia de serviço pode conter informações para o(s) dia(s) subseqüente(s).
    Exemplo: 20180913 para 13 de setembro de 2018.
  • E-mail - Um endereço de e-mail.
    Exemplo: example@example.com
  • Enum - Uma opção a partir de um conjunto de constantes pré-definidas definidas na coluna "Descrição".
    Exemplo: O campo do tipo route_type contém um 0 para o bonde, um 1 para o metrô.
  • ID - Um valor de campo ID é um ID interno, não destinado a ser mostrado aos ciclistas, e é uma seqüência de quaisquer caracteres UTF-8. Recomenda-se o uso apenas de caracteres ASCII imprimíveis. Um ID é rotulado como "unique ID" quando deve ser único dentro de um arquivo. Os IDs definidos em um arquivo .txt são frequentemente referenciados em outro arquivo .txt. Os IDs que fazem referência a um ID em outra tabela são etiquetados como "ID estrangeiro".
    Exemplo: O campo stop_id em stops.txt é um "ID único". O campo parent_station em stops.txt é um "foreign ID referencing stops.stop_id".
  • código delanguage - Um código de language IETF BCP 47. Para uma introdução ao IETF BCP 47, consulte https://www.rfc-editor.org/rfc/bcp/bcp47.txt e language-tags/">language.
    Exemplo: en para inglês, en-US para inglês americano ou de para alemão.
  • Latitude - WGS84 latitude em graus decimais. O valor deve ser maior ou igual a -90,0 e menor ou igual a 90,0.
    Exemplo: 41,890169 para o Coliseu de Roma.
  • Longitude - longitude WGS84 em graus decimais. O valor deve ser maior ou igual a -180,0 e menor ou igual a 180,0.
    Exemplo: 12,492269 para o Coliseu de Roma.
  • Flutuador - Um número de ponto flutuante.
  • Inteiro - Um número inteiro.
  • Número de telefone - Um número de telefone.
  • Tempo - Tempo no formato HH:MM:SS (H:MM:SS também é aceito). A hora é medida a partir do "meio-dia menos 12h" do dia de serviço (efetivamente meia-noite, exceto para os dias em que ocorrem mudanças no horário de verão). Para as horas que ocorrem depois da meia-noite, digite a hora como um valor maior que 24:00:00 no HH:MM:SS hora local para o dia em que o Schedule viagem começa.
    Exemplo: 14:30: 00 para 14:30 ou 25:35: 00 para 1:35 no dia seguinte.
  • Texto - Uma cadeia de caracteres UTF-8, que se destina a ser exibida e que, portanto, deve ser legível pelo ser humano.
  • Fuso horário - Fuso horário TZ a partir do https://www.iana.org/time-zones. Os nomes dos fusos horários nunca contêm o caractere do espaço, mas podem conter um sublinhado. Consulte https://en.wikipedia.org/wiki/List_of_tz_zones para obter uma lista de valores válidos.
    Exemplo: Ásia/Tóquio, América/Los_Angeles ou África/Cairo.
  • URL - Uma URL totalmente qualificada que inclui http:// ou https://, e quaisquer caracteres especiais na URL devem ser corretamente evitados. Consulte o seguinte https://www.w3.org/Addressing/URL/4_URI_Recommentations.html para uma descrição de como criar valores de URL totalmente qualificados.

Sinais de campo

Sinais aplicáveis aos tipos de campo Flutuante ou Inteiro:

  • Não-negativo - Maior ou igual a 0.
  • Não-negativo - Não igual a 0.
  • Positivo - Maior do que 0.

Exemplo: Flutuador não negativo** - Um número de ponto flutuante maior ou igual a 0.

Atributos do conjunto de dados

A chave primária de um conjunto de dados é o campo ou combinação de campos que identificam de forma única uma linha. A chave primária (*) é usada quando todos os campos fornecidos para um arquivo são usados para identificar de forma única uma linha. A chave primária (nenhuma) significa que o arquivo permite apenas uma linha.

Exemplo: os campos trip_id e stop_sequence fazem a chave primária do stop_times.txt.

Arquivos de Dataset

Esta especificação define os seguintes arquivos:

Nome do arquivo Presença Descrição
agency.txt Obrigatório Agências de trânsito com serviço representado neste conjunto de dados.
stops.txt Obrigatório Pára onde os veículos pegam ou deixam os motociclistas. Também define as estações e entradas das estações.
routes.txt Obrigatório Rotas de trânsito. Uma rota é um grupo de viagens que são exibidas aos cavaleiros como um único serviço.
trips.txt Obrigatório Viagens para cada rota. Uma viagem é uma seqüência de duas ou mais paradas que ocorrem durante um período de tempo específico.
stop_times.txt Obrigatório Horários em que um veículo chega e sai de paradas para cada viagem.
calendar.txt Condicionalmente Necessário Datas de serviço especificadas usando um Schedule semanal com datas de início e fim.

Condicionalmente necessário:
- Obrigatório a menos que todas as datas de serviço sejam definidas em calendar_dates.txt.
- Opcional de outra forma.
calendar_dates.txt Condicionalmente Requerido Exceções para os serviços definidos no calendar.txt.

Condicionalmente Necessário:
- Obrigatório se calendar.txt é omitido. Nesse caso, omite-se calendar_dates.txt deve conter todas as datas de serviço.
- Opcional de outra forma.
fare_attributes.txt Opcional - Informações tarifárias para as rotas de uma agência de trânsito.
fare_rules.txt Condicionalmente Requerido Regras para aplicar tarifas para os itinerários.

Condicionalmente Exigido:
- Obrigatório se fare_attributes.txt está definido.
- Proibido de outra forma.
fare_products.txt Opcional Para descrever os diferentes tipos de bilhetes ou tarifas que podem ser comprados pelos cavaleiros.

Arquivo fare_products.txt descreve os produtos tarifários que não são representados em fare_attributes.txt e fare_rules.txt. Como tal, o uso de fare_products.txt é totalmente separado dos arquivos fare_attributes.txt e fare_rules.txt.
fare_leg_rules.txt Opcional Regras tarifárias para as pernas individuais de viagem.

Arquivo fare_leg_rules.txt fornece um método mais detalhado para modelagem de estruturas tarifárias. Como tal, o uso de fare_leg_rules.txt é totalmente separado dos arquivos fare_attributes.txt e fare_rules.txt.
fare_transfer_rules.txt Opcional Regras tarifárias para transferências entre pernas de viagem.

Junto com fare_leg_rules.txt, arquivo fare_transfer_rules.txt fornece um método mais detalhado para modelagem de estruturas tarifárias. Como tal, o uso de fare_transfer_rules.txt é totalmente separado dos arquivos fare_attributes.txt e fare_rules.txt.
areas.txt Opcional Agrupamento de áreas de localização.
stop_areas.txt Opcional Regras para atribuição de paradas a áreas.
shapes.txt Opcional Regras para o mapeamento de rotas de veículos, às vezes referidas como alinhamentos de rotas.
frequencies.txt Opcional Headway (tempo entre viagens) para serviço baseado em headway ou uma representação comprimida de serviço de horário fixo.
transfers.txt Opcional Regras para fazer conexões em pontos de transferência entre rotas.
pathways.txt Opcional Caminhos que ligam os locais dentro das estações.
levels.txt Condicionalmente Requerido Níveis dentro das estações.

Condicionalmente Necessário: Condicionalmente Necessário:
- Obrigatório ao descrever caminhos com elevadores (pathway_mode=5).
- Facultativo de outra forma.
translations.txt Opcional Traduções dos valores do conjunto de dados voltados para o cliente.
feed_info.txt Opcional Metadados do conjunto de dados, incluindo informações do editor, versão e expiração.
attributions.txt Opcional Atribuições do conjunto de dados.

Requisitos do arquivo

Os seguintes requisitos se aplicam ao formato e ao conteúdo dos arquivos do conjunto de dados:

  • Todos os arquivos devem ser salvos como texto delimitado por vírgulas.
  • A primeira linha de cada arquivo deve conter os nomes dos campos. Cada subseção da seção Field Definitions corresponde a um dos arquivos em um conjunto de dados GTFS e lista os nomes de campo que podem ser usados nesse arquivo.
  • Todos os nomes de arquivos e campos são sensíveis a maiúsculas e minúsculas.
  • Os valores de campo não devem conter guias, retornos de transporte ou novas linhas.
  • Valores de campo que contenham aspas ou vírgulas devem ser colocados entre aspas. Além disso, cada aspas no valor do campo deve ser precedido por uma aspas. Isto é consistente com a maneira pela qual o Microsoft Excel produz arquivos delimitados por vírgulas (CSV). Para mais informações sobre o formato do arquivo CSV, consulte https://tools.ietf.org/html/rfc4180.

O exemplo a seguir demonstra como um valor de campo apareceria em um arquivo delimitado por vírgula:

  • Valor original do campo: Contém "aspas", vírgulas e texto
  • Valor do campo no arquivo CSV: "Contém ""aspas"", vírgulas e texto".
  • Os valores de campo não devem conter tags HTML, comentários ou seqüências de escape.
  • Os espaços extras entre campos ou nomes de campos devem ser removidos. Muitos analisadores consideram os espaços como parte do valor, o que pode causar erros.
  • Cada linha deve terminar com um caractere de quebra de linha CRLF ou LF.
  • Os arquivos devem ser codificados em UTF-8 para suportar todos os caracteres Unicode. Os arquivos que incluem o caractere Unicode byte-order mark (BOM) são aceitáveis. Consulte https://unicode.org/faq/utf_bom.html#BOM para mais informações sobre o caractere BOM e UTF-8.
  • Todos os arquivos do conjunto de dados devem ser zipados juntos.

Definições de campo

agency.txt

Arquivo: Necessário

Chave primáriaagency_id)

Nome do campo Tipo Presença Descrição
agency_id Identificação única Condicionalmente Requerido Identifica uma marca de trânsito que é freqüentemente sinônimo de uma agência de trânsito. Observe que em alguns casos, como quando uma única agência opera vários serviços separados, as agências e marcas são distintas. Este documento usa o termo "agência" no lugar de "marca". Um conjunto de dados pode conter dados de várias agências.

Condicionalmente Necessária:
- Obrigatório quando o conjunto de dados contém dados para várias agências de trânsito.
- Facultativo de outra forma.
agency_name Texto Obrigatório Nome completo da agência de trânsito.
agency_url URL Obrigatório URL da agência de trânsito.
agency_timezone Fuso horário Obrigatório Fuso horário onde se localiza a agência de trânsito. Se várias agências estiverem especificadas no conjunto de dados, cada uma deve ter o mesmo agency_timezone.
agency_lang códigolanguage Opcional Principal language utilizada por esta agência de trânsito. Deve ser fornecido para ajudar os consumidores GTFS a escolher regras de capitalização e outras configurações language para o conjunto de dados.
agency_phone Um número de telefone. Opcional Um número de telefone de voz para a agência especificada. Este campo é um valor em cadeia que apresenta o número de telefone como típico para a área de serviço da agência. Pode conter sinais de pontuação para agrupar os dígitos do número. Texto discável (por exemplo, "503-238-RIDE" da TriMet) é permitido, mas o campo não deve conter nenhum outro texto descritivo.
agency_fare_url URL Opcional URL de uma página web que permite ao passageiro comprar bilhetes ou outros instrumentos tarifários para essa agência on-line.
agency_email Email Opcional Endereço de e-mail ativamente monitorado pelo departamento de atendimento ao cliente da agência. Este endereço de e-mail deve ser um ponto de contato direto onde os cavaleiros em trânsito podem chegar a um representante de atendimento ao cliente na agência.

stops.txt

Arquivo: Necessário

Chave primáriastop_id)

Nome do campo Tipo Presença Descrição
stop_id Identificação única Obrigatório Identifica um local: parada/plataforma, estação, entrada/saída, nó genérico ou área de embarque (ver location_type).

Várias rotas podem usar o mesmo stop_id.
stop_code Texto Opcional Texto breve ou um número que identifica o local para os cavaleiros. Estes códigos são freqüentemente usados em sistemas de informação de trânsito por telefone ou impressos na sinalização para facilitar aos cavaleiros a obtenção de informações para um determinado local. O stop_code pode ser o mesmo que stop_id se for de frente para o público. Este campo deve ser deixado vazio para locais sem um código apresentado aos cavaleiros.
stop_name Texto Condicionalmente Requerido Nome do local. O stop_name deve corresponder ao nome da agência com a cara do cavaleiro para o local conforme impresso em um horário, publicado on-line, ou representado na sinalização. Para traduções em outros idiomas, utilizar translations.txt.

Quando o local é uma área de embarque (location_type=4), o stop_name deve conter o nome da área de embarque, conforme indicado pela agência. Pode ser apenas uma letra (como em algumas estações ferroviárias interurbanas européias), ou texto como "Área de embarque de cadeiras de rodas" (Metrô de NYC) ou "Chefe de trens curtos" (RER de Paris).

Condicionalmente Necessária:
- Obrigatório para locais que são paradas (location_type=0), estações (location_type=1) ou entradas/saídas (location_type=2).
- Opcional para locais que são nós genéricos (location_type=3) ou áreas de embarque (location_type=4).
tts_stop_name Texto Opcional Versão legível do stop_name. Ver "Campo texto-para-fala" no Definições de termo para mais.
stop_desc Texto Opcional Descrição do local que fornece informações úteis e de qualidade. Não deve ser um duplicado de stop_name.
stop_lat Latitude - WGS84 Condicionalmente Requerido Latitude do local.

Para paradas/plataformas (location_type=0) e área de embarque (location_type=4), as coordenadas devem ser as do poste do ônibus - se houver - e de onde os viajantes estão embarcando no veículo (na calçada ou na plataforma, e não na estrada ou na pista onde o veículo pára).

Condicionalmente Necessária:
- Obrigatório para locais que são paradas (location_type=0), estações (location_type=1) ou entradas/saídas (location_type=2).
- Opcional para locais que são nós genéricos (location_type=3) ou áreas de embarque (location_type=4).
stop_lon Longitude Condicionalmente Requerido Longitude do local.

Para paradas/plataformas (location_type=0) e área de embarque (location_type=4), as coordenadas devem ser as do poste do ônibus - se houver - e de outra forma de onde os viajantes estão embarcando no veículo (na calçada ou na plataforma, e não na estrada ou na pista onde o veículo pára).

Condicionalmente Necessária:
- Obrigatório para locais que são paradas (location_type=0), estações (location_type=1) ou entradas/saídas (location_type=2).
- Opcional para locais que são nós genéricos (location_type=3) ou áreas de embarque (location_type=4).
zone_id ID Condicionalmente Requerido Identifica a zona tarifária para uma parada. Se este registro representar uma estação ou entrada da estação, o zone_id é ignorado.

Condicionalmente Necessária:
- Obrigatório se o fornecimento de informações tarifárias usando fare_rules.txt
- Facultativo de outra forma.
stop_url URL Opcional URL de uma página web sobre o local. Este deve ser diferente do agency.agency_url e o routes.route_url valores de campo.
location_type Enum Opcional Tipo de localização. As opções válidas são:

0 (ou em branco) - Parada (ou Plataforma). Um local onde os passageiros embarcam ou desembarcam de um veículo em trânsito. É chamado de plataforma quando definido dentro de um parent_station.
1 - Estação. Uma estrutura física ou área que contenha uma ou mais plataformas.
2 - Entrada/saída. Um local onde os passageiros podem entrar ou sair de uma estação da rua. Se uma entrada/saída pertence a várias estações, ela pode estar ligada por caminhos a ambas, mas o provedor de dados deve escolher uma delas como pai.
3 - Nó genérico. Um local dentro de uma estação, que não corresponda a nenhum outro location_typeque podem ser usados para unir caminhos definidos em pathways.txt
4 - Área de embarque. Um local específico em uma plataforma, onde os passageiros podem embarcar e/ou desembarcar veículos.
parent_station Referenciamento de identidade estrangeira stops.stop_id Condicionalmente Requerido Define a hierarquia entre os diferentes locais definidos em stops.txt. Ele contém a identificação do local de origem, como se segue:

- Parada/plataforma (location_type=0): o parent_station campo contém a identificação de uma estação.
- Estação (location_type=1): este campo deve estar vazio.
- Entrada/saída (location_type=2) ou nó genérico (location_type=3): o parent_station campo contém a identificação de uma estação (location_type=1)
- Área de embarque (location_type=4): o parent_station campo contém a identificação de uma plataforma.

Condicionalmente Necessária:
- Obrigatório para locais que são entradas (location_type=2), nós genéricos (location_type=3) ou áreas de embarque (location_type=4).
- Opcional para paradas/plataformas (location_type=0).
- Proibido para as estações (location_type=1).
stop_timezone Fuso horário Opcional Fuso horário do local. Se o local tiver uma estação mãe, ele herda o fuso horário da estação mãe em vez de aplicar o seu próprio. Estações e paradas sem parentesco com vazios stop_timezone herdar o fuso horário especificado por agency.agency_timezone. Se stop_timezone valores são fornecidos, os tempos em stop_times.txt deve ser inserido como a hora desde a meia-noite no fuso horário especificado por agency.agency_timezone. Isto assegura que os valores de tempo em uma viagem sempre aumentam ao longo de uma viagem, independentemente de quais fusos horários a viagem atravessa.
wheelchair_boarding Enum Opcional Indica se é possível o embarque de cadeiras de rodas a partir do local. As opções válidas são:

Para paradas sem parênteses:
0 ou vazias - Sem informações de acessibilidade para a parada.
1 - Alguns veículos nesta parada podem ser abordados por um ciclista em uma cadeira de rodas.
2 - O embarque em cadeira de rodas não é possível nesta parada.

Para paradas para crianças:
0 ou vazias - A parada herdará seu wheelchair_boarding comportamento da estação controladora, se especificado na estação controladora.
1 - Existe algum caminho acessível de fora da estação até a parada/plataforma específica.
2 - Não existe nenhum caminho acessível de fora da estação para a parada/plataforma específica.

Para entradas/saídas da estação:
0 ou vazias - a entrada da estação herdará sua wheelchair_boarding comportamento da estação controladora, se especificado para a estação controladora.
1 - A entrada da estação é acessível em cadeira de rodas.
2 - Nenhum caminho acessível desde a entrada da estação até as paradas/plataformas.
level_id Referenciamento de identidade estrangeira levels.level_id Opcional Nível do local. O mesmo nível pode ser usado por várias estações desvinculadas.
platform_code Texto Opcional Identificador de plataforma para uma parada de plataforma (uma parada pertencente a uma estação). Este deve ser apenas o identificador da plataforma (por exemplo, "G" ou "3"). Palavras como "plataforma" ou "pista" (ou o equivalente de language da alimentação) não devem ser incluídas. Isto permite que os consumidores de alimentação internacionalizem e localizem mais facilmente o identificador da plataforma em outros idiomas.

routes.txt

Arquivo: Necessário

Chave primáriaroute_id)

Nome do campo Tipo Presença Descrição
route_id Identificação única Obrigatório Identifica uma rota.
agency_id Referenciamento de identidade estrangeira agency.agency_id Condicionalmente Requerido Agência para a rota especificada.

Condicionalmente Necessária:
- Obrigatório se múltiplas agências são definidas em agency.txt.
- Opcional de outra forma.
route_short_name Texto Condicionalmente Requerido Nome curto de uma rota. Muitas vezes um identificador curto e abstrato (por exemplo, "32", "100X", "Verde") que os cavaleiros usam para identificar uma rota. Ambos route_short_name e route_long_name pode ser definido.

Condicionalmente Necessária:
- Obrigatório se routes.route_long_name está vazio.
- Opcional de outra forma.
route_long_name Texto Condicionalmente Requerido Nome completo de uma rota. Este nome é geralmente mais descritivo do que o route_short_name e muitas vezes inclui o destino da rota ou a parada. Ambos route_short_name e route_long_name pode ser definido.

Condicionalmente Necessária:
- Obrigatório se routes.route_short_name está vazio.
- Opcional de outra forma.
route_desc Texto Opcional Descrição de uma rota que fornece informações úteis e de qualidade. Não deve ser um duplicado de route_short_name ou route_long_name.
Exemplo: Os trens "A" operam entre Inwood-207 St, Manhattan e Far Rockaway-Mott Avenue, Queens em todos os momentos. Também das 6 da manhã até cerca da meia-noite, trens "A" adicionais operam entre Inwood-207 St. e Lefferts Boulevard (trens normalmente alternam entre Lefferts Blvd e Far Rockaway).
route_type Enum Obrigatório Indica o tipo de transporte utilizado em uma rota. As opções válidas são:

0 - Bonde, bonde, trilho leve. Qualquer sistema de trens leves ou de nível de rua dentro de uma área metropolitana.
1 - Metrô, Metrô. Qualquer sistema de metrô dentro de uma área metropolitana.
2 - Trem. Usado para viagens interurbanas ou de longa distância.
3 - Ônibus. Usado para viagens de ônibus de curta e longa distância.
4 - Ferry. Utilizado para serviço de barcos de curta e longa distância.
5 - Bonde-cabo. Usado para bondes de nível rodoviário onde o cabo passa por baixo do veículo (por exemplo, bondinho em São Francisco).
6 - Elevador aéreo, teleférico suspenso (por exemplo, teleférico de gôndola, bondinho aéreo). Transporte por cabo onde cabines, carros, gôndolas ou cadeiras abertas são suspensas por meio de um ou mais cabos.
7 - Funicular. Qualquer sistema ferroviário projetado para inclinações íngremes.
11 - Trolleybus. Ônibus elétricos que extraem energia de cabos aéreos usando postes.
12 - Monotrilho. Ferrovia na qual a via consiste de um único trilho ou uma viga.
route_url URL Opcional URL de uma página web sobre o trajeto em particular. Deve ser diferente do agency.agency_url valor.
route_color Cor Opcional Designação da cor da rota que combina com o material de frente para o público. Predefinições para o branco (FFFFFF) quando omitido ou deixado vazio. A diferença de cor entre route_color e route_text_color deve fornecer contraste suficiente quando visto em uma tela em preto e branco.
route_text_color Cor Opcional Cor legível a ser usada para texto desenhado sobre um fundo de route_color. Padrões de preto (000000) quando omitido ou deixado vazio. A diferença de cor entre route_color e route_text_color deve fornecer contraste suficiente quando visto em uma tela em preto e branco.
route_sort_order Número inteiro não-negativo Opcional Encomenda as rotas de uma forma ideal para apresentação aos clientes. Rotas com rotas menores route_sort_order valores devem ser exibidos primeiro.
continuous_pickup Enum Opcional Indica que o cavaleiro pode embarcar no veículo de trânsito em qualquer ponto da trajetória de viagem do veículo, conforme descrito por shapes.txtem cada viagem da rota. As opções válidas são:

0 - Parada contínua de coleta.
1 ou vazio - Sem parada contínua de pickup.
2 - Deve telefonar para agenciar a parada contínua de retirada.
3 - Deve coordenar com o motorista para organizar a parada contínua de retirada.

Valores para routes.continuous_pickup podem ser anulados definindo valores em stop_times.continuous_pickup para stop_times ao longo do percurso.
continuous_drop_off Enum Opcional Indica que o cavaleiro pode sair do veículo em trânsito em qualquer ponto ao longo do trajeto do veículo, conforme descrito por shapes.txt, em todas as viagens da rota. As opções válidas são: , em todas as viagens da rota:

0 - Parada contínua de entrega.
1 ou vazio - Nenhuma parada contínua.
2 - Deve telefonar para a agência para organizar a parada contínua.
3 - Precisa coordenar com o motorista para organizar a parada contínua.

Valores para routes.continuous_drop_off podem ser anulados definindo valores em stop_times.continuous_drop_off para stop_times ao longo do trajeto.
network_id ID Opcional Identifica um grupo de rotas. Várias filas em routes.txt pode ter o mesmo network_id.

trips.txt

Arquivo: Necessário

Chave primáriatrip_id)

Nome do campo Tipo Presença Descrição
route_id Referenciamento de identidade estrangeira routes.route_id Obrigatório Identifica um itinerário.
service_id Referenciamento de identidade estrangeira calendar.service_id ou calendar_dates.service_id Obrigatório Identifica um conjunto de datas quando o serviço está disponível para uma ou mais rotas.
trip_id Identificação única Obrigatório Identifica uma viagem.
trip_headsign Texto Opcional Texto que aparece na sinalização identificando o destino da viagem para os ciclistas. Deve ser usado para distinguir entre diferentes padrões de serviço na mesma rota.

Se a sinalização muda durante uma viagem, os valores para trip_headsign podem ser anulados definindo valores em stop_times.stop_headsign para stop_times ao longo da viagem.
trip_short_name Texto Opcional Texto de face pública usado para identificar a viagem aos cavaleiros, por exemplo, para identificar números de trens para viagens de trem pendular. Se os cavaleiros não costumam confiar nos nomes das viagens, trip_short_name deve estar vazio. A trip_short_name se fornecido, deve identificar exclusivamente uma viagem dentro de um dia de serviço; não deve ser usado para nomes de destino ou designações limitadas/expressas.
direction_id Enum Opcional Indica a direção da viagem para uma viagem. Este campo não deve ser usado no roteamento; ele fornece uma forma de separar viagens por direção ao publicar tabelas de tempo. As opções válidas são:

0 - Viagem em uma direção (por exemplo, viagem de ida).
1 - Viagem na direção oposta (por exemplo, viagem de ida).
Exemplo: O trip_headsign e direction_id Os campos podem ser usados em conjunto para atribuir um nome para viajar em cada direção para um conjunto de viagens. A trips.txt poderia conter estes registros para uso em tabelas de tempo:
trip_id,...,trip_headsign,direction_id
1234,...,Airport,0
1505,...,Downtown,1
block_id ID Opcional Identifica o bloco ao qual a viagem pertence. Um bloco consiste em uma única viagem ou muitas viagens sequenciais feitas usando o mesmo veículo, definidas por dias de serviço compartilhado e block_id. A block_id podem ter viagens com diferentes dias de serviço, fazendo blocos distintos. Veja o exemplo abaixo
shape_id Referenciamento de identidade estrangeira shapes.shape_id Condicionalmente Requerido Identifica uma forma geoespacial descrevendo o caminho de viagem do veículo para uma viagem.

Condicionalmente necessário:
- Obrigatório se a viagem tiver um comportamento de coleta ou entrega contínua definido em routes.txt ou em stop_times.txt.
- Opcional de outra forma.
wheelchair_accessible Enum Opcional Indica a acessibilidade das cadeiras de rodas. As opções válidas são:

0 ou vazia - Nenhuma informação de acessibilidade para a viagem.
1 - O veículo utilizado nesta viagem em particular pode acomodar pelo menos um cavaleiro em uma cadeira de rodas.
2 - Nenhum ciclista em cadeira de rodas pode ser acomodado nesta viagem.
bikes_allowed Enum Opcional Indica se as bicicletas são permitidas. As opções válidas são:

0 ou vazia - Nenhuma informação de bicicleta para a viagem.
1 - O veículo usado nesta viagem em particular pode acomodar pelo menos uma bicicleta.
2 - Não é permitida a utilização de bicicletas nesta viagem.

Exemplo: Blocos e dia de serviço

O exemplo abaixo é válido, com blocos distintos todos os dias da semana.

route_id trip_id service_id block_id (primeira parada) (última parada)
vermelho viagem_1 mon-tues-wed-urs-fri-sat-sun red_loop 22:00:00 22:55:00
vermelho viagem_2 fri-sat-sun red_loop 23:00:00 23:55:00
vermelho viagem_3 fri-sat red_loop 24:00:00 24:55:00
vermelho viagem_4 mon-tues-wed-thurs red_loop 20:00:00 20:50:00
vermelho viagem_5 mon-tues-wed-thurs red_loop 21:00:00 21:50:00

Notas sobre a tabela acima:

  • Na sexta-feira até sábado de manhã, por exemplo, um único veículo opera trip_1, trip_2, e trip_3 (10:00 até 12:55). Note que a última viagem ocorre no sábado, das 12:00 às 12:55, mas faz parte do "dia de serviço" de sexta-feira, porque os horários são de 24:00 às 24:55:00.
  • Na segunda, terça, quarta e quinta-feira, um único veículo opera trip_1, trip_4, e trip_5 em um bloco das 20:00 às 22:55.

stop_times.txt

Arquivo: Necessário

Chave primáriatrip_id, stop_sequence)

Nome do campo Tipo Presença Descrição
trip_id Referenciamento de identidade estrangeira trips.trip_id Obrigatório Identifica uma viagem.
arrival_time Hora Condicionalmente Requerido Horário de chegada na parada (definido por stop_times.stop_id) para uma viagem específica (definida por stop_times.trip_id).

Se não houver horários separados para chegada e partida em uma parada, arrival_time e departure_time deve ser o mesmo.

Para horários ocorridos após a meia-noite do dia de serviço, digite o horário como um valor maior que 24:00:00 no horário local HH:MM:SS para o dia em que o Schedule da viagem começa.

Se os horários exatos de chegada e partida (timepoint=1 ou vazias) não estão disponíveis, não há horários estimados ou interpolados de chegada e partida (timepoint=0) devem ser fornecidas.

Condicionalmente Necessária:
- Obrigatório para a primeira e última parada de uma viagem (definida por stop_times.stop_sequence).
- Obrigatório para timepoint=1.
- Opcional de outra forma.
departure_time Hora Condicionalmente Requerido Tempo de partida da parada (definido por stop_times.stop_id) para uma viagem específica (definida por stop_times.trip_id).

Se não houver horários separados para chegada e partida em uma parada, arrival_time e departure_time deve ser o mesmo.

Para horários ocorridos após a meia-noite do dia de serviço, digite o horário como um valor maior que 24:00:00 no HH:MM:SS horário local do dia em que o Schedule da viagem começa.

Se os horários exatos de chegada e partida (timepoint=1 ou vazias) não estão disponíveis, não há horários estimados ou interpolados de chegada e partida (timepoint=0) deve ser providenciado.

Condicionalmente Necessária:
- Obrigatório para timepoint=1.
- Opcional de outra forma.
stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Identifica a parada com manutenção. Todas as paradas atendidas durante uma viagem devem ter um registro em stop_times.txt. Os locais referenciados devem ser paradas/plataformas, ou seja, suas stops.location_type valor deve ser 0 ou vazio. Uma parada pode ser servida várias vezes na mesma viagem, e várias viagens e rotas podem servir a mesma parada.
stop_sequence Número inteiro não-negativo Obrigatório Ordem das paradas para uma determinada viagem. Os valores devem aumentar ao longo da viagem, mas não precisam ser consecutivos.
Exemplo: O primeiro local da viagem pode ter um stop_sequence=1o segundo local da viagem poderia ter um stop_sequence=23o terceiro local poderia ter um stop_sequence=40e assim por diante.
stop_headsign Texto Opcional Texto que aparece na sinalização identificando o destino da viagem para os cavaleiros. Este campo anula o padrão trips.trip_headsign quando o sinal de cabeça muda entre as paradas. Se o sinal do cabeçote for exibido para uma viagem inteira, trips.trip_headsign deve ser usado em seu lugar.

A stop_headsign valor especificado para um stop_time não se aplica a stop_times na mesma viagem. Se você quiser anular a trip_headsign para múltiplas stop_times na mesma viagem, o stop_headsign valor deve ser repetido em cada stop_time linha.
pickup_type Enum Opcional Indica o método de coleta. As opções válidas são:

0 ou vazio - Coleta programada regularmente.
1 - Não há pickup disponível.
2 - Deve telefonar para a agência para agendar a retirada.
3 - Deve coordenar com o motorista para agendar a retirada.
drop_off_type Enum Opcional Indica o método de entrega. As opções válidas são:

0 ou vazia - entrega regularmente programada.
1 - Não há entrega disponível.
2 - Deve telefonar para a agência para agendar a entrega.
3 - Deve coordenar com o motorista para agendar a entrega.
continuous_pickup Enum Opcional Indica que o cavaleiro pode embarcar no veículo de trânsito em qualquer ponto ao longo do trajeto do veículo, conforme descrito por shapes.txtA partir daí, é necessário stop_time para o próximo stop_time na viagem stop_sequence. As opções válidas são: :

0 - Parada contínua de coleta.
1 ou vazio - Sem parada contínua de pickup.
2 - Deve telefonar para a agência para organizar a parada contínua de coleta.
3 - Deve-se coordenar com o motorista para organizar a parada contínua da coleta.

Se este campo for populado, ele substitui qualquer comportamento contínuo de coleta definido em routes.txt. Se este campo estiver vazio, o stop_time herda qualquer comportamento de coleta contínua definido em routes.txt.
continuous_drop_off Enum Opcional Indica que o cavaleiro pode sair do veículo em trânsito em qualquer ponto ao longo do trajeto do veículo, conforme descrito por shapes.txta partir daí stop_time para o próximo stop_time na viagem stop_sequence. As opções válidas são: :

0 - Parada contínua.
1 ou vazio - Não há parada contínua.
2 - Deve telefonar para a agência para organizar a parada contínua.
3 - Deve coordenar-se com o motorista para organizar a parada contínua.

Se este campo for populado, ele substitui qualquer comportamento de queda contínua definido em routes.txt. Se este campo estiver vazio, o stop_time herda qualquer comportamento de entrega contínua definido em routes.txt.
shape_dist_traveled Flutuador não-negativo Opcional A distância real viajou ao longo da forma associada, desde a primeira parada até a parada especificada neste registro. Este campo especifica quanto da forma deve ser traçado entre duas paradas quaisquer durante uma viagem. Deve estar nas mesmas unidades usadas em shapes.txt. Valores utilizados para shape_dist_traveled deve aumentar junto com stop_sequenceNão devem ser usados para mostrar o percurso inverso ao longo de uma rota.
Exemplo: Se um ônibus percorre uma distância de 5,25 quilômetros desde o início da forma até a parada,shape_dist_traveled=5.25.
timepoint Enum Opcional Indica se os horários de chegada e partida para uma parada são estritamente cumpridos pelo veículo ou se, em vez disso, são horários aproximados e/ou interpolados. Este campo permite que um produtor de GTFS forneça horários de parada interpolados, indicando ao mesmo tempo que os horários são aproximados. As opções válidas são:

0 - Os tempos são considerados aproximados.
1 ou vazio - Os tempos são considerados exatos.

calendar.txt

Arquivo: Condicionalmente Requerido

Chave primáriaservice_id)

Nome do campo Tipo Presença Descrição
service_id Identificação única Obrigatório Identifica um conjunto de datas quando o serviço está disponível para uma ou mais rotas. Cada service_id valor deve ser único em um calendar.txt arquivo.
monday Enum Obrigatório Indica se o serviço opera em todas as segundas-feiras na faixa de datas especificada pelo start_date e end_date campos. Observe que exceções para datas específicas podem ser listadas em calendar_dates.txt. As opções válidas são: :

1 - O serviço está disponível para todas as segundas-feiras na faixa de datas.
0 - O serviço não está disponível para todas as segundas-feiras no intervalo de datas.
tuesday Enum Obrigatório Funciona da mesma forma que monday exceto às terças-feiras
wednesday Enum Obrigatório Funciona da mesma forma que monday exceto às quartas-feiras
thursday Enum Obrigatório Funciona da mesma forma que monday exceto às quintas-feiras
friday Enum Obrigatório Funciona da mesma forma que monday exceto se aplica às sextas-feiras
saturday Enum Obrigatório Funciona da mesma forma que monday exceto aos sábados.
sunday Enum Obrigatório Funciona da mesma forma que monday exceto se aplica aos domingos.
start_date Data Obrigatório Iniciar dia de serviço para o intervalo de serviço.
end_date Data Obrigatório Término do dia de serviço para o intervalo de serviço. Este dia de serviço está incluído no intervalo de serviço.

calendar_dates.txt

Arquivo: Condicionalmente Requerido

Chave primáriaservice_id, data)

A tabela calendar_dates.txt ativa ou desativa explicitamente o serviço por data. Ela pode ser usada de duas maneiras.

  • Recomendado: Use calendar_dates.txt em conjunto com calendar.txt para definir exceções aos padrões de serviço padrão definidos em calendar.txt Se o serviço é geralmente regular, com algumas mudanças em datas explícitas (por exemplo, para acomodar serviços de eventos especiais, ou um Schedule escolar), esta é uma boa abordagem. Neste caso, calendário_datas.service_id é um calendário de referência de ID estrangeiro .service_id.
  • Alternar: Omitir calendar.txt, e especificar cada data de serviço em calendar_dates.txt. Isto permite uma variação considerável do serviço e acomoda o serviço sem horários semanais normais. Neste caso, o service_id é um ID.
Nome do campo Tipo Presença Descrição
service_id Referenciamento de identidade estrangeira calendar.service_id ou identificação Obrigatório Identifica um conjunto de datas quando ocorre uma exceção de serviço para uma ou mais rotas. Cada (service_id, date) pode aparecer apenas uma vez em calendar_dates.txt se estiver usando calendar.txt e calendar_dates.txt em conjunto. Se um service_id valor aparece em ambos calendar.txt e calendar_dates.txtas informações em calendar_dates.txt modifica as informações de serviço especificadas em calendar.txt.
date Data Obrigatório Data em que ocorre a exceção de serviço.
exception_type Enum Obrigatório Indica se o serviço está disponível na data especificada no campo de data. As opções válidas são:

1 - O serviço foi adicionado para a data especificada.
2 - O serviço foi removido para a data especificada.
Exemplo: Suponha que uma rota tenha um conjunto de viagens disponíveis em feriados e outro conjunto de viagens disponíveis em todos os outros dias. Um service_id poderia corresponder ao Schedule serviço regular e outro service_id poderia corresponder ao Schedule férias. Para um feriado em particular, o calendar_dates.txt arquivo poderia ser usado para adicionar o feriado ao feriado service_id e para retirar o feriado do service_id Schedule.

fare_attributes.txt

Arquivo: Opcional

Chave primáriafare_id)

Versões
Há duas opções de modelagem para descrever as tarifas. GTFS V1 é a opção legada para descrever informações de tarifas mínimas. GTFS V2 é um método atualizado que permite um relato mais detalhado da estrutura tarifária de uma agência. Ambos podem estar presentes em um conjunto de dados, mas apenas um método deve ser usado por um consumidor de dados para um determinado conjunto de dados. Recomenda-se que o GTFS V2 tenha precedência sobre o GTFS V1.

Os arquivos associados ao GTFS V1 são:
- fare_attributes.txt
- fare_rules.txt

Os arquivos associados a GTFS V2 são:
- fare_products.txt
- fare_leg_rules.txt
- fare_transfer_rules.txt


Nome do campo Tipo Presença Descrição
fare_id Identificação única Obrigatório Identifica uma classe tarifária.
price Flutuador não-negativo Obrigatório Preço da tarifa, na unidade especificada por currency_type.
currency_type Código da moeda Obrigatório Moeda utilizada para pagar a tarifa.
payment_method Enum Obrigatório Indica quando a tarifa deve ser paga. As opções válidas são:

0 - A tarifa é paga a bordo.
1 - A tarifa deve ser paga antes do embarque.
transfers Enum Obrigatório Indica o número de transferências permitidas nesta tarifa. As opções válidas são:

0 - Não são permitidas transferências sobre esta tarifa.
1 - Os cavaleiros podem fazer a transferência uma vez.
2 - Os cavaleiros podem fazer duas transferências.
vazio - Transferências ilimitadas são permitidas.
agency_id Referenciamento de identidade estrangeira agency.agency_id Condicionalmente Requerido Identifica o órgão competente para uma tarifa.

Condicionalmente Necessária:
- Obrigatório se múltiplas agências forem definidas em agency.txt.
- Opcional de outra forma.
transfer_duration Número inteiro não-negativo Opcional Tempo em segundos antes de uma transferência expirar. Quando transfers=0 este campo pode ser usado para indicar por quanto tempo um bilhete é válido ou pode ser deixado vazio.

fare_rules.txt

Arquivo: Condicionalmente Requerido

Chave primária(*)

A tabela fare_rules.txt especifica como as tarifas em fare_attributes.txt se aplicam a um itinerário. A maioria das estruturas tarifárias utiliza alguma combinação das seguintes regras:

  • A tarifa depende das estações de origem ou destino.
  • A tarifa depende das zonas por onde o itinerário passa.
  • A tarifa depende da rota que o itinerário utiliza.

Para exemplos que demonstram como especificar uma estrutura tarifária com fare_rules.txt e fare_attributes.txt, veja https://code.google.com/p/googletransitdatafeed/wiki/FareExamples no wiki do projeto open source do GoogleTransitDataFeed.

Nome do campo Tipo Presença Descrição
fare_id Referenciamento de identidade estrangeira fare_attributes.fare_id Obrigatório Identifica uma classe tarifária.
route_id Referenciamento de identidade estrangeira routes.route_id Opcional Identifica uma rota associada com a classe tarifária. Se existirem várias rotas com os mesmos atributos tarifários, crie um registro em fare_rules.txt para cada itinerário.
Exemplo: Se a classe tarifária "b" for válida na rota "TSW" e "TSE", o fare_rules.txt conteria estes registros para a classe tarifária:
fare_id,route_id
b,TSW
b,TSE
origin_id Referenciamento de identidade estrangeira stops.zone_id Opcional Identifica uma zona de origem. Se uma classe tarifária tem múltiplas zonas de origem, crie um registro em fare_rules.txt para cada origin_id.
Exemplo: Se a classe tarifária "b" for válida para todas as viagens originárias da zona "2" ou da zona "8", o fare_rules.txt o arquivo conteria estes registros para a classe tarifária:
fare_id,...,origin_id
b,...,2
b,...,8
destination_id Referenciamento de identidade estrangeira stops.zone_id Opcional Identifica uma zona de destino. Se uma classe tarifária tem múltiplas zonas de destino, crie um registro em fare_rules.txt para cada destination_id.
Exemplo: O origin_id e destination_id podem ser usados juntos para especificar que a classe tarifária "b" é válida para viagens entre as zonas 3 e 4, e para viagens entre as zonas 3 e 5, os campos fare_rules.txt o arquivo conteria estes registros para a classe tarifária:
fare_id,...,origin_id,destination_id
b,...,3,4
b,...,3,5
contains_id Referenciamento de identidade estrangeira stops.zone_id Opcional Identifica as zonas em que um cavaleiro entrará enquanto utiliza uma determinada classe tarifária. Utilizado em alguns sistemas para calcular a classe tarifária correta.
Exemplo: Se a classe "c" estiver associada a todas as viagens na rota GRT que passam pelas zonas 5, 6, e 7, o fare_rules.txt conteria estes registros:
fare_id,route_id,...,contains_id
c,GRT,...,5
c,GRT,...,6
c,GRT,...,7
Porque todos os contains_id Para que a tarifa seja aplicada, um itinerário que passe pelas zonas 5 e 6, mas não pela zona 7, não teria classe tarifária "c". Para mais detalhes, veja https://code.google.com/p/googletransitdatafeed/wiki/FareExamples no wiki do projeto GoogleTransitDataFeed.

fare_products.txt

Arquivo: Opcional

Chave primáriafare_product_id)

Para descrever os diferentes tipos de bilhetes ou tarifas que podem ser comprados pelos cavaleiros.

Nome do campo Tipo Presença Descrição
fare_product_id ID Obrigatório Identifica um produto tarifário.
fare_product_name Texto Opcional O nome do produto tarifário como exibido aos cavaleiros.
amount Montante em moeda Obrigatório O custo do produto tarifário. Pode ser negativo para representar descontos de transferência. Pode ser zero para representar um produto tarifário que é gratuito.
currency Código da moeda Obrigatório A moeda do custo do produto tarifário.

fare_leg_rules.txt

Arquivo: Opcional

Chave primárianetwork_id, from_area_id, to_area_id, fare_product_id)

Regras tarifárias para viagens com trajetos individuais.

As tarifas em fare_leg_rules.txt devem ser consultadas filtrando todos os registros no arquivo para encontrar regras que correspondam à perna a ser percorrida pelo cavaleiro.

Para processar o custo de uma perna:

  1. O arquivo fare_leg_rules.txt deve ser filtrado pelos campos que definem as características da viagem, estes campos são:
    • fare_leg_rules.network_id
    • from_area_id
    • regras_regras_de_regras.to_area_id


  1. Se a perna corresponder exatamente a um registro em fare_leg_rules.txt baseado nas características da viagem, esse registro deve ser processado para determinar o custo da perna.
  2. Se não forem encontradas correspondências exatas, então as entradas vazias em fare_leg_rules.network_id, fare_leg_rules.from_area_id, and fare_leg_rules.to_area_id devem ser verificadas para processar o custo da perna:
    • Uma entrada vazia em fare_leg_rules.network_id corresponde a todas as redes definidas em routes.txt excluindo as listadas em fare_leg_rules.network_id
    • Uma entrada vazia em fare_leg_rules.from_area_id corresponde a todas as áreas definidas em áreas.area_id excluindo as listadas em fare_leg_rules.from_area_id
    • Uma entrada vazia em fare_leg_rules.to_area_id corresponde a todas as áreas definidas em áreas.area_id excluindo as listadas em fare_leg_rules.to_area_id


  1. Se a perna não corresponde a nenhuma das regras descritas acima, então a tarifa é desconhecida.


Nome do campo Tipo Presença Descrição
leg_group_id ID Opcional Identifica um grupo de entradas em fare_leg_rules.txt.

Usado para descrever as regras de transferência de tarifas entre fare_transfer_rules.from_leg_group_id e fare_transfer_rules.to_leg_group_id.

Entradas múltiplas em fare_leg_rules.txt podem pertencer ao mesmo fare_leg_rules.leg_group_id.

A mesma entrada em fare_leg_rules.txt (não incluindo fare_leg_rules.leg_group_id) não devem pertencer a múltiplos fare_leg_rules.leg_group_id.
network_id Referenciamento de identidade estrangeira routes.network_id Opcional Identifica uma rede de rotas que se aplica para a regra da tarifa de percurso.

Se não houver correspondência fare_leg_rules.network_id valores para os network_id sendo filtrado, vazio fare_leg_rules.network_id será igualado por padrão.

Uma entrada vazia em fare_leg_rules.network_id corresponde a todas as redes definidas em routes.txt excluindo os listados em fare_leg_rules.network_id
from_area_id Referenciamento de identidade estrangeira areas.area_id Opcional Identifica uma área de partida.

Se não houver correspondência fare_leg_rules.from_area_id valores para os area_id sendo filtrado, vazio fare_leg_rules.from_area_id será correspondida por padrão.

Uma entrada vazia em fare_leg_rules.from_area_id corresponde a todas as áreas definidas em areas.area_id excluindo os listados em fare_leg_rules.from_area_id
to_area_id Referenciamento de identidade estrangeira areas.area_id Opcional Identifica uma área de chegada.

Se não houver correspondência fare_leg_rules.to_area_id valores para os area_id sendo filtrado, vazio fare_leg_rules.to_area_id será correspondido por padrão.

Uma entrada vazia em fare_leg_rules.to_area_id corresponde a todas as áreas definidas em areas.area_id excluindo os listados em fare_leg_rules.to_area_id
fare_product_id Referenciamento de identidade estrangeira fare_products.fare_product_id Obrigatório O produto tarifário necessário para percorrer a perna.

fare_transfer_rules.txt

Arquivo: Opcional

Chave primáriafrom_leg_group_id, to_leg_group_id fare_product_id, transfer_count, duration_limit)

Regras tarifárias para transferências entre pernas de viagem definidas em fare_leg_rules.txt.

Para processar o custo de uma viagem com várias pernas:

  1. Os grupos de trajetos aplicáveis definidos em fare_leg_rules.txt devem ser determinados para todos os trajetos individuais de viagem com base na viagem do cavaleiro.

  2. O arquivo fare_transfer_rules.txt deve ser filtrado pelos campos que definem as características da transferência, estes campos são:

    • fare_transferir_rules.from_leg_group_id
    • regras_de_transferência_de_regras.to_leg_group_id

  3. Se a transferência corresponder exatamente a um registro em fare_transfer_rules.txt baseado nas características da transferência, então esse registro deve ser processado para determinar o custo da transferência.

  4. Se nenhuma correspondência exata for encontrada, então as entradas vazias em from_leg_group_id ou in to_leg_group_id devem ser verificadas para processar o custo da transferência:

    • Uma entrada vazia em fare_transfer_rules.from_leg_group_id corresponde a todos os grupos de pernas definidos em fare_leg_rules.leg_group_id excluindo os listados em fare_transfer_rules.from_leg_group_id
    • Uma entrada vazia em fare_transfer_rules.to_leg_group_id corresponde a todos os grupos de pernas definidos em fare_leg_rules.leg_group_id excluindo os listados em fare_transfer_rules.to_leg_group_id

  5. Se a transferência não corresponder a nenhuma das regras descritas acima, então não há acordo de transferência e as pernas são consideradas separadas.


Nome do campo Tipo Presença Descrição
from_leg_group_id Referenciamento de identidade estrangeira fare_leg_rules.leg_group_id Opcional Identifica um grupo de regras de tarifas de pré-transferência.

Se não houver correspondência fare_transfer_rules.from_leg_group_id valores para os leg_group_id sendo filtrado, vazio fare_transfer_rules.from_leg_group_id será correspondida por padrão.

Uma entrada vazia em fare_transfer_rules.from_leg_group_id corresponde a todos os grupos de pernas definidos em fare_leg_rules.leg_group_id excluindo os listados em fare_transfer_rules.from_leg_group_id
to_leg_group_id Referenciamento de identidade estrangeira fare_leg_rules.leg_group_id Opcional Identifica um grupo de regras de percurso de tarifa pós-transferência.

Se não houver correspondência fare_transfer_rules.to_leg_group_id valores para os leg_group_id sendo filtrado, vazio fare_transfer_rules.to_leg_group_id será correspondido por padrão.

Uma entrada vazia em fare_transfer_rules.to_leg_group_id corresponde a todos os grupos de pernas definidos em fare_leg_rules.leg_group_id excluindo os listados em fare_transfer_rules.to_leg_group_id
transfer_count Inteiro não-zero Proibido condicionalmente Define a quantas transferências consecutivas a regra de transferência pode ser aplicada.

As opções válidas são: :
-1 - Sem limite.
1 ou mais - Define quantas transferências a regra de transferência pode abranger.

Se uma sub-jornada corresponder a vários registros com diferentes transfer_counts, então a regra com o mínimo transfer_count que seja maior ou igual à contagem de transferência atual da sub-jornada deve ser selecionada.

Condicionalmente Proibida:
- Proibido se fare_transfer_rules.from_leg_group_id não é igual a fare_transfer_rules.to_leg_group_id.
- Obrigatório se fare_transfer_rules.from_leg_group_id igual a fare_transfer_rules.to_leg_group_id.
duration_limit Número inteiro positivo Opcional Define o limite de duração da transferência.

Deve ser expresso em incrementos inteiros de segundos.

Se não houver limite de duração, fare_transfer_rules.duration_limit deve estar vazio.
duration_limit_type Enum Condicionalmente Requerido Define o início e o fim relativos de fare_transfer_rules.duration_limit.

As opções válidas são: :
0 - Entre a validação da tarifa de partida do percurso atual e a validação da tarifa de chegada do percurso seguinte.
1 - Entre a validação da tarifa de partida do trecho atual e a validação da tarifa de partida do trecho seguinte.
2 - Entre a validação da tarifa de chegada do trecho atual e a validação da tarifa de partida do trecho seguinte.
3 - Entre a validação da tarifa de chegada do trecho atual e a validação da tarifa de chegada do próximo trecho.

Condicionalmente Necessária:
- Obrigatório se fare_transfer_rules.duration_limit está definido.
- Proibido se fare_transfer_rules.duration_limit está vazio.
fare_transfer_type Enum Obrigatório Indica o método de processamento de custos de transferência entre trajetos em uma viagem:

As opções válidas são: :
0 - Da perna fare_leg_rules.fare_product_id mais fare_transfer_rules.fare_product_id; A + AB.
1 - Da perna fare_leg_rules.fare_product_id mais fare_transfer_rules.fare_product_id mais a perna fare_leg_rules.fare_product_id; A + AB + B.
2 - fare_transfer_rules.fare_product_id; AB.

Interações de processamento de custos entre múltiplas transferências em uma viagem:

fare_transfer_typeProcessamento A > BProcessamento B > C
0A + ABS + BC
1A + AB +BS + BC + C
2ABS + BC
Onde S indica o custo total processado da(s) etapa(s) anterior(es) e transferência(ões).
fare_product_id Referenciamento de identidade estrangeira fare_products.fare_product_id Opcional O produto tarifário necessário para a transferência entre dois trajetos tarifários. Se estiver vazio, o custo da regra de transferência é 0.

areas.txt

Arquivo: Opcional

Chave primáriaarea_id)

Define os identificadores de área.

Nome do campo Tipo Presença Descrição
area_id Identificação única Obrigatório Identifica uma área. Deve ser única em areas.txt.
area_name Texto Opcional O nome da área como exibido para o cavaleiro.

stop_areas.txt

Arquivo: Opcional

Chave primária(*)

Atribui paradas de stops.txt a áreas.

Nome do campo Tipo Presença Descrição
area_id Referenciamento de identidade estrangeira areas.area_id Obrigatório Identifica uma área para a qual um ou vários stop_ids pertencem. O mesmo stop_id pode ser definido em muitos area_ids.
stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Identifica uma parada. Se uma estação (ou seja, uma parada com stops.location_type=1) é definido neste campo, assume-se que todas as suas plataformas (ou seja, todas as paradas com stops.location_type=0 que têm esta estação definida como stops.parent_station) fazem parte da mesma área. Este comportamento pode ser anulado através da atribuição de plataformas a outras áreas.

shapes.txt

Arquivo: Opcional

Chave primáriashape_id, shape_pt_sequence)

As formas descrevem o caminho que um veículo percorre ao longo de um alinhamento de rota, e são definidas no arquivo shapes.txt As formas são associadas com Viagens, e consistem em uma seqüência de pontos através dos quais o veículo passa em ordem. Os formatos não precisam interceptar exatamente a localização das Paradas, mas todas as Paradas em uma viagem devem ficar a uma pequena distância da forma para essa viagem, ou seja, perto de segmentos de linha reta conectando os pontos de forma.

Nome do campo Tipo Presença Descrição
shape_id ID Obrigatório Identifica uma forma.
shape_pt_lat Latitude Obrigatório Latitude de um ponto de forma. Cada registro em shapes.txt representa um ponto de forma utilizado para definir a forma.
shape_pt_lon Longitude Obrigatório Longitude de um ponto de forma.
shape_pt_sequence Número inteiro não-negativo Obrigatório Seqüência na qual os pontos de forma se conectam para formar a forma. Os valores devem aumentar ao longo da viagem, mas não precisam ser consecutivos.
Exemplo: Se a forma "A_shp" tem três pontos em sua definição, a shapes.txt O arquivo pode conter esses registros para definir a forma:
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence
A_shp,37.61956,-122.48161,0
A_shp,37.64430,-122.41070,6
A_shp,37.65863,-122.30839,11
shape_dist_traveled Flutuador não-negativo Opcional A distância real percorrida ao longo da forma desde o primeiro ponto de forma até o ponto especificado neste registro. Usado por planejadores de viagem para mostrar a parte correta da forma em um mapa. Os valores devem aumentar junto com shape_pt_sequenceNão devem ser usados para mostrar o percurso inverso ao longo de uma rota. As unidades de distância devem ser consistentes com aquelas utilizadas em stop_times.txt.
Exemplo: Se um ônibus viajar ao longo dos três pontos definidos acima para A_shp, o adicional shape_dist_traveled valores (mostrados aqui em quilômetros) ficariam assim:
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
A_shp,37.61956,-122.48161,0,0
A_shp,37.64430,-122.41070,6,6.8310
A_shp,37.65863,-122.30839,11,15.8765

frequencies.txt

Arquivo: Opcional

Chave primáriatrip_id, start_time)

frequencies.txt representa viagens que operam em viagens regulares (tempo entre viagens). Este arquivo pode ser usado para representar dois tipos diferentes de serviço.

  • Serviço baseado em freqüência(horas_exatas=0) no qual o serviço não segue um Schedule fixo ao longo do dia. Em vez disso, os operadores tentam manter rigorosamente as viagens em trajetos pré-determinados.
  • Uma representação comprimida do serviço Schedule(horários_exatos=1) que tem exatamente o mesmo avanço para viagens durante um período de tempo especificado(s). Em serviços Schedule, os operadores tentam aderir estritamente a um Schedule.
Nome do campo Tipo Presença Descrição
trip_id Referenciamento de identidade estrangeira trips.trip_id Obrigatório Identifica uma viagem à qual se aplica o avanço de serviço especificado.
start_time Hora Obrigatório Hora em que o primeiro veículo sai da primeira parada da viagem com o avanço especificado.
end_time Hora Obrigatório Hora em que o serviço muda para uma rota diferente (ou cessa) na primeira parada da viagem.
headway_secs Número inteiro positivo Obrigatório Tempo, em segundos, entre as partidas da mesma parada (avanço da viagem) para a viagem, durante o intervalo de tempo especificado por start_time e end_time. Podem ser definidas várias passagens para a mesma viagem, mas não devem se sobrepor. As novas avenidas podem começar no momento exato em que a avenida anterior termina.
exact_times Enum Opcional Indica o tipo de serviço para uma viagem. Veja a descrição do arquivo para maiores informações. As opções válidas são:

0 ou vazio - viagens com base na freqüência.
1 - Viagens Schedule com exatamente o mesmo avanço ao longo do dia. Neste caso, o end_time valor deve ser maior do que a última viagem desejada start_time mas menos do que a última viagem desejada, start_time + headway_secs.

transfers.txt

Arquivo: Opcional

Chave primáriafrom_stop_id, to_stop_id, from_trip_id, to_trip_id, from_route_id, to_route_id)

Ao calcular um itinerário, as aplicações GTFS interpolam as transferências com base no tempo permitido e na proximidade da parada. transfers.txt especifica regras adicionais e sobreposições para transferências selecionadas.

Os campos from_trip_id, from_route_id e to_route_id permitem ordens superiores de especificidade para regras de transferência. Junto com to_stop_id, o ranking de especificidade é o seguinte:

  1. Ambos os trip_iddefinidos: from_trip_id e to_trip_id.
  2. Um conjunto de trip_id e route_id definidos:from_trip_id e to_route_id) oufrom_route_id e to_trip_id).
  3. Um trip_id definido: from_trip_id ou to_trip_id.
  4. Ambas as route_idsão definidas: from_route_id e to_route_id.
  5. Um route_id definido: from_route_id ou to_route_id.
  6. Somente from_stop_id e to_stop_id definido: nenhum campo relacionado a_via ou viagem definido.

Para um determinado par ordenado de viagem de chegada e partida, é escolhida a transferência com a maior especificidade que se aplica entre estas duas viagens. Para qualquer par de viagens, não deve haver duas transferências com a mesma especificidade máxima que poderia se aplicar.

Nome do campo Tipo Presença Descrição
from_stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Identifica uma parada ou estação onde se inicia uma conexão entre as rotas. Se este campo se refere a uma estação, a regra de transferência se aplica a todas as suas paradas infantis.
to_stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Identifica uma parada ou estação onde termina uma conexão entre os itinerários. Se este campo se refere a um ramal, a regra de transferência se aplica a todas as paradas infantis.
from_route_id Referenciamento de identidade estrangeira routes.route_id Opcional Identifica um itinerário onde começa uma conexão.

Se from_route_id for definido, a transferência se aplicará à viagem de chegada no itinerário para o from_stop_id.

Se ambos from_trip_id e from_route_id são definidos, os trip_id deve pertencer ao route_ide from_trip_id terá precedência.
to_route_id Referenciamento de identidade estrangeira routes.route_id Opcional Identifica uma rota onde termina uma conexão.

Se to_route_id é definida, a transferência se aplicará à viagem de partida na rota para o determinado to_stop_id.

Se ambos to_trip_id e to_route_id são definidos, os trip_id deve pertencer ao route_ide to_trip_id terá precedência.
from_trip_id Referenciamento de identidade estrangeira trips.trip_id Opcional Identifica uma viagem onde começa uma conexão entre as rotas.

Se from_trip_id é definida, a transferência se aplicará à viagem de chegada para a from_stop_id.

Se ambos from_trip_id e from_route_id são definidos, os trip_id deve pertencer ao route_ide from_trip_id terá precedência.
to_trip_id Referenciamento de identidade estrangeira trips.trip_id Opcional Identifica uma viagem onde termina uma conexão entre as rotas.

Se to_trip_id é definida, a transferência se aplicará à viagem de partida para a to_stop_id.

Se ambos to_trip_id e to_route_id são definidos, os trip_id deve pertencer ao route_ide to_trip_id terá precedência.
transfer_type Enum Obrigatório Indica o tipo de conexão para o especificado (from_stop_id, to_stop_id) par. As opções válidas são:

0 ou vazio - Ponto de transferência recomendado entre as rotas.
1 - Ponto de transferência temporizado entre dois itinerários. Espera-se que o veículo de partida aguarde a chegada e deixe tempo suficiente para que o cavaleiro se transfira entre os itinerários.
2 - A transferência requer um tempo mínimo entre a chegada e a partida para garantir uma conexão. O tempo necessário para a transferência é especificado por min_transfer_time.
3 - As transferências não são possíveis entre as rotas no local.
min_transfer_time Número inteiro não-negativo Opcional Quantidade de tempo, em segundos, que deve estar disponível para permitir uma transferência entre as rotas nas paradas especificadas. O min_transfer_time deve ser suficiente para permitir que um cavaleiro típico se movimente entre as duas paradas, incluindo o tempo de amortecimento para permitir a variação do Schedule em cada rota.

pathways.txt

Arquivo: Opcional

Chave primáriapathway_id)

Os arquivos pathways.txt e levels.txt utilizam uma representação gráfica para descrever estações de metrô ou trem, com nós representando localizações e bordas representando caminhos.

Para navegar da entrada/saída da estação (um nó representado como um local com location_type=2) para uma plataforma (um nó representado como um local com location_type=0 ou vazio), o cavaleiro se moverá por passarelas, portões de passagem, escadas e outras arestas representadas como caminhos. Nós genéricos (nós representados como um local_type=3) podem ser usados para conectar caminhos através de uma estação.

Os caminhos devem ser definidos de forma exaustiva em uma estação. Se algum caminho for definido, presume-se que todos os caminhos ao longo da estação sejam representados. Portanto, aplicam-se as seguintes diretrizes:

  • Sem locais de pendência: Se qualquer local dentro de uma estação tiver um caminho, então todos os locais dentro dessa estação devem ter caminhos, exceto plataformas que tenham áreas de embarque(location_type=4, ver diretriz abaixo).
  • Não há caminhos para uma plataforma com áreas de embarque: Uma plataforma(location_type=0 ou vazia) que tenha áreas de embarque(location_type=4) é tratada como um objeto pai, não como um ponto. Nesses casos, a plataforma não deve ter caminhos atribuídos. Todos os caminhos devem ser designados para cada uma das áreas de embarque da plataforma.
  • Não há plataformas bloqueadas: Cada plataforma(location_type=0 ou vazia) ou área de embarque(location_type=4) deve ser conectada a pelo menos uma entrada/saída(location_type=2) através de alguma cadeia de caminhos. Estações que não permitem um caminho para o exterior da estação a partir de uma determinada plataforma são raras.
Nome do campo Tipo Presença Descrição
pathway_id Identificação única Obrigatório Identifica um caminho. Utilizado pelos sistemas como um identificador interno para o registro. Deve ser único no conjunto de dados.

Caminhos diferentes podem ter os mesmos valores para from_stop_id e to_stop_id.
Exemplo: Quando duas escadas rolantes estão lado a lado em direções opostas, ou quando uma escada e um elevador vão do mesmo lugar para o mesmo lugar, diferentes pathway_id pode ter o mesmo from_stop_id e to_stop_id valores.
from_stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Local em que o caminho começa.

Deve conter um stop_id que identifica uma plataforma (location_type=0 ou vazio), entrada/saída (location_type=2), nó genérico (location_type=3) ou área de embarque (location_type=4).

Valores para stop_id que identificam estações (location_type=1) são proibidos.
to_stop_id Referenciamento de identidade estrangeira stops.stop_id Obrigatório Local em que o caminho termina.

Deve conter um stop_id que identifica uma plataforma (location_type=0 ou vazio), entrada/saída (location_type=2), nó genérico (location_type=3) ou área de embarque (location_type=4).

Valores para stop_id que identificam estações (location_type=1) são proibidos.
pathway_mode Enum Obrigatório Tipo de caminho entre o especificado (from_stop_id, to_stop_id) par. As opções válidas são:

1 - Passarela.
2 - Escadaria.
3 - Calçada/viagem em movimento.
4 - Escada rolante.
5 - Elevador.
6 - Porta de passagem (ou porta de pagamento): Um caminho que atravessa uma área da estação onde é necessário comprovante de pagamento para atravessar. Portões tarifários podem separar as áreas pagas da estação das não pagas, ou separar áreas de pagamento diferentes dentro da mesma estação umas das outras. Esta informação pode ser usada para evitar o encaminhamento de passageiros através das estações usando atalhos que exigiriam que os passageiros fizessem pagamentos desnecessários, como direcionar um passageiro para passar por uma plataforma de metrô para chegar a uma linha de ônibus.
7- Portão de saída: Um caminho de saída de uma área paga para uma área não paga onde não é necessário comprovante de pagamento para atravessar.
is_bidirectional Enum Obrigatório Indica a direção em que o caminho pode ser percorrido:

0 - Caminho unidirecional que só pode ser usado a partir de from_stop_id para to_stop_id.
1 - Caminho bidirecional que pode ser usado em ambas as direções.

Portões de saída (pathway_mode=7) não deve ser bidirecional.
length Flutuador não-negativo Opcional O comprimento horizontal em metros do trajeto desde o local de origem (definido em from_stop_id) até o local de destino (definido em to_stop_id).

Este campo é recomendado para passarelas (pathway_mode=1), portões tarifários (pathway_mode=6) e portões de saída (pathway_mode=7).
traversal_time Número inteiro positivo Opcional Tempo médio em segundos necessário para percorrer o caminho a partir do local de origem (definido em from_stop_id) até o local de destino (definido em to_stop_id).

Este campo é recomendado para a movimentação de calçadas (pathway_mode=3), escadas rolantes (pathway_mode=4) e elevador (pathway_mode=5).
stair_count Número inteiro não-nulo Opcional Número de escadas do caminho.

Um positivo stair_count implica que o cavaleiro suba de from_stop_id para to_stop_id. E um negativo stair_count implica que o cavaleiro desça de from_stop_id para to_stop_id.

Este campo é recomendado para escadas (pathway_mode=2).

Se apenas uma contagem estimada de escadas puder ser fornecida, recomenda-se a aproximação de 15 escadas para 1 andar.
max_slope Flutuador - Um número de ponto flutuante Opcional Relação máxima de declive do caminho. As opções válidas são:

0 ou vazia - Sem declive.
Float - Relação de inclinação da via, positiva para cima, negativa para baixo.

Este campo deve ser usado somente com passarelas (pathway_mode=1) e calçadas em movimento (pathway_mode=3).
Exemplo: Nos EUA, 0,083 (também escrito 8,3%) é a relação de inclinação máxima para cadeira de rodas de propulsão manual, o que significa um aumento de 0,083m (assim 8,3cm) para cada 1m.
min_width Flutuador positivo Opcional Largura mínima do trajeto em metros.

Este campo é recomendado se a largura mínima for inferior a 1 metro.
signposted_as Texto Opcional Texto de sinalização física visível para os cavaleiros.

Pode ser usado para fornecer instruções de texto aos cavaleiros, tais como "seguir os sinais para". O texto em singposted_as deve aparecer exatamente como está impresso nas placas.

Quando a sinalização física é multilíngüe, este campo pode ser preenchido e traduzido seguindo o exemplo de stops.stop_name na definição de campo de feed_info.feed_lang.
reversed_signposted_as Texto Opcional O mesmo que signposted_asmas quando o caminho é usado a partir do to_stop_id para o from_stop_id.

levels.txt

Arquivo: Condicionalmente Requerido

Chave primárialevel_id)

Descreve os níveis em uma estação. Útil em conjunto com o pathways.txt, e é necessário para navegar por caminhos com elevadores(pathway_mode=5).

Nome do campo Tipo Presença Descrição
level_id Identificação única Obrigatório Identifica um nível em uma estação.
level_index Flutuar Obrigatório Índice numérico do nível que indica sua posição relativa.

O nível do solo deve ter índice 0com níveis acima do solo indicados por índices positivos e níveis abaixo do solo indicados por índices negativos.
level_name Texto Opcional Nome do nível visto pelo cavaleiro dentro do edifício ou estação.
Exemplo: Pegue o elevador para "Mezanino" ou "Plataforma" ou "-1".

translations.txt

Arquivo: Opcional

Chave primáriatable_name, field_name, language, record_id, record_sub_id, field_value)

Em regiões que têm vários idiomas oficiais, as agências/operadores de trânsito normalmente têm nomes e páginas da web com language. A fim de melhor servir os cavaleiros nessas regiões, é útil que o conjunto de dados inclua esses valores language.

Nome do campo Tipo Presença Descrição
table_name Enum Obrigatório Define a tabela que contém o campo a ser traduzido. Os valores permitidos são:

- agency
- stops
- routes
- trips
- stop_times
- pathways
- levels
- feed_info
- attributions

Qualquer arquivo adicionado ao GTFS terá um table_name valor equivalente ao nome do arquivo, como listado acima (isto é, não incluindo o .txt extensão do arquivo).
field_name Texto Obrigatório Nome do campo a ser traduzido. Campos com tipo Text podem ser traduzidos, campos com tipo URL, Email e Phone number também podem ser "traduzidos" para fornecer recursos no language correto. Os campos com outros tipos não devem ser traduzidos.
language códigolanguage Obrigatório language da tradução.

Se o language for o mesmo que em feed_info.feed_lango valor original do campo será assumido como o valor padrão a ser usado em idiomas sem traduções específicas (se default_lang não especifica o contrário).
Exemplo: Na Suíça, uma cidade em um cantão oficialmente bilíngüe é oficialmente chamada "Biel/Bienne", mas seria simplesmente chamada de "Bienne" em francês e "Biel" em alemão.
translation Texto ou URL ou e-mail ou número de telefone Obrigatório Valor traduzido.
record_id Identificação estrangeira Condicionalmente Requerido Define o registro que corresponde ao campo a ser traduzido. O valor em record_id deve ser o primeiro ou único campo da chave primária de uma tabela, conforme definido no atributo da chave primária para cada tabela e abaixo:

- agency_id para agency.txt
- stop_id para stops.txt;
- route_id para routes.txt;
- trip_id para trips.txt;
- trip_id para stop_times.txt;
- pathway_id para pathways.txt;
- level_id para levels.txt;
- attribution_id para attribution.txt.

Os campos em tabelas não definidas acima não devem ser traduzidos. Entretanto, os produtores às vezes adicionam campos extras que estão fora da especificação oficial e estes campos não oficiais podem ser traduzidos. Abaixo está a forma recomendada de uso record_id para essas mesas:

- service_id para calendar.txt;
- service_id para calendar_dates.txt;
- fare_id para fare_attributes.txt;
- fare_id para fare_rules.txt;
- shape_id para shapes.txt;
- trip_id para frequencies.txt;
- from_stop_id para transfers.txt.

Condicionalmente Necessária:
- Proibido se table_name é feed_info.
- Proibido se field_value está definido.
- Obrigatório se field_value está vazio.
record_sub_id Identificação estrangeira Condicionalmente Requerido Ajuda o registro que contém o campo a ser traduzido quando a tabela não tem uma identificação única. Portanto, o valor em record_sub_id é a identificação secundária da tabela, conforme definido pela tabela abaixo:

- Nenhum para agency.txt;
- Nenhum para stops.txt;
- Nenhum para routes.txt;
- Nenhum para trips.txt;
- stop_sequence para stop_times.txt;
- Nenhum para pathways.txt;
- Nenhum para levels.txt;
- Nenhum para attributions.txt.

Os campos nas tabelas não definidas acima não devem ser traduzidos. Entretanto, os produtores às vezes adicionam campos extras que estão fora da especificação oficial e estes campos não oficiais podem ser traduzidos. Abaixo está a forma recomendada de uso record_sub_id para essas mesas:

- Nenhum para calendar.txt;
- date para calendar_dates.txt;
- Nenhum para fare_attributes.txt;
- route_id para fare_rules.txt;
- Nenhum para shapes.txt;
- start_time para frequencies.txt;
- to_stop_id para transfers.txt.

Condicionalmente Necessária:
- Proibido se table_name é feed_info.
- Proibido se field_value está definido.
- Obrigatório se table_name=stop_times e record_id está definido.
field_value Texto ou URL ou e-mail ou número de telefone Condicionalmente Requerido Em vez de definir qual registro deve ser traduzido, usando record_id e record_sub_idEste campo pode ser usado para definir o valor que deve ser traduzido. Quando utilizada, a tradução será aplicada quando os campos identificados por table_name e field_name contém exatamente o mesmo valor definido no field_value.

O campo deve ter exatamente o valor definido em field_value. Se apenas um subconjunto do valor corresponder field_valuea tradução não será aplicada.

Se duas regras de tradução corresponderem ao mesmo registro (uma com field_valuee a outra com record_id), a regra com record_id tem precedência.

Condicionalmente Necessária:
- Proibido se table_name é feed_info.
- Proibido se record_id está definido.
- Obrigatório se record_id está vazio.

feed_info.txt

Arquivo: Opcional(Obrigatório se for fornecida translations.txt )

Chave primária (nenhuma)

O arquivo contém informações sobre o conjunto de dados em si, ao invés dos serviços que o conjunto de dados descreve. Em alguns casos, a editora do conjunto de dados é uma entidade diferente de qualquer uma das agências.

Se ambos os métodos de referênciarecord_id, record_sub_id) e field_value forem usados para traduzir o mesmo valor em 2 linhas diferentes, a tradução fornecida comrecord_id, record_sub_id) tem precedência.

Nome do campo Tipo Presença Descrição
feed_publisher_name Texto Obrigatório Nome completo da organização que publica o conjunto de dados. Este pode ser o mesmo que um dos agency.agency_name valores.
feed_publisher_url URL Obrigatório URL do site da organização editora do conjunto de dados. Este pode ser o mesmo que um dos agency.agency_url valores.
feed_lang códigolanguage Obrigatório language padrão utilizada para o texto neste conjunto de dados. Esta configuração ajuda os consumidores GTFS a escolher regras de capitalização e outras configurações language para o conjunto de dados. O arquivo translations.txt pode ser usado se o texto precisar ser traduzido para outros idiomas que não o padrão.

O language padrão pode ser multilíngüe para conjuntos de dados com o texto original em vários idiomas. Nesses casos, o feed_lang deve conter o código do language mul definido pela norma ISO 639-2, e uma tradução para cada language utilizado no conjunto de dados deve ser fornecida em translations.txt. Se todo o texto original no conjunto de dados estiver no mesmo language, então mul não deve ser usado.
Exemplo: Considere um conjunto de dados de um país multilíngüe como a Suíça, com o original stops.stop_name campo populado com nomes de parada em diferentes idiomas. Cada nome de parada é escrito de acordo com o language dominante na localização geográfica daquela parada, por exemplo Genève para a cidade francófona de Genebra, Zürich para a cidade germanófona de Zurique, e Biel/Bienne para a cidade bilíngüe de Biel/Bienne. O conjunto de dados feed_lang deve ser mul e traduções seriam fornecidas em translations.txt, em alemão: Genf, Zürich e Biel; em francês: Genève, Zurich e Bienne; em italiano: ; em francês: ; em italiano: Ginevra, Zurigo e Bienna; ; e em inglês: Geneva, Zurich e Biel/Bienne.
default_lang códigolanguage Opcional Define o language que deve ser usado quando o consumidor de dados não conhece o language do cavaleiro. Muitas vezes será en (Inglês).
feed_start_date Data Opcional O conjunto de dados fornece informações completas e confiáveis sobre Schedule serviço no período desde o início do feed_start_date dia até o final do feed_end_date dia. Os dois dias podem ser deixados vazios se não estiverem disponíveis. O feed_end_date data não deve preceder a feed_start_date data, se ambas forem dadas. Recomenda-se que os fornecedores de conjuntos de dados forneçam dados de Schedule fora deste período para avisar sobre o provável serviço futuro, mas os consumidores de conjuntos de dados devem tratá-los levando em conta seu status de não-autoridade. Se feed_start_date ou feed_end_date se estendem além das datas ativas do calendário definidas em calendar.txt e calendar_dates.txto conjunto de dados está fazendo uma afirmação explícita de que não há serviço para datas dentro do feed_start_date ou feed_end_date mas não incluídas nas datas ativas do calendário.
feed_end_date Data Opcional (ver acima)
feed_version Texto Opcional String que indica a versão atual de seu conjunto de dados GTFS. As aplicações GTFS podem exibir este valor para ajudar os editores do conjunto de dados a determinar se o último conjunto de dados foi incorporado.
feed_contact_email Email Opcional Endereço de e-mail para comunicação a respeito do conjunto de dados GTFS e práticas de publicação de dados. feed_contact_email é um contato técnico para aplicações GTFS. Fornecer informações de contato de atendimento ao cliente através de agency.txt.
feed_contact_url URL Opcional URL para informações de contato, um formulário web, uma mesa de suporte ou outras ferramentas de comunicação relativas ao conjunto de dados GTFS e práticas de publicação de dados. feed_contact_url é um contato técnico para aplicações GTFS. Fornecer informações de contato de atendimento ao cliente através de agency.txt.

attributions.txt

Arquivo: Opcional

Chave primáriaattribution_id)

O arquivo define as atribuições aplicadas ao conjunto de dados.

Nome do campo Tipo Presença Descrição
attribution_id Identificação única Opcional Identifica uma atribuição para o conjunto de dados ou um subconjunto do mesmo. Isto é útil principalmente para traduções.
agency_id Referenciamento de identidade estrangeira agency.agency_id Opcional Agência à qual a atribuição se aplica.

Se um agency_id, route_idou trip_id atribuição é definida, as outras devem estar vazias. Se nenhuma delas for especificada, a atribuição se aplicará a todo o conjunto de dados.
route_id Referenciamento de identidade estrangeira routes.route_id Opcional Funciona da mesma forma que agency_id exceto que a atribuição se aplica a uma rota. Atribuições múltiplas podem se aplicar à mesma rota.
trip_id Referenciamento de identidade estrangeira trips.trip_id Opcional Funciona da mesma forma que agency_id exceto que a atribuição se aplica a uma viagem. Atribuições múltiplas podem se aplicar à mesma viagem.
organization_name Texto Obrigatório Nome da organização à qual o conjunto de dados é atribuído.
is_producer Enum Opcional O papel da organização é produtor. As opções válidas são:

0 ou vazio - A organização não tem esta função.
1 - A organização tem esta função.

Pelo menos um dos campos is_producer, is_operatorou is_authority deve ser fixado em 1.
is_operator Enum Opcional Funciona da mesma forma que is_producer exceto que o papel da organização é operador.
is_authority Enum Opcional Funciona da mesma forma que is_producer exceto que o papel da organização é a autoridade.
attribution_url URL Opcional URL da organização.
attribution_email Email Opcional E-mail da organização.
attribution_phone Número de telefone Opcional Número de telefone da organização.