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

Para visualizar camadas de dados ingestados em interface de terceiros foram definidas regras para gerar url única.

Url

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

• https://viz.addressforall.org/BR-RN-Natal/_pk0073.01/block
• https://viz.addressforall.org/BR-RN-Natal/block
• https://viz.addressforall.org/63f265
• https://viz.addressforall.org/63f265/block
• https://viz.addressforall.org/63f265730d08e440bbfaf630a78c053968ee7ec12447b19af9554f5a8a78614f.zip
• https://viz.addressforall.org/63f265730d08e440bbfaf630a78c053968ee7ec12447b19af9554f5a8a78614f.zip/block
• https://viz.addressforall.org/BR/_pk0073 (ambíguo, retorna 404)
• https://viz.addressforall.org/BR/pk0073 (ambíguo, retorna 404)
• https://viz.addressforall.org/BR/73 (ambíguo, retorna 404)
• https://viz.addressforall.org/BR/_pk0073/block
• https://viz.addressforall.org/BR/pk0073/block
• https://viz.addressforall.org/BR/73/block

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

• https://viz.addressforall.org/BR/73/block
• https://viz.addressforall.org/BR/73/building
• https://viz.addressforall.org/BR/73/parcel

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
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