Add admin_level to divisions

counterexamples/divisions/division/bad-admin-level.yaml

@@ -0,0 +1,21 @@
+---
+id: counterexample:division:bad-admin-level
+type: Feature
+geometry:
+  type: Point
+  coordinates: [0, 0]
+properties:
+  theme: divisions
+  type: division
+  version: 0
+  subtype: country
+  names:
+    primary: Invalid admin_level Example
+  country: ZZ
+  hierarchies:
+    - - division_id: counterexample:division:bad-admin-level
+        subtype: country
+        name: Invalid admin_level Example
+  admin_level: -1
+  ext_expected_errors:
+    - "minimum: got -1, want 0"

examples/divisions/division/country.yaml

@@ -18,4 +18,5 @@ properties:
         name: United States
   norms:
     driving_side: right
+  admin_level: 0
   capital_division_ids: [ example:division:locality:washington_dc ]

examples/divisions/division/dependency.yaml

@@ -34,5 +34,6 @@ properties:
         name: United States
   norms:
     driving_side: right
+  admin_level: 1
   capital_division_ids: [ example:division:locality:san_juan ]
   parent_division_id: example:division:country:us

schema/divisions/division.yaml

@@ -149,6 +149,12 @@ properties:     # JSON Schema: Top-level object properties.
           parent divisions.
         allOf:
           - "$ref": "../defs.yaml#/$defs/propertyDefinitions/id"
+      admin_level:
+        description:
+          Integer representing this division's position in its country's administrative
+          hierarchy. Lower numbers correspond to higher-level administrative units.
+        type: integer
+        minimum: 0
       perspectives:
         description: >-
           Political perspectives from which this division is considered

schema/divisions/division_area.yaml

@@ -73,3 +73,9 @@ properties:     # JSON Schema: Top-level object properties.
           belongs to.
         allOf:
           - "$ref": "../defs.yaml#/$defs/propertyDefinitions/iso3166_2SubdivisionCode"
+      admin_level:
+        description:
+          Integer representing the associated division's position in the country's
+          administrative hierarchy. Lower numbers correspond to higher-level divisions.
+        type: integer
+        minimum: 0

schema/divisions/division_boundary.yaml

@@ -92,6 +92,12 @@ properties:     # JSON Schema: Top-level object properties.
           present on boundaries between different principal subdivisions or countries.
         allOf:
           - "$ref": "../defs.yaml#/$defs/propertyDefinitions/iso3166_2SubdivisionCode"
+      admin_level:
+        description:
+          Integer representing the administrative level shared by both divisions on the
+          boundary. Lower numbers correspond to higher-level administrative units.
+        type: integer
+        minimum: 0
       is_disputed:
         description: >-
           Indicator if there are entities disputing this division boundary.