[TOC]
O objetivo deste projeto é calcular rotas para explorar blocos, pedalando ou correndo. Para informações sobre "blocos", consulte statshunters ou veloviewer.
Requisitos:
Abra uma janela de terminal e navegue até a pasta na qual deseja baixar os blocos de rota. Escreva na janela do terminal
git clone https://github.com/BenoitBouillard/route-tiles.git
no futuro, você pode realizar uma solicitação pull para obter a versão mais recente:
git pull
seguido pela
cd route-tiles
e finalmente instalar o pacote python
pip install -r requirements.txt
Para gerar documentação HTML a partir deste leia-me:
python -m markdown README.md -f static h elp.html -x extra -x toc
Existem 2 partes:
O servidor recebe solicitações da interface do usuário e calcula a rota:
O servidor é um script python. Para iniciá-lo, execute este comando em um terminal da pasta de instalação:
python route-tile-server.py
Uma mensagem deverá ser exibida:
serving at port 8000
É possível alterar a porta com a opção --port:
> python route-tile-server.py --port 80
serving at port 80
Assim que o servidor estiver em execução, é possível usar a interface do usuário. É uma página da web. No mesmo computador que o servidor, é acessível pela url http://localhost:8000
Para encontrar um percurso, diversas informações são obrigatórias ou possíveis:
Quando houver informações suficientes, uma solicitação de rota será enviada ao servidor após alguns segundos.
O status do roteamento é exibido:
Os dados são armazenados localmente pelo navegador. Se você atualizar a página (ou fechá-la e abri-la mais tarde), os dados mais recentes serão recuperados.
É possível escolher entre vários modos:
Por alguma razão pessoal, poderíamos querer evitar o retorno na visita ao bloco (não há outro motivo para haver um retorno no cálculo da rota), mesmo que seja a rota mínima. Poderíamos aceitar fazer mais 100m ou 1km. Esta opção pode adicionar um custo adicional para cada retorno e limitá-los a um custo aceitável.
/! O algoritmo não encontra a melhor rota sem retorno (bug) /!
A posição inicial é obrigatória. A posição final é opcional. Se não houver posição final, o percurso será um loop (retorno ao ponto inicial).
Para definir a posição inicial ou final, clique no botão “Iniciar” ou “Fim” e depois no mapa para a posição. Um marcador será exibido.
É possível mover marcadores diretamente no mapa.
É possível remover a posição inicial e final com o ícone da lixeira à direita do botão.
Também é possível inverter a posição inicial e final com o ícone com setas duplas entre o botão iniciar e parar.
Você pode adicionar um ou vários pontos de referência pelos quais a rota deve passar.
Para adicionar um waypoint, selecione o botão "Adicionar waypoint" e clique no mapa. O waypoint deve aparecer no mapa com um marcador ciano.
Você pode mover um waypoint diretamente no mapa arrastando-o.
Para remover um waypoint, basta clicar nele.
No mapa, você pode selecionar os blocos para visitar, bastando clicar neles. O mesmo para desmarcar um bloco.
Tenha cuidado : não adicione muitas peças. O tempo de cálculo aumenta exponencialmente!
Pontas :
Você pode remover todos os blocos marcados com o botão "Limpar blocos". Também removerá todos os waypoints.
Quando o percurso estiver concluído (status "concluído"), é possível baixá-lo diretamente: Clique no botão azul do ícone de download e insira um nome de arquivo no campo de entrada.
O nome é opcional. Se não houver, datetime será usado para o nome do arquivo e o nome gpx.
Também é possível armazenar diversas rotas na seção "Rotas". Dê um nome e clique no botão "+". Depois você pode destacar rotas anteriores, renomeá-las, removê-las ou baixá-las.
Você também pode realizar alguma operação na rota com o menu de ações:
Ações na rota selecionada:
Dicas : Você pode mesclar e substituir pela rota encontrada clicando no status verde em vez da próxima rota.
É possível ativar filtro para rotas exibidas.
Filter é uma expressão regex que verificará o nome da rota.
Alguns exemplos:
^Vélo
: Percurso iniciado por "Vélo"[0-9]$
: Rota finalizada por um número É possível exibir peças faltantes no mapa para facilitar a seleção de peças para uma rota.
Você pode importar dados de statshunters:
StatsHunters.com oferece a possibilidade de criar um link para compartilhar sua página pessoal com outras pessoas. Você deve criar um link de compartilhamento na página https://statshunters.com/share e copiar e colar o link completo (algo como https://www.statshunters.com/share/abcdef123456) na página e importar.
Como leva algum tempo para carregar as atividades do servidor statshunters, elas são salvas no cache para acelerar o carregamento da página e filtrar o cálculo. Para carregar novas atividades, você deve clicar no botão "Recarregar".
É possível adicionar filtros em statshunters. Deve ser formatado como expressão python e os dados úteis das atividades são:
Alguns exemplos:
type=="Ride" and date>="2021"
type=="Run" and '#fromHome' in name and date>"2021"