dg:AsIs feature types

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

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:

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

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

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]

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
11	cadvia_cmpl	SIM	Via cadastral (nome de via), complemento da geográfica. Logradouro representado por dados cadastrais apenas.
12	cadvia_noid	nã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