[wip] Segment subclasses

OvertureMaps · Apr 30, 2024 · c6fa8b9 · c6fa8b9
1 parent 487ca2a
commit c6fa8b9
Showing 1 changed file with 26 additions and 8 deletions.
diff --git a/schema/transportation/segment.yaml b/schema/transportation/segment.yaml
@@ -65,13 +65,9 @@ properties:
         - living_street   # Similar to residential but has implied legal restriction for motor vehicles (which can vary country by country)
         - trunk
         - unclassified    # Known roads, paved, but subordinate to all of: motorway, trunk, primary, secondary, tertiary
-        - parking_aisle   # Service road intended for parking
-        - driveway        # Service road intended for deliveries
-        - alley           # Service road intended for rear entrances, fire exits
+        - service         # Provides vehicle access to a feature (such as a building), typically not part of the public street network
         - pedestrian
-        - footway
-        - sidewalk
-        - crosswalk
+        - footway         # Minor segments mainly used by pedestrians
         - steps
         - path
         - track
@@ -135,6 +131,16 @@ properties:
       unevaluatedProperties: false
       default: {}
       properties:
+        subclasses:
+          description: TODO
+          type: array
+          items:
+            type: object
+            allOf:
+              - { "$ref": "../defs.yaml#/$defs/propertyContainers/geometricRangeScopeContainer" }
+            unevaluatedProperties: false
+            properties:
+              value: { "$ref": "#/$defs/propertyDefinitions/subclass" }
         surface:
           description: Physical surface of the road. May either be
             specified as a single global value for the segment, or as
@@ -289,11 +295,11 @@ properties:
                     minProperties: 1
                     unevaluatedProperties: false
     roadFlag:
-      description: Simple flags that can be on or off for a road segment
+      description: >-
+        Simple flags that can be on or off for a road segment. Specifies physical characteristics and can overlap.
       type: string
       enum:
         - is_bridge
-        - is_link
         - is_tunnel
         - is_under_construction
         - is_abandoned
@@ -328,6 +334,18 @@ properties:
         - value
         - unit
       unevaluatedProperties: false
+    subclass:
+      description: >-
+        Refines expected usage of the segment, must not overlap.
+      type: string
+      enum:
+        - link             # Connecting stretch (sliproad or ramp) between two road types
+        - sidewalk         # Footway that lies along a road
+        - crosswalk        # Footway that intersects other roads
+        - parking_aisle    # Service road intended for parking
+        - driveway         # Service road intended for deliveries
+        - alley            # Service road intended for rear entrances, fire exits
+        - cycle_crossing   # Cycleway that intersects with other roads
     purposeOfUse:
       description: >-
         Reason why a person or entity travelling on the transportation