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.<!-- > 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.<!-- > 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!!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 | |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 | ||
|building:levels||The number of visible levels (floors)|| || | |||
|- | |- | ||
| building || material | | building||material | ||
|building:material||Outer material for the building façade|| || | |||
|- | |- | ||
| building || min_level || building:min_level | |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 | |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. |
Edição das 10h36min de 13 de fevereiro de 2024
- (texto original trazido de https://git.digital-guard.org/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:
- geopoint: Geo-ponto. Representação geográfica de um ponto qualquer de interesse (PoI), diferente do Geo-endereço.
- genericvia: Ferrovia, hidrovia ou qualquer outra "via complementar generalizada" que ajude a delimitar polígonos de quadra.
- nsvia: Namespace para distinguir vias duplicadas, tipicamente nome de polígono de bairro ou de loteamento.
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 | Descrição resumida |
---|---|---|---|---|
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 | |
26 | geopoint_full | point | não | Representação geográfica de elementos genéricos, como ponto. Ver: digital-guard/preserv#91 |
27 | geopoint_ext | point | SIM | |
28 | geopoint_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 | |
91 | datagrid_full | point | não | Para grades de pontos. ftid=92 será implementado conforme necessidade. Ver digital-guard/preserv#115 |
92 | datagrid_ext | point | SIM | |
93 | datagrid_none | point | 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:
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 |
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
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 |
Campos padronizados
Para facilitar
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 | 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 | 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 | 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 | name | name | nome do ponto de interesse | name of point of interest | |
geoaddress/parcel/building | ref | identificador | |||
geoaddress/parcel/building | nsref | identificador nsvia | |||
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 | 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 | 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 | ||
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 | 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 | 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 | 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 | ||
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 | 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 | 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 | 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. | |
nsvia | nsvia | name | sim | nome do bairro | |
nsvia | postcode | postal_code | indica o código postal dos imóveis dentro do bairro. | ||
nsvia | ref | identificador | |||
genericvia | via | name | sim | nome da genericvia | |
genericvia | type | sim | tipo da genericvia | ||
genericvia | ref | código da genericvia | |||
block | name | name | sim | nome da quadra | |
block | postcode | postal_code | indica o código postal dos imóveis dentro da quadra. | ||
block | ref | identificador | |||
block | nsref | identificador do bairro. |
Error mask
The sequence of bits of an item indicating errors is as follows:
`error_mask=0000000000000`
From right to left, a bit equal to 1 means:
- 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 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 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 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;
- 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;
- The leftmost two bits are reserved for possible future use and, for the time being, are always set to zero.