a4a:Convenções/Visualização de dados: mudanças entre as edições
m (Troca categoria para o projeto A4A) |
Sem resumo de edição |
||
(6 revisões intermediárias por um outro usuário não estão sendo mostradas) | |||
Linha 1: | Linha 1: | ||
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 == | == Url == | ||
Linha 19: | Linha 37: | ||
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 | * https://viz.addressforall.org/BR/73/parcel | ||
== Redirecionamento == | == Redirecionamento == | ||
=== Tabela viz-de-para === | === Tabela viz-de-para === | ||
A tabela '''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: | ||
Linha 45: | Linha 63: | ||
|- | |- | ||
| jurisdiction_pack_layer || Campo formado por <isolabel_ext>/<identificador completo do pacote>/<nome da camada>. || BR-RN-Natal/_pk0073.01/block | | 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 | | hash_from || sha256 do arquivo que contém a camada de dados. || 63f265730d08e440bbfaf630a78c053968ee7ec12447b19af9554f5a8a78614f.zip | ||
Linha 51: | Linha 73: | ||
|} | |} | ||
Importante: '''não adicione linhas em branco''' ao final do arquivo. | |||
== O que fazer após atualizar fromCutLayer_toVizLayer.csv == | == O que fazer após atualizar fromCutLayer_toVizLayer.csv == | ||
Linha 64: | Linha 87: | ||
make redirects_update pg_datalake=dl05s_main | make redirects_update pg_datalake=dl05s_main | ||
</pre> | </pre> | ||
== Lista de Downloads == | |||
Ver questões tecnicas e de completeza em [[a4a:Convenções/Visualização de dados/DL_info]] | |||
[[Categoria:AddresForAll]] | [[Categoria:AddresForAll]] |
Edição atual tal como às 19h40min de 30 de julho de 2024
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 emLIKE 'BR%pk0081%
e novamente seria único. - se por acaso digitar
BR-SP-Guarulhos/via
transforma emLIKE '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:
- 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:
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
Lista de Downloads
Ver questões tecnicas e de completeza em a4a:Convenções/Visualização de dados/DL_info