a4a:Convenções/Visualização de dados

De Documentação

Análogo ao subdomínio DL de downloads, viz.addressforall.org/{obj} permite a visualização do objeto obj.

PS: subdominio viz porque é a abreviação de Data VisualiZation, segundo a Wikipedia.

Sintaxe do obj

Conforme a planilha, temos {jurisdiction}/{package}.{version}/{layer} , a mesma hierarquia que utilizada pelo CutGeo (ex. )

Exemplos:

  • BR-SP-Guarulhos/_pk0081.01/geoaddress
  • BR-SP-Jacarei/_pk0145.01/parcel

Basta que o usuário digite um prefixo largo o suficiente para não ser ambíguo, que o redirecionador pode operar com a linha DE-PARA correta. Por exemplo BR-SP-Guarulhos, havendo um só layer e um só pacote, não precisa especificar.

Diferenças com serviçoDL:

  • se por acaso digitar BR/pk0081 transforma em LIKE 'BR%pk0081% e novamente seria único.
  • se por acaso digitar BR-SP-Guarulhos/via transforma em LIKE 'BR-SP-Guarulhos%via% e novamente seria único.


Url

Por exemplo, a camada de quadras doada pela prefeitura de Natal pode ser visualizada por meio dos links:


Quando houver possibilidade de ambiguidade, por exemplo, o pacote de dados possuir mais de uma camada, é necessário especificar a camada:

Redirecionamento

Tabela viz-de-para

A tabela viz-de-para issue144-entregaESRI é uma alternativa para não lidar com fromCutLayer_toVizLayer.csv diretamente no git.

No entanto:

fromCutLayer_toVizLayer.csv

Foi convencionado que o link do provedor de serviços esteja oficialmente em https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv.

Tal arquivo possui os seguintes campos:

campo descrição exemplo
jurisdiction_pack_layer Campo formado por <isolabel_ext>/<identificador completo do pacote>/<nome da camada>. BR-RN-Natal/_pk0073.01/block
user_resp Usuário responsável subir os dados no provedor
status
hash_from sha256 do arquivo que contém a camada de dados. 63f265730d08e440bbfaf630a78c053968ee7ec12447b19af9554f5a8a78614f.zip
url_layer_visualization Url do arquivo no serviço de visualização. https://addressforall.maps.arcgis.com/apps/mapviewer/index.html?layers=84999bdcf69049bf912afbd03425b299

Importante: não adicione linhas em branco ao final do arquivo.

O que fazer após atualizar fromCutLayer_toVizLayer.csv

Importante: o target redirects_update consome o conteúdo de fromCutLayer_toVizLayer.csv. Ele não consome o conteúdo da tabela viz-de-para.

Atualizar fromCutLayer_toVizLayer.csv não atualiza automaticamente o datalake em produção. Para atualizá-lo, executar os comandos: 

cd /var/gits/_dg/preserv
git pull
cd /var/gits/_dg/preserv/src
make redirects_update pg_datalake=dl05s_main
Disponível em “https://wiki.addressforall.org/w/index.php?title=a4a:Convenções/Visualização_de_dados&oldid=3012”