Supporting files for buildings theme

[LukaszMichalski-TomTom]

Feb 22, 2024: This PR has been resurrected and re-based, scroll to bottom for context

---

Added mapping files for OSM values to Overture enumeration values.
Additional values:
facadeMaterial:

• clay
• timber_framing

roofMaterial

• gravel
• solar_panels

roofShape:

• saltbox
• skillion
• sawtooth

Four roof shape names changed to OSM equivalents, e.g. gable→gabled. I did it to make it more in line with OSM tooling and possible renders that can generate roof geometry based on this value. If someone would like to use Overture data to generate visualization, it may be easier for them.

[jwass]

@LukaszMichalski-TomTom I realize these aren't all your doing, but can you make all the Overture values camelCased?

It's the standard (even though I don't love it).

[jwass]

@LukaszMichalski-TomTom Just so I understand... facadeMaterial describes the mapping for

• building:material=* (and also building:facade:material?)
• roofMaterial is for roof:material
• roofShape is for roof:shape
  ??

[LukaszMichalski-TomTom]

@jwass

@LukaszMichalski-TomTom Just so I understand... facadeMaterial describes the mapping for

• building:material=* (and also building:facade:material?)
• roofMaterial is for roof:material
• roofShape is for roof:shape
  ??

I will add README next to mapping files to describe osm tag that need to be used.
overture_facadeMaterial_OSM_mapping.json file contains mapping of OSM values to Overture facedMaterial property. OSM tags used for mapping in order:

• building:material (documentation: https://wiki.openstreetmap.org/wiki/Key:building:material)
• building:facade:material (documentation: https://wiki.openstreetmap.org/wiki/Key:building:facade:material)

overture_roofMaterial_OSM_mapping.json file contains mapping of OSM values to Overture roofMaterial property. OSM tags used for mapping:

• roof:material (documentation: https://wiki.openstreetmap.org/wiki/Key:roof:material)

overture_roofShape_OSM_mapping.json file contains mapping of OSM values to Overture roofShape property. OSM tags used for mapping in order:

• roof:shape (documentation: https://wiki.openstreetmap.org/wiki/Key:roof:shape)
• building:roof:shape (deprecated, documentation: https://wiki.openstreetmap.org/wiki/Key

[vcschapp]

Reminder: @jwass took the action to consult with the PR authors and determine if this can be brought back to life.

[vcschapp]

Could you please:

1. Fix facedMaterial to facadeMaterial? (typo in the README.md)
2. Ensure the files end in a newline (should not have the no newline at EOF icon at the bottom of every diff)

[jenningsanderson]

@LukaszMichalski-TomTom I updated these to be snake_case in-line with the new schema updates and added them all to one file.

These are out-of-sync with the current logic in the buildings airflow pipeline and schema, which is causing hundreds of thousands of validation errors, which will soon cause the theme to fail promotion.

Can you confirm that these are the correct mappings (see the table below), then we can make sure that the pipeline and schema files are up-to-date?

[jenningsanderson]

Based on the current logic in the mapping JSON file (https://github.com/OvertureMaps/schema/pull/89/files#diff-5e18ae5feffd2d58657bf46be190bc986fb510fc7ee3b69f0e2d185828f4fad1), here are the counts for thee entire building theme:

roof_shape	_count
gabled	4159376
flat	1370802
hipped	756957
pyramidal	249441
skillion	188343
half_hipped	100036
saltbox	55879
round	39348
gambrel	32996
mansard	23322
dome	16401
onion	5980
sawtooth	600
spherical	26

roof_material	count
roof_tiles	856423
metal	187222
eternit	129954
concrete	127903
slate	58635
glass	38825
thatch	21904
grass	12637
plastic	7316
copper	7299
gravel	7153
wood	3715
solar_panels	179

facade_material	count
brick	514852
cement_block	448061
plaster	398151
wood	210496
concrete	174449
metal	91201
stone	41789
glass	38035
clay	30661
plastic	16514
timber_framing	9975

[jenningsanderson]

I added tar_paper as an acceptable value because it's the 4th largest on OSM

[vcschapp]

    ) )        /\
   =====      /  \
  _|___|_____/ __ \____________
 |::::::::::/ |  | \:::::::::::|
 |:::::::::/  ====  \::::::::::|
 |::::::::/__________\:::::::::|
 |_________|  ____  |__________|
  | ______ | / || \ | _______ |
  ||  |   || ====== ||   |   ||
  ||--+---|| |    | ||---+---||
  ||__|___|| |   o| ||___|___||
  |========| |____| |=========|
 (^^-^^^^^-|________|-^^^--^^^)
 (,, , ,, ,/________\,,,, ,, ,)
','',,,,' /__________\,,,',',;;