a4a:Convenções/Visualização de dados: mudanças entre as edições
(→fromCutLayer_toVizLayer.csv: Adiciona aviso.) |
(→Tabela viz-de-para: Atualiza localização e nome da tabela.) |
||
Linha 28: | Linha 28: | ||
=== Tabela viz-de-para === | === Tabela viz-de-para === | ||
A tabela '''[https://docs.google.com/spreadsheets/d/1CL6f0I9DSpqKxKC7QNJGCfyabq7mDOVab5QBGV5VLOk/edit#gid=592701333 viz-de-para]''' é uma alternativa para não lidar com [https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv fromCutLayer_toVizLayer.csv] diretamente no git. | A tabela <strike>'''[https://docs.google.com/spreadsheets/d/1CL6f0I9DSpqKxKC7QNJGCfyabq7mDOVab5QBGV5VLOk/edit#gid=592701333 viz-de-para]'''</strike> '''[https://docs.google.com/spreadsheets/d/1_4iF6n2JQNl-CK0Kp6zv3LesDVLsMSOYyxNXLlAW-3A/edit#gid=0 issue144-entregaESRI] é uma alternativa para não lidar com [https://git.digital-guard.org/preserv/blob/main/data/redirs/fromCutLayer_toVizLayer.csv fromCutLayer_toVizLayer.csv] diretamente no git. | ||
No entanto: | No entanto: |
Edição das 14h31min de 26 de julho de 2023
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