dg:AsIs feature types: mudanças entre as edições

De Documentação
mSem resumo de edição
Linha 17: Linha 17:
* o sufixo <code>_none</code> indica que nenhum controle externo pode ser realizado e nem todos os atributos obrigatórios estão presentes.
* o sufixo <code>_none</code> indica que nenhum controle externo pode ser realizado e nem todos os atributos obrigatórios estão presentes.


<table class="wikitable" role="table">
{| class="wikitable"
<thead>
!ftid!!ftname!!geomtype!!Join!!descr
<tr>
|-
<th>ftid</th> <th>ftname</th> <th>geomtype</th> <th>Join</th> <th>descr</th>
|21||geoaddress_full||point||não|| Geo-endereço. Representação geográfica do endereço, como ponto.
</tr>
|-
</thead>
|22||geoaddress_ext
<tbody>
|point||SIM
<tr>
|-
<td>21</td>
|23||geoaddress_none||point||não
<td>geoaddress_full</td>
|-
<td>point</td>
|31||via_full||line||não||Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
<td>não</td>
|-
<td rowspan="3">Geo-endereço. Representação geográfica do endereço, como ponto.</td>
|32||via_ext||line||SIM
</tr>
|-
<tr>
|33||via_none||line||não
<td>22</td>
|-
<td>geoaddress_ext</td>
|41||genericvia_full||line||não||Via complementar generalizada. Qualquer linha divisora de lotes e quadras: rios, ferrovias, etc. Permite gerar a quadra generalizada.
<td>point</td>
|-
<td>SIM</td>
|42||genericvia_ext||line||SIM
</tr>
|
<tr>
|-
<td>23</td>
|43||genericvia_none||line
<td>geoaddress_none</td>
|não
<td>point</td>
|-
<td>não</td>
|51||building_full||poly||não||Polígono de edificação.
</tr>
|-
|52||building_ext||poly||SIM
|-
|53||building_none||poly||não
|-
|61||parcel_full ||poly||não||Polígono de lote.
|-
|62||parcel_ext||poly||SIM
|-
| 63||parcel_none||poly||não
|-
|71||nsvia_full||poly||não||Espaço-de-nomes para vias, um nome delimitado por polígono. Tipicamente nome de bairro ou de loteamento. Complementa o nome de via em nomes duplicados (repetidos dentro do mesmo município mas não dentro do mesmo nsvia).
|-
|72
|nsvia_ext||poly||SIM
|-
|73||nsvia_none||poly||não
|-
|81||block_full||poly||não||Quadras ou divisões poligonais similares.
|-
|82||block_none||poly||não
|}


<tr>
<img align="right" src="../assets/asIs_tabs_geom2ext.png"/>
<td>31</td>
<td>via_full</td>
<td>line</td>
<td>não</td>
<td rowspan="3">Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.</td>
</tr>
<tr>
<td>32</td>
<td>via_ext</td>
<td>line</td>
<td>SIM</td>
</tr>
<tr>
<td>33</td>
<td>via_none</td>
<td>line</td>
<td>não</td>
</tr>
 
<tr>
<td>41</td>
<td>genericvia_full</td>
<td>line</td>
<td>não</td>
<td rowspan="3">Via complementar generalizada. Qualquer linha divisora de lotes e quadras: rios, ferrovias, etc. Permite gerar a quadra generalizada.</td>
</tr>
<tr>
<td>42</td>
<td>genericvia_ext</td>
<td>line</td>
<td>SIM</td>
</tr>
<tr>
<td>43</td>
<td>genericvia_none</td>
<td>line</td>
<td>não</td>
</tr>
 
<tr>
<td>51</td>
<td>building_full</td>
<td>poly</td>
<td>não</td>
<td rowspan="3">Polígono de edificação.</td>
</tr>
<tr>
<td>52</td>
<td>building_ext</td>
<td>poly</td>
<td>SIM</td>
</tr>
<tr>
<td>53</td>
<td>building_none</td>
<td>poly</td>
<td>não</td>
</tr>
<tr>
 
<tr>
<td>61</td>
<td>parcel_full</td>
<td>poly</td>
<td>não</td>
<td rowspan="3">Polígono de lote.</td>
</tr>
<tr>
<td>62</td>
<td>parcel_ext</td>
<td>poly</td>
<td>SIM</td>
</tr>
<tr>
<td>63</td>
<td>parcel_none</td>
<td>poly</td>
<td>não</td>
</tr>
 
<tr>
<td>71</td>
<td>nsvia_full</td>
<td>poly</td>
<td>não</td>
<td rowspan="3">Espaço-de-nomes para vias, um nome delimitado por polígono. Tipicamente nome de bairro ou de loteamento. Complementa o nome de via em nomes duplicados (repetidos dentro do mesmo município mas não dentro do mesmo nsvia).</td>
</tr>
<tr>
<td>72</td>
<td>nsvia_ext</td>
<td>poly</td>
<td>SIM</td>
</tr>
<tr>
<td>73</td>
<td>nsvia_none</td>
<td>poly</td>
<td>não</td>
</tr>


<tr>
<td>81</td>
<td>block_full</td>
<td>poly</td>
<td>não</td>
<td rowspan="2">Quadras ou divisões poligonais similares.</td>
</tr>
<tr>
<td>82</td>
<td>block_none</td>
<td>poly</td>
<td>não</td>
</tr>
</tbody>
</table>


<img align="right" src="../assets/asIs_tabs_geom2ext.png"/>
===Cadastral===
 
=== Cadastral ===


Quando a tabela AsIs do ''layer'' não apresenta todos os atributos obrigatórios, deve-se recorrer a um cadastro externo com o qual fará JOIN depois de ingerida. Assim, para todo ''layer'' com sufixo <code>_ext</code> é ingerido também o cadastro correspondente.
Quando a tabela AsIs do ''layer'' não apresenta todos os atributos obrigatórios, deve-se recorrer a um cadastro externo com o qual fará JOIN depois de ingerida. Assim, para todo ''layer'' com sufixo <code>_ext</code> é ingerido também o cadastro correspondente.


Relacionamentos obrigatórios:<br/> <!--![](../assets/asIs_relations.png)-->
Relacionamentos obrigatórios:<br /> <!--![](../assets/asIs_relations.png)-->


<pre class="mermaid">graph LR
<pre class="mermaid">graph LR
Linha 174: Linha 79:
E[address_cmpl] --- F[geoaddress_ext]
E[address_cmpl] --- F[geoaddress_ext]
G[cadparcel_cmpl] --- H[parcel_ext]</pre>
G[cadparcel_cmpl] --- H[parcel_ext]</pre>
<table class="wikitable" role="table">
 
<thead>
<thead>
<tr>
 
<th>ftid</th> <th>ftname</th>  <th>Join</th> <th>descr</th>
</tr>
</thead>
</thead>


<tbody>
<tbody>
<tr>
 
</thead>
<table class="wikitable" role="table"><tr>
<th>ftid</th> <th>ftname</th>  <th>Join</th> <th>descr</th>
</tr><tr>
<td>1</td>
<td>1</td>
<td>address_cmpl</td>
<td>address_cmpl</td>
Linha 203: Linha 110:
<td>7</td>
<td>7</td>
<td>cadparcel_noid</td>
<td>cadparcel_noid</td>
<td>não</td>
<td>não </td>
</tr>
</tr>


Linha 224: Linha 131:
<td>cadgenericvia_noid</td>
<td>cadgenericvia_noid</td>
<td>não</td>
<td>não</td>
</tr>
</tr></table>
</thead>
</table>




-----
-----


== housenumber_system_type ==
== housenumber_system_type==


Da mais alta relevância para a correta interpretação da numeração predial e dos nomes de via dentro do sistema de descrição de endereços de um país ou divisão jurisdicional do país. Na AddressForAll foi definida a seguinte '''tabela House System Type''' (HST ou <code>housenumber_system_type</code>) de definições:
Da mais alta relevância para a correta interpretação da numeração predial e dos nomes de via dentro do sistema de descrição de endereços de um país ou divisão jurisdicional do país. Na AddressForAll foi definida a seguinte '''tabela House System Type''' (HST ou <code>housenumber_system_type</code>) de definições:


{| class="wikitable"
{| class="wikitable"
! coluna
!coluna
! tipo
!tipo
! significado
!significado
|-
|-
| <code>hstid</code>
|<code>hstid</code>
| <code>smallint</code> PRIMARY KEY NOT NULL
| <code>smallint</code> PRIMARY KEY NOT NULL
| identificador (id) do HST
| identificador (id) do HST
|-
|-
| <code>hstname</code>
|<code>hstname</code>
| <code>text</code> NOT NULL CHECK(lower(hstname)=hstname)
|<code>text</code> NOT NULL CHECK(lower(hstname)=hstname)
| Rótulo curto e mnemônico do HST
|Rótulo curto e mnemônico do HST
|-
|-
| <code>regex_sort</code>
|<code>regex_sort</code>
| <code>text</code> NOT NULL
|<code>text</code> NOT NULL
| regular expression da ordenação da numeração predial
|regular expression da ordenação da numeração predial
|-
|-
| <code>description</code>
| <code>description</code>
| <code>text</code> NOT NULL
|<code>text</code> NOT NULL
| descrição
|descrição
|}
|}


Linha 260: Linha 165:


{| class="wikitable"
{| class="wikitable"
! hstid
!hstid
! hstname
!hstname
! regex_sort
!regex_sort
! description
!description
|-
|-
| 0
|0
| metric
| metric
| <code>[0-9]+</code>
|<code>[0-9]+</code>
| integer
|integer
|-
|-
| 1
|1
| street-metric
|street-metric
| <code>[0-9]+[A-Z]? \- [0-9]+ [SNEL]?</code>
|<code>[0-9]+[A-Z]? \- [0-9]+ [SNEL]?</code>
| string
|string
|-
|-
| 2
|2
| block-metric
|block-metric
| <code>[0-9]+ \- [0-9]+</code>
|<code>[0-9]+ \- [0-9]+</code>
| integer function
|integer function
|-
|-
| 3
|3
| ago-block
|ago-block
|
|
|
|
|-
|-
| 4
| 4
| df-block
|df-block
|
|
|
|
|}
|}


== Ligações externas ==
==Ligações externas==


* Texto original: https://github.com/digital-guard/preserv/blob/main/docs/pt/ftypes.md
*Texto original: https://github.com/digital-guard/preserv/blob/main/docs/pt/ftypes.md


[[Categoria:Digital-guard]]
[[Categoria:Digital-guard]]

Edição das 00h23min de 1 de maio de 2023

A tabela ingest.feature_asis armazena todos os dados ingeridos, de "todos" os tipos (úteis para os projetos AddressForAll e OSMcodes). A tabela ingest.feature_type descreve cada um desses tipos. Resumidamente são:

  • Dg-LayerIcon-geoaddress.png geoaddress: Geo-endereço. Representação geográfica do endereço, como ponto.
  • Dg-LayerIcon-via.png via: Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
  • Dg-LayerIcon-genericVia.png genericvia: Ferrovia, hidrovia ou qualquer outra "via complementar generalizada" que ajude a delimitar polígonos de quadra.
  • Dg-LayerIcon-building.png building: Polígono de edificação.
  • Dg-LayerIcon-parcel.png parcel: Polígono de lote.
  • Dg-LayerIcon-namedZone.png nsvia: Namespace para distinguir vias duplicadas, tipicamente nome de polígono de bairro ou de loteamento.
  • Dg-LayerIcon-namedZone.png block: Quadras ou divisões poligonais similares.
Dg-AsIs tabs geom2full.png

Com geometria

Idealmente os dados fornecidos possuem geometria e todos os atributos obrigatórios, ou seja, são "full". Quando não:

  • o sufixo _ext indica layer complementado por tabela externa (portanto sim necessita JOIN com respectivo cadastro);
  • o sufixo _none indica que nenhum controle externo pode ser realizado e nem todos os atributos obrigatórios estão presentes.
ftid ftname geomtype Join descr
21 geoaddress_full point não Geo-endereço. Representação geográfica do endereço, como ponto.
22 geoaddress_ext point SIM
23 geoaddress_none point não
31 via_full line não Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
32 via_ext line SIM
33 via_none line não
41 genericvia_full line não Via complementar generalizada. Qualquer linha divisora de lotes e quadras: rios, ferrovias, etc. Permite gerar a quadra generalizada.
42 genericvia_ext line SIM
43 genericvia_none line não
51 building_full poly não Polígono de edificação.
52 building_ext poly SIM
53 building_none poly não
61 parcel_full poly não Polígono de lote.
62 parcel_ext poly SIM
63 parcel_none poly não
71 nsvia_full poly não Espaço-de-nomes para vias, um nome delimitado por polígono. Tipicamente nome de bairro ou de loteamento. Complementa o nome de via em nomes duplicados (repetidos dentro do mesmo município mas não dentro do mesmo nsvia).
72 nsvia_ext poly SIM
73 nsvia_none poly não
81 block_full poly não Quadras ou divisões poligonais similares.
82 block_none poly não

<img align="right" src="../assets/asIs_tabs_geom2ext.png"/>


Cadastral

Quando a tabela AsIs do layer não apresenta todos os atributos obrigatórios, deve-se recorrer a um cadastro externo com o qual fará JOIN depois de ingerida. Assim, para todo layer com sufixo _ext é ingerido também o cadastro correspondente.

Relacionamentos obrigatórios:

graph LR
A[cadgenericvia_cmpl] --- B[genericvia_ext]
C[cadvia_cmpl] --- D[via_ext]
E[address_cmpl] --- F[geoaddress_ext]
G[cadparcel_cmpl] --- H[parcel_ext]

<thead>

</thead>

<tbody>

</thead>

ftid ftname Join descr
1 address_cmpl SIM Endereço cadastral, representação por nome de via e numeração predial.
2 address_noid não
6 cadparcel_cmpl SIM Lote cadastral (nome de parcel), complemento da geográfica. Lote representado por dados cadastrais apenas.
7 cadparcel_noid não
11cadvia_cmplSIM Via cadastral (nome de via), complemento da geográfica. Logradouro representado por dados cadastrais apenas.
12cadvia_noidnão
16 cadgenericvia_cmpl SIM Generic-via cadastral (nome de Generic-via), complemento da geográfica. Generic-via representado por dados cadastrais apenas.
17 cadgenericvia_noid não



housenumber_system_type

Da mais alta relevância para a correta interpretação da numeração predial e dos nomes de via dentro do sistema de descrição de endereços de um país ou divisão jurisdicional do país. Na AddressForAll foi definida a seguinte tabela House System Type (HST ou housenumber_system_type) de definições:

coluna tipo significado
hstid smallint PRIMARY KEY NOT NULL identificador (id) do HST
hstname text NOT NULL CHECK(lower(hstname)=hstname) Rótulo curto e mnemônico do HST
regex_sort text NOT NULL regular expression da ordenação da numeração predial
description text NOT NULL descrição

Atualmente, em 2023, temos apenas os seguintes descritores:

hstid hstname regex_sort description
0 metric [0-9]+ integer
1 street-metric [0-9]+[A-Z]? \- [0-9]+ [SNEL]? string
2 block-metric [0-9]+ \- [0-9]+ integer function
3 ago-block
4 df-block

Ligações externas