Página de tarifas do operador
Verifica se o endereço de compra ou informação tarifária em agency.txt é um URL HTTP ou HTTPS válido e, quando configurado, se é permitido.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | agency_fare_url_valid_url |
| Ficheiro | agency.txt |
| Campo | agency_fare_url |
| Tipo | URL |
| Severidade | Opcional |
Descrição do campo: URL de uma página onde o passageiro pode comprar títulos de transporte ou consultar informação sobre as tarifas do operador.
Mais informação em agency.txt.
Como funciona
Se o operador indicar uma página tarifária, o URL tem de usar http ou https e incluir um domínio. Quando existe uma lista de valores permitidos, o URL também tem de constar dessa lista. A regra não confirma que a página existe, está acessível ou permite comprar títulos.
A regra avalia cada linha do agency.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 texto é um URL HTTP ou HTTPS válido, com domínio? | Segue para o passo 4 | ❌ Reporta o problema: formato inválido |
| 4 | A configuração da regra tem uma lista de URL permitidos? | Segue para o passo 5 | ✅ Passa |
| 5 | O URL está na lista? (ou a lista aceita qualquer valor) | ✅ Passa | ❌ Reporta o problema: URL não permitido |
Os espaços no início e no fim são ignorados ao verificar o formato. A comparação com a lista permitida usa o valor original completo.
Exemplos
| Valor | Resultado | Porquê |
|---|---|---|
https://operador.pt/tarifas | ✅ Passa | URL completo |
operador.pt/tarifas | ❌ Problema | Falta o protocolo |
https:// | ❌ Problema | Falta o domínio |
https://outro.pt/tarifas (lista permitida = https://operador.pt/tarifas) | ❌ Problema | Fora da lista |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Formato inválido | Falta o protocolo ou o domínio, ou existem espaços ou carateres inválidos | Escrever em agency_fare_url de agency.txt um URL completo, por exemplo https://operador.pt/tarifas |
| URL não permitido | O URL é válido mas não consta da lista configurada | Usar em agency_fare_url de agency.txt um URL permitido ou rever a lista na configuração da regra |
| Campo em falta | A configuração da regra exige ou recomenda este campo | Preencher agency_fare_url em agency.txt com o URL da página tarifária |
| Campo preenchido quando não devia | A configuração da regra define que este campo não deve ter valor | Remover o valor de agency_fare_url em agency.txt |
Correio eletrónico do operador
Verifica se o e-mail de apoio ao cliente em agency.txt está bem escrito e, quando configurado, se consta da lista de endereços permitidos.
Presença do ficheiro de operadores
Verifica se o ficheiro agency.txt está presente no conjunto GTFS quando a configuração da regra o exige ou recomenda.