a4a:Convenções/Visualização de dados: mudanças entre as edições

Edição atual tal como às 14h09min de 19 de outubro de 2023

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:

O conteúdo da tabela viz-de-para deve ser copiado para fromCutLayer_toVizLayer.csv. Solicite ajuda técnica se necessário;
O conteúdo que está em viz-de-para não é oficial, vale o conteúdo de fromCutLayer_toVizLayer.csv;
viz-de-para e fromCutLayer_toVizLayer.csv possuem os mesmos campos.

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

@@ Linha 1: / Linha 1: @@
-Para visualizar camadas de dados ingestados em interface de terceiros foram definidas regras para gerar url única.
+Análogo ao subdomínio DL de downloads, <code>viz.addressforall.org/{obj}</code> permite a visualização do objeto <code>obj</code>.
+PS: subdominio <code>viz</code> porque é a abreviação de Data VisualiZation, segundo a Wikipedia.
+== Sintaxe do obj ==
+Conforme a planilha, temos <code>{jurisdiction}/{package}.{version}/{layer}</code> , 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 <code>BR-SP-Guarulhos</code>, havendo um só layer e um só pacote, não precisa especificar.
+Diferenças com serviçoDL:
+* se por acaso digitar <code>BR/pk0081</code> transforma em <code>LIKE 'BR%pk0081%</code> e novamente seria único.
+* se por acaso digitar <code>BR-SP-Guarulhos/via</code> transforma em <code>LIKE 'BR-SP-Guarulhos%via%</code> e novamente seria único.
 == Url ==