osmc:Viz/Navegação

Documentação integrante do projeto AFA.codes

Sobre Metodologia Convenções Gits Requisitos e Testes Visualização

Países: BR, CO, EC, UY.

Afa vs Plus, DNGS, ...

Guia da Navegação. Instruções para a visualização e navegação por mapas e geocódigos; atualmente disponível apenas a interface rascunho do GridMap.

Elementos da interface

Elementos principais da interface:

1. Barra de endereço;
2. Pop-up dos dados da célula selecionada;
3. Seletores;
4. Célula equivalente.

Cobertura e geocódigos

cobertura local de Tunja, na Colombia

Ver osmc:Convenções/Coberturas municipais

Cabeçalho

Sobre os elementos no topo da interface, esquerda para direita:

• À direita de AFAcode temos o geocódigo da célula selecionada. Se nenhuma estiver serlecionada, será exibido no lugar (click the map).
• Setas ◀ e ▶: aumenta e diminui o nível de seleção de células. Requer ao menos uma seleção para funcionar.
• Clicar no nome do município irá dar zoom no mapa para exibir o município inteiro.

Ferramentas

Sobre ferramentas que estão na parte inferior da interface. Abaixo apresentados de cima para baixo.

Level

Menu-drop down que lista os níveis e a dimensão da célula de seleção. Tem função informativa e para selecionar o tamanho da célula na seleção.

Clear all, Tooltips e Coverage

O botão Clear all limpa todas as células selecionadas.

O botão Tooltip habilita/desabilita a visualização de uma tooltip (etiqueta) com o geocódigo das células selecionadas e da grade. Known bug: devido a um problema do Leaflet (uma biblioteca desenvolvida por um ente não relacionado ao instituto), as tooltips são posicionadas de forma errada.

O botão Coverage habilita/desabilita a grade geral e overlay.

O checkbox No tooltip habilita/desabilita...

O checkbox Disable zoom-click habilita/desabilita o ajuste do nível de zoom para o nível da célula selecioanda.

O checkbox Keep previous clicks habilita/desabilita a visualização das seleções feitas. Desabilitando só irá mostra a última seleção por vez.

Encode e Decode

Converte o código da grade (Grid code) em código geo URI (Equivalent Geo URI) com coordenadas, e vice-versa.

O botão Decode converte código da grade em código geo URI.

• Por exemplo, em BR-AM-Anori, 3HVSXXR é convertido em geo:-3.745035,-61.657890;u=3.

O botão Encode converte código geo URI em código da grade.

• Por exemplo, geo:-3.745035,-61.657890;u=3 é convertido em 3HVSXXR em BR-AM-Anori.

O botão My Location usa a localização estimada do dispositivo. Funciona somente se o município do dispositivo estiver ativo/selecionado; ou retorna o erro "Error: location out of {código da jurisdição}.".

Notas

• "Cover": Seria interessante alguma explicação sobre como a divisão em setores é feita em municípios grandes (e.g. https://test.osm.codes/BR-SP-SaoPaulo), que, p. ex. que nas áreas densas há setores menores, e nas bordas do mapa, setores maiores, e que pode haver uma sobreposição de setores menores sobre maiores (fallback).

Atribuição

Regras gerais:

1. Sempre remover o default, não permitimos propaganda.
2. Juridicamente os créditos já foram dados a todos colaboradores, ao expormos publicamente em git todos nossos códigos-fonte, não faz sentido dar atribuição adicional a uma biblioteca ou dataset específicos sem dar a todos. Por regra não fazemos atribuição adicional.
3. Se por acaso alguma atribuição adicional fizer sentido, criar uma versão reduzida de info para uma página isolada discriminando os créditos.