Zona de origem da tarifa
Verifica se a zona de origem indicada em fare_rules.txt corresponde a um identificador de stops.txt.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | fare_rule_origin_id_references_zones_stops |
| Ficheiros | fare_rules.txt, stops.txt |
| Campo | origin_id |
| Tipo | Identificador externo |
| Severidade | Opcional |
Descrição do campo: identifica uma zona de origem. Quando uma classe tarifária aceita várias zonas de origem, deve existir uma linha em fare_rules.txt para cada origin_id.
Mais informação em fare_rules.txt e stops.txt.
Como funciona
Quando a regra passa, origin_id está vazio quando permitido ou coincide com um identificador indexado de stops.txt. A referência prevista é zone_id, mas a pesquisa atual também aceita valores presentes apenas em stop_id ou stop_code. A regra não verifica se a zona contém paragens usadas pelo itinerário.
A regra avalia cada linha do fare_rules.txt, seguindo os passos abaixo por ordem, até um deles dar o resultado.
| # | Pergunta | Se sim | Se não |
|---|---|---|---|
| 1 | O campo está vazio? | Verifica se a configuração da regra exige ou recomenda este campo. Se sim, reporta o problema. Se não, aceita | Segue para o passo 2 |
| 2 | A configuração da regra define que este campo não deve ser preenchido? | ❌ Reporta o problema | Segue para o passo 3 |
| 3 | O valor coincide com um identificador indexado de stops.txt? | ✅ Passa | ❌ Reporta o problema: zona inexistente |
O valor é comparado tal como foi escrito. Os espaços e as maiúsculas não são normalizados. Uma linha com todos os campos vazios é ignorada antes desta regra.
Como se relacionam
No modelo GTFS, origin_id deve coincidir com um zone_id de stops.txt. A validação atual pesquisa em conjunto os valores de stop_id, zone_id e stop_code.
Exemplos
origin_id em fare_rules.txt | Identificadores em stops.txt | Resultado | Porquê |
|---|---|---|---|
Z1 | zone_id = Z1 | ✅ Passa | Zona existente |
| campo vazio | zone_id = Z1 | ✅ Passa | Campo opcional |
Z9 | zone_id = Z1 | ❌ Problema | Identificador inexistente |
S1 | apenas stop_id = S1 | ✅ Passa | A pesquisa atual junta os identificadores |
Z1 quando o campo é proibido | zone_id = Z1 | ❌ Problema | Campo preenchido indevidamente |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Zona inexistente | O valor não corresponde a nenhum identificador indexado de stops.txt | Corrigir origin_id em fare_rules.txt para um zone_id existente em stops.txt |
| Campo em falta | A configuração da regra exige ou recomenda este campo | Preencher origin_id em fare_rules.txt com um zone_id existente em stops.txt |
| Campo preenchido quando não devia | A configuração da regra define que este campo não deve ter valor | Remover o valor de origin_id em fare_rules.txt |