$schema: https://json-schema.org/draft/2020-12/schema
title: division_area
description: 'Division areas are polygons that represent the land or maritime area
  covered by a division.

  Each division area belongs to a division which it references by ID, and for which
  the division area provides an area polygon. For ease of use, every division area
  repeats the subtype, names, country, and region properties of the division it belongs
  to.'
type: object
properties:
  id:
    $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyDefinitions/id
  geometry:
    description: Division area geometries MUST be polygons or multi-polygons as defined
      by the GeoJSON schema.
    unevaluatedProperties: false
    oneOf:
    - $ref: https://geojson.org/schema/Polygon.json
    - $ref: https://geojson.org/schema/MultiPolygon.json
  properties:
    unevaluatedProperties: false
    required:
    - theme
    - type
    - names
    - subtype
    - class
    - country
    - division_id
    - is_land
    - is_territorial
    allOf:
    - $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
    - $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyContainers/namesContainer
    anyOf:
    - properties:
        is_land:
          const: true
    - properties:
        is_territorial:
          const: true
    properties:
      theme:
        const: divisions
      type:
        const: division_area
      subtype:
        $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/divisions/definitions/schema.yaml#/$defs/propertyDefinitions/placetype
      class:
        type: string
        enum:
        - land
        - maritime
      is_land:
        description: A boolean to indicate whether or not the feature geometry represents
          the land-clipped, non-maritime boundary. The geometry can be used for map
          rendering, cartographic display, and similar purposes.
        type: boolean
      is_territorial:
        description: A boolean to indicate whether or not the feature geometry represents
          Overture's best approximation of this place's maritime boundary. For coastal
          places, this would tend to include the water area. The geometry can be used
          for data processing, reverse-geocoding, and similar purposes.
        type: boolean
      division_id:
        description: Division ID of the division this area belongs to.
        allOf:
        - $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyDefinitions/id
      country:
        description: ISO 3166-1 alpha-2 country code of the division this area belongs
          to.
        allOf:
        - $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyDefinitions/iso3166_1Alpha2CountryCode
      region:
        description: ISO 3166-2 principal subdivision code of the division this area
          belongs to.
        allOf:
        - $ref: https://ogcincubator.github.io/bblocks-overturemaps/build/annotated/overturemaps/schemas/definitions/schema.yaml#/$defs/propertyDefinitions/iso3166_2SubdivisionCode
