Skip to content

Commit

Permalink
Update defs.yaml
Browse files Browse the repository at this point in the history
  • Loading branch information
jonahadkins committed Sep 7, 2024
1 parent d543f47 commit 11bcbb6
Showing 1 changed file with 47 additions and 14 deletions.
61 changes: 47 additions & 14 deletions schema/defs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,11 @@ description: Common schema definitions shared by all themes
description: Specific feature type within the theme
type: string
enum:
- address
- division_boundary
- building
- connector
- division
- division_area
- division_boundary
- infrastructure
- land
- land_cover
Expand Down Expand Up @@ -93,7 +92,6 @@ description: Common schema definitions shared by all themes
record_id:
type: string
description: Refers to the specific record within the dataset that was used.
update_time: { "$ref": "#/$defs/propertyDefinitions/featureUpdateTime" }
confidence:
description: Confidence value from the source dataset, particularly relevant for ML-derived data.
type: number
Expand All @@ -103,7 +101,6 @@ description: Common schema definitions shared by all themes
description: Top-level Overture theme this feature belongs to
type: string
enum:
- addresses
- base
- buildings
- divisions
Expand Down Expand Up @@ -243,13 +240,13 @@ description: Common schema definitions shared by all themes
syntactic level. It verifies that candidate tags follow the grammar
described in the RFC, but not that they are validly registered tag
in IANA's language subtag registry.
In understanding the regular expression, remark that '(:?' indicates
a non-capturing group, and that all the top-level or non-nested
groups represent top-level components of `langtag` referenced in the
syntax section of https://www.rfc-editor.org/rfc/bcp/bcp47.txt. In
particular, the top-level groups in left-to-right order represent:
1. language
2. ["-" script]
3. ["-" region]
Expand Down Expand Up @@ -298,14 +295,15 @@ description: Common schema definitions shared by all themes
title: overture properties
description: Top-level properties shared by all Overture features
type: object
required: [ theme, type, version ]
required: [ theme, type, version, update_time ]
patternProperties:
^ext_.*$:
description: "Additional top-level properties must be prefixed with `ext_`."
properties:
theme: { "$ref": "#/$defs/propertyDefinitions/theme" }
type: { "$ref": "#/$defs/propertyDefinitions/featureType" }
version: { "$ref": "#/$defs/propertyDefinitions/featureVersion" }
update_time: { "$ref": "#/$defs/propertyDefinitions/featureUpdateTime" }
sources: { "$ref": "#/$defs/propertyDefinitions/sources" }
namesContainer:
title: names
Expand All @@ -322,32 +320,31 @@ description: Common schema definitions shared by all themes
level:
"$ref": "#/$defs/propertyDefinitions/level"
geometricRangeScopeContainer:
title: range
description: >-
Geometric scoping properties defining the range of positions on
the segment where something is physically located or where a
rule is active.
properties:
between: { "$ref": "#/$defs/propertyDefinitions/linearlyReferencedRange" }
sideScopeContainer:
title: side
description: >-
Geometric scoping properties defining the side of a road modeled when
moving along the line from beginning to end
properties:
side: { "$ref": "#/$defs/propertyDefinitions/side" }
cartographyContainer:
title: cartography
description: Defines cartographic hints for optimal use of Overture features in map-making.
type: object
properties:
cartography:
title: cartography
type: object
properties:
min_zoom:
description: >-
Recommended minimum tile zoom per the Slippy Maps convention.
The Slippy Maps zooms are explained in the following references:
The Slippy Maps zooms are explained in the following references:
- https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames
- https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection
type: integer
Expand All @@ -356,8 +353,8 @@ description: Common schema definitions shared by all themes
max_zoom:
description: >-
Recommended maximum tile zoom per the Slippy Maps convention.
The Slippy Maps zooms are explained in the following references:
The Slippy Maps zooms are explained in the following references:
- https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames
- https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection
type: integer
Expand All @@ -370,3 +367,39 @@ description: Common schema definitions shared by all themes
of features with a higher number.
type: integer
default: 0
display_theme:
description: >-
An attribute that describes the top level theme a business can be classified under.
This is especially useful when displaying labels / icons for places or buildings in
a thematic manner. For example, blue for transit labels.
type: string
enum:
- aquatic
- civic
- education
- entertainment
- food
- medical
- other
- recreation
- retail
- service
- transit
display_category:
description: >-
An attribute that describes the specific category a business can be classified under.
This is an extended classification under `display_theme`. When displaying labels / icons
for places or buildings in a thematic manner, this attribute can help when displaying
a specific icon. For example, a fork & knife for restaurants or a bus for bus stops.
type: string
enum:
- beach
- office_public
- landmark
- stop_rail
- seafood
- casino
- park_dog
- and many more...


0 comments on commit 11bcbb6

Please sign in to comment.