locality

Localities are named, and typically populated, areas.

Area polygon of Localities, if known, are given by Locality Area features.

Geometry Type	Point
Theme	admins
Type	locality

Sub-Types

A locality may have one of two possible sub-types.

Administrative Locality

subType	administrativeLocality

Administrative Localities represent countries and hierarchical subdivisions of countries.

Every Administrative Locality has a valid adminLevel property set, defining its position in the subdivision hierarchy. All Administrative Localities at sub-country level must have a contextId 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	namedLocality

Named Localities represent named areas which are not formally part of the hierarchical subdivision of a country (are not Administrative Localities).

Schema

Browsable

Loading ....

YAML

---
"$schema": https://json-schema.org/draft/2020-12/schema
title: Locality Schema
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 administrativeLocality.
  Otherwise, adminLevel property will not be set and its subType will be a namedLocality.
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, localityType, names]
    allOf:
      - title: Conditional Properties
        if: { properties: {subType: { enum: [administrativeLocality] }}}
        then:
          allOf:
          - "$ref": "./defs.yaml#/$defs/propertyContainers/adminPropertiesContainer"
          - title: "Conditional Properties"
            if: {properties: {adminLevel: { minimum: 3 }}}
            then:
              required: [contextId]
      - "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
    properties:
      subType:
        description: populated area types
        type: string
        enum: [administrativeLocality, namedLocality]
      localityType: { "$ref": "./defs.yaml#/$defs/propertyDefinitions/localityType" }
      names: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/names" }
      contextId:
        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

Examples

Administrative Locality

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      -61.8743292,
      48.8068635
    ]
  },
  "properties": {
    "theme": "admins",
    "type": "locality",
    "updateTime": "2023-02-22T23:55:01-08:00",
    "version": 0,
    "subType": "administrativeLocality",
    "adminLevel": 2,
    "contextId": "northAmericaId",
    "localityType": "country",
    "names": {
      "alternate": [
        {
          "language": "local",
          "value": "States"
        }
      ],
      "common": [
        {
          "language": "local",
          "value": "United States"
        },
        {
          "language": "en",
          "value": "United States"
        },
        {
          "language": "es",
          "value": "Estados Unidos"
        }
      ],
      "official": [
        {
          "language": "local",
          "value": "United States of America"
        }
      ],
      "short": [
        {
          "language": "local",
          "value": "US"
        },
        {
          "language": "en",
          "value": "US"
        },
        {
          "language": "en",
          "value": "U.S."
        }
      ]
    }
  }
}