Presença do ficheiro de pisos
Verifica se levels.txt está presente quando pathways.txt descreve um elevador ou quando a configuração da regra o exige.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | levels_file_missing |
| Ficheiros | levels.txt, pathways.txt |
| Campo | Se aplica em todo o ficheiro |
| Tipo | Ficheiro |
| Severidade | Condicional (obrigatório quando pathways.txt contém um elevador; opcional nos restantes casos) |
Como funciona
Quando a regra passa, levels.txt está presente ou a sua ausência é permitida. O ficheiro torna-se obrigatório quando pathways.txt contém uma linha com pathway_mode igual a 5, salvo se a configuração ignorar a regra. A regra não verifica o conteúdo nem as colunas de levels.txt.
A regra avalia a presença do ficheiro levels.txt no conjunto GTFS, seguindo os passos abaixo por ordem, até um deles dar o resultado.
| # | Pergunta | Se sim | Se não |
|---|---|---|---|
| 1 | O ficheiro levels.txt está presente? | ✅ Passa | Segue para o passo 2 |
| 2 | A configuração da regra recomenda o ficheiro? | ❌ Reporta o problema: ficheiro recomendado em falta | Segue para o passo 3 |
| 3 | A configuração da regra exige o ficheiro? | ❌ Reporta o problema: ficheiro obrigatório em falta | Segue para o passo 4 |
| 4 | pathways.txt contém uma linha com pathway_mode igual a 5? | Segue para o passo 5 | ✅ Passa |
| 5 | A configuração da regra ignora a ausência? | ✅ Passa | ❌ Reporta o problema: ficheiro obrigatório com elevadores |
Como se relacionam
O valor 5 em pathway_mode identifica um elevador. Quando existe um elevador em pathways.txt, levels.txt descreve os pisos que este liga.
Exemplos
levels.txt | pathways.txt | Resultado | Porquê |
|---|---|---|---|
| presente | contém pathway_mode igual a 5 | ✅ Passa | O ficheiro de pisos existe |
| ausente, regra não ignorada | contém pathway_mode igual a 5 | ❌ Problema | O elevador exige o ficheiro de pisos |
| ausente e obrigatório | sem elevadores | ❌ Problema | Exigido pela configuração |
| ausente e recomendado | sem elevadores | ❌ Problema | Recomendado pela configuração |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Ficheiro obrigatório com elevadores | pathways.txt contém um elevador, mas falta levels.txt | Adicionar levels.txt ao conjunto GTFS ou remover de pathways.txt o elevador que torna o ficheiro obrigatório |
| Ficheiro obrigatório em falta | A configuração da regra exige levels.txt | Adicionar levels.txt ao conjunto GTFS ou rever a configuração da regra |
| Ficheiro recomendado em falta | A configuração da regra recomenda levels.txt | Adicionar levels.txt ao conjunto GTFS ou rever a configuração da regra |