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

mSem resumo de edição
(formatação e ajustes conteudo)
Linha 3: Linha 3:
A tabela <code>ingest.feature_asis</code> armazena todos os dados ingeridos, de"todos" os tipos (úteis para os projetos [[Documentação AddresForAll|AddressForAll]] e [[Documentação OSMcodes|OSMcodes]]). A tabela <code>ingest.feature_type</code> descreve cada um desses tipos. Resumidamente são:
A tabela <code>ingest.feature_asis</code> armazena todos os dados ingeridos, de"todos" os tipos (úteis para os projetos [[Documentação AddresForAll|AddressForAll]] e [[Documentação OSMcodes|OSMcodes]]). A tabela <code>ingest.feature_type</code> descreve cada um desses tipos. Resumidamente são:


* [[Arquivo:Dg-LayerIcon-geoaddress.png|41x41px]] '''geoaddress''': Geo-endereço. Representação geográfica do endereço, como ponto.
* [[Arquivo:Dg-LayerIcon-geoaddress.png|semmoldura|41x41px]] '''geoaddress''': Geo-endereço. Representação geográfica do endereço, como ponto.
 
* [[Arquivo:Dg-LayerIcon-geopoint.png|semmoldura|41x41px]] '''geopoint''': Geo-ponto. Representação geográfica de um ponto qualquer de interesse (PoI), diferente do Geo-endereço.
 
* [[Arquivo:Dg-LayerIcon-via.png|40x40px]] '''via''': Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
* [[Arquivo:Dg-LayerIcon-via.png|40x40px]] '''via''': Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
* [[Arquivo:Dg-LayerIcon-genericVia.png|40x40px]] '''genericvia''': Ferrovia, hidrovia ou qualquer outra "via complementar generalizada" que ajude a delimitar polígonos de quadra.<!-- >&nbsp; &nbsp; Qualquer linha divisora entre quadras, incluindo córregos e outras barreiras, em meio urbano ou rural. -->
* [[Arquivo:Dg-LayerIcon-genericVia.png|40x40px]] '''genericvia''': Ferrovia, hidrovia ou qualquer outra "via complementar generalizada" que ajude a delimitar polígonos de quadra.<!-- >&nbsp; &nbsp; Qualquer linha divisora entre quadras, incluindo córregos e outras barreiras, em meio urbano ou rural. -->
* [[Arquivo:Dg-LayerIcon-building.png|semmoldura|40x40px]] '''building''': Polígono de edificação.
* [[Arquivo:Dg-LayerIcon-building.png|semmoldura|40x40px]] '''building''': Polígono de edificação.
* [[Arquivo:Dg-LayerIcon-parcel.png|semmoldura|40x40px]] '''parcel''': Polígono de lote.
* [[Arquivo:Dg-LayerIcon-parcel.png|semmoldura|40x40px]] '''parcel''': Polígono de lote.
* [[Arquivo:Dg-LayerIcon-namedZone.png|semmoldura|40x40px]] '''nsvia''': ''Namespace'' para distinguir vias duplicadas, tipicamente nome de polígono de bairro ou de loteamento.
* [[Arquivo:Dg-LayerIcon-namedZone.png|semmoldura|40x40px]] '''nsvia''': ''Namespace'' para distinguir vias duplicadas, tipicamente nome de polígono de bairro ou de loteamento.
* [[Arquivo:Dg-LayerIcon-namedZone.png|semmoldura|40x40px]] '''block''': Quadras ou divisões poligonais similares.
* [[Arquivo:Dg-LayerIcon-namedZone.png|semmoldura|40x40px]] '''block''': Quadras ou divisões poligonais similares.
[[Arquivo:Dg-AsIs tabs geom2full.png|centro|semmoldura|600x600px]]
[[Arquivo:Dg-AsIs tabs geom2full.png|centro|semmoldura|600x600px]]


Linha 20: Linha 29:


{| class="wikitable"
{| class="wikitable"
!ftid!!ftname!!geomtype!!Join!!descr
!ftID!!ftName!!geomType!!join!!Descrição resumida
|-
|-
|21||geoaddress_full||point||não|| rowspan="3" | Geo-endereço. Representação geográfica do endereço, como ponto.
|21||geoaddress_full||point||não || rowspan="3" | Geo-endereço. Representação geográfica do endereço, como ponto.
|-
|-
|22||geoaddress_ext
|22||geoaddress_ext
Linha 30: Linha 39:


|-
|-
|26||geopoint_full||point||não|| rowspan="3" | Representação geográfica de elementos genéricos, como ponto. Ver: [https://github.com/digital-guard/preserv/issues/91 digital-guard/preserv#91]
|26||geopoint_full||point||não || rowspan="3" |Representação geográfica de elementos genéricos, como ponto. Ver: [https://github.com/digital-guard/preserv/issues/91 digital-guard/preserv#91]
|-
|-
|27||geopoint_ext
|27||geopoint_ext
Linha 38: Linha 47:


|-
|-
|31||via_full||line||não|| rowspan="3" |Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
|31||via_full ||line||não || rowspan="3" |Eixo de via. Logradouro representado por linha central, com nome oficial e codlog opcional.
|-
|-
|32||via_ext||line||SIM
|32||via_ext||line||SIM
Linha 44: Linha 53:
|33||via_none||line||não
|33||via_none||line||não
|-
|-
|41||genericvia_full||line||não|| rowspan="3" |Via complementar generalizada. Qualquer linha divisora de lotes e quadras: rios, ferrovias, etc. Permite gerar a quadra generalizada.
|41||genericvia_full ||line||não || rowspan="3" |Via complementar generalizada. Qualquer linha divisora de lotes e quadras: rios, ferrovias, etc. Permite gerar a quadra generalizada.
|-
|-
|42||genericvia_ext||line||SIM
|42||genericvia_ext||line||SIM
Linha 51: Linha 60:
|não
|não
|-
|-
|51||building_full||poly||não|| rowspan="3" |Polígono de edificação.
|51||building_full ||poly||não || rowspan="3" |Polígono de edificação.
|-
|-
|52||building_ext||poly||SIM
|52||building_ext||poly||SIM
Linha 57: Linha 66:
|53||building_none||poly||não
|53||building_none||poly||não
|-
|-
|61||parcel_full ||poly||não|| rowspan="3" |Polígono de lote.
| 61||parcel_full ||poly||não || rowspan="3" |Polígono de lote.
|-
|-
|62||parcel_ext||poly||SIM
|62||parcel_ext||poly||SIM
|-
|-
| 63||parcel_none||poly||não
|63||parcel_none||poly||não
|-
|-
|71||nsvia_full||poly||não|| 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).
|71||nsvia_full ||poly||não || 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).
|-
|-
|72
|72
Linha 70: Linha 79:
|73||nsvia_none||poly||não
|73||nsvia_none||poly||não
|-
|-
|81||block_full||poly||não|| rowspan="2" |Quadras ou divisões poligonais similares.
|81||block_full ||poly||não || rowspan="2" |Quadras ou divisões poligonais similares.
|-
|-
|82||block_none||poly||não
|82||block_none||poly||não


|-
|-
|91||datagrid_full ||point||não|| rowspan="3" | Para grades de pontos. ftid=92 será implementado conforme necessidade. Ver [https://github.com/digital-guard/preserv/issues/115 digital-guard/preserv#115]
|91||datagrid_full||point||não || rowspan="3" | Para grades de pontos. ftid=92 será implementado conforme necessidade. Ver [https://github.com/digital-guard/preserv/issues/115 digital-guard/preserv#115]
|-
|-
|92||datagrid_ext||point||SIM
|92||datagrid_ext||point||SIM
Linha 92: Linha 101:


{| class="wikitable"
{| class="wikitable"
! ftid !! ftname !! Join !! descr
! ftid!! ftname!!Join!!descr
|-
|-
| 1 || address_cmpl || SIM || rowspan="2" | Endereço cadastral, representação por nome de via e numeração predial.
|1||address_cmpl||SIM || rowspan="2" |Endereço cadastral, representação por nome de via e numeração predial.
|-
|-
| 2 || address_noid || não
|2||address_noid || não
|-
|-
| 6 || cadparcel_cmpl || SIM || rowspan="2" | Lote cadastral (nome de parcel), complemento da geográfica. Lote representado por dados cadastrais apenas.
|6|| cadparcel_cmpl||SIM || rowspan="2" | Lote cadastral (nome de parcel), complemento da geográfica. Lote representado por dados cadastrais apenas.
|-
|-
| 7 || cadparcel_noid || não  
|7|| cadparcel_noid||não
|-
|-
| 11 || cadvia_cmpl || SIM || rowspan="2" | Via cadastral (nome de via), complemento da geográfica. Logradouro representado por dados cadastrais apenas.
|11 || cadvia_cmpl||SIM || rowspan="2" |Via cadastral (nome de via), complemento da geográfica. Logradouro representado por dados cadastrais apenas.
|-
|-
| 12 || cadvia_noid || não
|12 || cadvia_noid||não
|-
|-
| 16 || cadgenericvia_cmpl || SIM || rowspan="2" | Generic-via cadastral (nome de Generic-via), complemento da geográfica. Generic-via representado por dados cadastrais apenas.
|16||cadgenericvia_cmpl||SIM || rowspan="2" |Generic-via cadastral (nome de Generic-via), complemento da geográfica. Generic-via representado por dados cadastrais apenas.
|-
|-
| 17 || cadgenericvia_noid || não
|17||cadgenericvia_noid||não
|}
|}
==Descrição detalhada das classes==
As classes de dados filtrados são orientadas às classes dos dados consolidadados. Abaixo como elas se relacionam no processo de consolidação.
===geoaddress===
.. link para o consolidado.
===geopoint ===
... link para o consolidado
Alguns doadores não possuem pontos de endereçamento, mas possuem
*"pontos de poste": postes da linha de transmissão elétrica das ruas de uma cidade.
*"marcos geodésicos": pontos para ajuste do GPS, etc.
*.. outros a classificar. Por exemplo tampas de esgoto, hidrantes, etc.
Esses pontos são em geral mais precisos, portanto ajudam a consolidar os demais dados.
---
Exemplos exóticos: no Chile nos fornecem *pontos de inicio e fim de face de quadra*, ou seja, ao invés da numeração predial, uma interpolação precisa.


-----
-----


== 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:
Linha 123: Linha 153:
|-
|-
|<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 157: Linha 187:
|string
|string
|-
|-
|2
| 2
|block-metric
| block-metric
|<code>[0-9]+ \- [0-9]+</code>
| <code>[0-9]+ \- [0-9]+</code>
|integer function
|integer function
|-
|-
Linha 167: Linha 197:
|
|
|-
|-
| 4
|4
|df-block
|df-block  
|
|
|
|
Linha 175: Linha 205:
[[Categoria:Digital-guard]]
[[Categoria:Digital-guard]]


== Campos padronizados ==
==Campos padronizados==


Para facilitar
Para facilitar
{| class="wikitable"
{| class="wikitable"
! layer !! campo !! alias !! full !! descricao_ptbr !! descricao_en
!layer!!campo!!alias!!full!!descricao_ptbr!!descricao_en
|-
|-
| geoaddress/parcel/building/via/nsvia/genericvia/block || gid || sim || identificador único || ||  
|geoaddress/parcel/building/via/nsvia/genericvia/block || gid||sim||identificador único|| ||
|-
|-
| geoaddress/parcel/building/via/nsvia/genericvia/block || geom || sim || geometria da feature || ||  
| geoaddress/parcel/building/via/nsvia/genericvia/block||geom||sim||geometria da feature|| ||
|-
|-
| geoaddress/parcel/building || via || addr:street || sim || nome do logradouro || name of the street that a feature is located by/at
|geoaddress/parcel/building|| via || addr:street||sim||nome do logradouro||name of the street that a feature is located by/at
|-
|-
| geoaddress/parcel/building || hnum || addr:housenumber || sim || número de porta || Number that is included in the address. The number may contain non-digits
|geoaddress/parcel/building||hnum||addr:housenumber||sim||número de porta || Number that is included in the address. The number may contain non-digits
|-
|-
| geoaddress/parcel/building || sup || complemento || complementary information that compose the postal address || ||  
|geoaddress/parcel/building||sup||complemento|| complementary information that compose the postal address|| ||
|-
|-
| geoaddress/parcel/building || postcode || addr:postcode || código postal (CEP) || postal code ||  
|geoaddress/parcel/building||postcode||addr:postcode|| código postal (CEP)||postal code||
|-
|-
| geoaddress/parcel/building || nsvia || addr:suburb || nome do bairro || name of the suburb ||  
|geoaddress/parcel/building||nsvia||addr:suburb||nome do bairro||name of the suburb||
|-
|-
| geoaddress/parcel/building || name || name || nome do ponto de interesse || name of point of interest ||  
|geoaddress/parcel/building
|name||name||nome do ponto de interesse||name of point of interest||
|-
|-
| geoaddress/parcel/building || ref || identificador || || ||  
|geoaddress/parcel/building||ref || identificador|| || ||
|-
|-
| geoaddress/parcel/building || nsref || identificador nsvia || || ||  
| geoaddress/parcel/building||nsref||identificador nsvia || || ||
|-
|-
| geoaddress/parcel/building || blref || identificador block || || ||  
|geoaddress/parcel/building||blref||identificador block || || ||
|-
|-
| geoaddress/parcel/building || place || addr:place || Used when addr:housenumber is not relating to a street but to other entity, usually a settlement || ||  
|geoaddress/parcel/building||place||addr:place||Used when addr:housenumber is not relating to a street but to other entity, usually a settlement|| ||
|-
|-
| geoaddress/parcel/building || city || addr:city || The name of the largest settlement (city/town) that is included in the address || ||  
|geoaddress/parcel/building||city||addr:city ||The name of the largest settlement (city/town) that is included in the address || ||
|-
|-
| geoaddress/parcel/building || country || addr:country || The country code that is included in the address || ||  
|geoaddress/parcel/building||country||addr:country|| The country code that is included in the address|| ||
|-
|-
| geoaddress/parcel/building || block || addr:block || The city block that is part of the address || ||  
|geoaddress/parcel/building||block||addr:block||The city block that is part of the address|| ||
|-
|-
| geoaddress/parcel/building || district || addr:district || The name of the district that is included in the address || ||  
| geoaddress/parcel/building||district ||addr:district||The name of the district that is included in the address|| ||
|-
|-
| building || building || building || Era class. || Architectural typology of the building. ||  
|building||building||building || Era class.||Architectural typology of the building.||
|-
|-
| building || use || building:use || What kind of function a building=* serves. This tag can be handy when the form or original purpose of a building differs from its present use. || ||  
|building ||use||building:use ||What kind of function a building=* serves. This tag can be handy when the form or original purpose of a building differs from its present use.|| ||
|-
|-
| building || amenity || amenity || Useful and important facilities for visitors and residents, such as toilets, telephones, banks, pharmacies, prisons and schools. || ||  
|building||amenity||amenity||Useful and important facilities for visitors and residents, such as toilets, telephones, banks, pharmacies, prisons and schools.|| ||
|-
|-
| building || levels || building:levels || The number of visible levels (floors) || ||  
| building||levels
|building:levels||The number of visible levels (floors)|| ||
|-
|-
| building || material || building:material || Outer material for the building façade || ||  
| building||material
|building:material||Outer material for the building façade|| ||
|-
|-
| building || min_level || building:min_level || For describing number of values, "filling" space between ground level and bottom level of building or part of building || ||  
|building||min_level||building:min_level
|For describing number of values, "filling" space between ground level and bottom level of building or part of building|| ||
|-
|-
| building || part || building:part || To mark a part of a building, which has attributes, different from such ones at other parts || ||  
|building ||part||building:part||To mark a part of a building, which has attributes, different from such ones at other parts || ||
|-
|-
| building || height || height || The height of the building in meters || ||  
|building||height||height||The height of the building in meters|| ||
|-
|-
| via || via || name || sim || nome da via || street name
|via ||via|| name|| sim||nome da via||street name
|-
|-
| via || postcode || postal_code || indica o código postal dos imóveis lindeiros a via. || ||  
| via||postcode||postal_code||indica o código postal dos imóveis lindeiros a via.|| ||
|-
|-
| via || highway || highway || categoria da via. || Identifies the category of the street or path ||  
| via|| highway||highway||categoria da via.||Identifies the category of the street or path
|
|-
|-
| via || lanes || lanes || Indicates how many traffic lanes there are on a highway || ||  
|via || lanes||lanes ||Indicates how many traffic lanes there are on a highway|| ||
|-
|-
| via || lit || lit || indica se a via é iluminada. || Indicates the presence or absence of lighting on a street ||  
| via||lit || lit ||indica se a via é iluminada.||Indicates the presence or absence of lighting on a street||
|-
|-
| via || sidewalk || sidewalk || indica se a via possui calçadas nas laterais. || Indicates the presence or absence of sidewalk alongside a street ||  
| via||sidewalk|| sidewalk ||indica se a via possui calçadas nas laterais.||Indicates the presence or absence of sidewalk alongside a street||
|-
|-
| via || surface || surface || ndica a superfície da via. || Provides information about physical surface of a street or path. ||  
|via||surface ||surface||ndica a superfície da via.||Provides information about physical surface of a street or path.||
|-
|-
| via || oneway || oneway || indica se a via possui sentido único. || Indicates whether a street is one-way. ||  
|via||oneway ||oneway
|indica se a via possui sentido único. ||Indicates whether a street is one-way.||
|-
|-
| nsvia || nsvia || name || sim || nome do bairro ||  
|nsvia||nsvia||name||sim ||nome do bairro||
|-
|-
| nsvia || postcode || postal_code || indica o código postal dos imóveis dentro do bairro. || ||  
|nsvia ||postcode||postal_code||indica o código postal dos imóveis dentro do bairro.|| ||
|-
|-
| nsvia || ref || identificador || || ||  
|nsvia ||ref||identificador|| || ||
|-
|-
| genericvia || via || name || sim || nome da genericvia ||  
|genericvia||via ||name||sim||nome da genericvia||
|-
|-
| genericvia || type || sim || tipo da genericvia || ||  
| genericvia|| type||sim||tipo da genericvia|| ||
|-
|-
| genericvia || ref || código da genericvia || || ||  
| genericvia||ref||código da genericvia|| || ||
|-
|-
| block || name || name || sim || nome da quadra ||  
|block||name||name ||sim ||nome da quadra||
|-
|-
| block || postcode || postal_code || indica o código postal dos imóveis dentro da quadra. || ||  
|block||postcode||postal_code|| indica o código postal dos imóveis dentro da quadra. || ||
|-
|-
| block || ref || identificador || || ||  
|block|| ref||identificador|| || ||
|-
|-
| block || nsref || identificador do bairro. || || ||  
|block|| nsref|| identificador do bairro.|| || ||
|}
|}




== Error mask ==
==Error mask==
The sequence of bits of an item indicating errors is as follows:
The sequence of bits of an item indicating errors is as follows:


Linha 274: Linha 310:
From right to left, a bit equal to 1 means:
From right to left, a bit equal to 1 means:


* Item is found outside the expected jurisdiction boundaries;
*Item is found outside the expected jurisdiction boundaries;
* Item does not have valid geometry. For example, it is expected that a building be represented by a closed geometry, _i.e._ a polygon;
*Item does not have valid geometry. For example, it is expected that a building be represented by a closed geometry, _i.e._ a polygon;
* Item does not have simple geometry. Aiming to a broader support, our standard requires that features must not be composite objects, for example, streets as `MultiLinestrings`;
*Item does not have simple geometry. Aiming to a broader support, our standard requires that features must not be composite objects, for example, streets as `MultiLinestrings`;
* Item has empty geometry. That means the dataset contains one or more geometries without geographic coordinates assigned to it; (please confirm)
*Item has empty geometry. That means the dataset contains one or more geometries without geographic coordinates assigned to it; (please confirm)
* Item has area or length less than 5 or 2, respectively;
*Item has area or length less than 5 or 2, respectively;
* Item has zero geometry. That means the dataset contains one or more features without geometry assigned to it; (please confirm);
*Item has zero geometry. That means the dataset contains one or more features without geometry assigned to it; (please confirm);
* Item has geometry with a different type than that established for the layer in `feature_type`;
*Item has geometry with a different type than that established for the layer in `feature_type`;
* Duplicate item. Two items are duplicated if their geohashes of length 9 are the same;
*Duplicate item. Two items are duplicated if their geohashes of length 9 are the same;
* Item with non-closed geometry when expected, _e.g._ polygons;
*Item with non-closed geometry when expected, _e.g._ polygons;
* Item with very large geometry. Currently, if area or length exceeds 2,147,483,647;
*Item with very large geometry. Currently, if area or length exceeds 2,147,483,647;
* The leftmost two bits are reserved for possible future use and, for the time being, are always set to zero.
*The leftmost two bits are reserved for possible future use and, for the time being, are always set to zero.