Locality

Localities are populated areas that are named.

Area polygons of localities, if known, are given by locality area features.

Geometry Type	Point
Theme	admins
Type	locality

Subtypes

A locality may have one of two possible subtypes.

Administrative Locality

subtype	administrative_locality

Administrative localities represent countries and hierarchical subdivisions of countries.

Every administrative locality has a valid admin_level property set, defining its position in the subdivision hierarchy. All administrative localities at sub-country level must have a context_id property containing the GERS ID of the feature's parent administrative locality.

The borders of administrative localities, if known, are given by administrative boundary features.

Named Locality

subtype	named_locality

Named localities represent named areas that are not formally part of the hierarchical subdivision of a country and are not administrative localities.

Schema

Browsable

Loading ....

YAML

---
"$schema": https://json-schema.org/draft/2020-12/schema
title: locality
description: >-
  Localities are named, populated areas. If a locality is a country or
  an official subdivision of a country, it will have adminLevel property
  set and its subtype will be an administrative_locality. Otherwise, the
  admin_level property will not be set and its subtype will be a
  named_locality.
type: object
properties:
  id:
    "$ref": ../defs.yaml#/$defs/propertyDefinitions/id
  geometry:
    unevaluatedProperties: false
    oneOf:
      - "$ref": https://geojson.org/schema/Point.json
  properties:
    unevaluatedProperties: false
    required: [subtype, locality_type, names]
    allOf:
      - title: Conditional Properties
        if: { properties: {subtype: { enum: [administrative_locality] }}}
        then:
          allOf:
          - "$ref": "./defs.yaml#/$defs/propertyContainers/adminPropertiesContainer"
          - title: "Conditional Properties"
            if: {properties: {admin_level: { minimum: 2 }}}
            then:
              required: [context_id]
      - "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
      - "$ref": ../defs.yaml#/$defs/propertyContainers/namesContainer
    properties:
      subtype:
        description: populated area types
        type: string
        enum: [administrative_locality, named_locality]
      locality_type: { "$ref": "./defs.yaml#/$defs/propertyDefinitions/localityType" }
      wikidata: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/wikidata" }
      context_id:
        description: Context entity is the most granular entity that logically contains given entity (but doesn't have to contain it spatially due to minor discrepancies in geometries)
        type: string
      population:
        description: Population in the locality.
        type: integer

Examples

Administrative Locality

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      -61.8743292,
      48.8068635
    ]
  },
  "properties": {
    "theme": "admins",
    "type": "locality",
    "update_time": "2023-02-22T23:55:01-08:00",
    "version": 0,
    "subtype": "administrative_locality",
    "admin_level": 1,
    "context_id": "northAmericaId",
    "locality_type": "country",
    "names": {
      "primary": "United States",
      "common": {
        "en": "United States",
        "es": "Estados Unidos"
      },
      "rules": [
        {
          "variant": "alternate",
          "value": "States"
        },
        {
          "variant": "official",
          "value": "United States of America"
        },
        {
          "variant": "short",
          "value": "US"
        },
        {
          "variant": "short",
          "language": "en",
          "value": "US"
        },
        {
          "variant": "short",
          "language": "en",
          "value": "U.S."
        }
      ]
    }
  }
}