place.yaml

---
"$schema": https://json-schema.org/draft/2020-12/schema
title: place
description: >-
  A Place is a point representation of a real-world facility, service,
  or amenity. Place features are compatible with GeoJSON Point features.
type: object
properties:
  id:
    "$ref": ../defs.yaml#/$defs/propertyDefinitions/id
  geometry:
    description: >-
      Place's geometry which MUST be a Point as defined by GeoJSON
      schema.
    unevaluatedProperties: false
    oneOf:
      - "$ref": https://geojson.org/schema/Point.json
  properties:
    unevaluatedProperties: false
    allOf:
      - "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
      - "$ref": ../defs.yaml#/$defs/propertyContainers/namesContainer
    properties:
      categories:
        description: |
          The categories of the place. Complete list is available on
          GitHub: https://github.com/OvertureMaps/schema/blob/main/docs/schema/concepts/by-theme/places/overture_categories.csv
        type: object
        required: [primary]
        properties:
          primary:
            description: The primary or main category of the place.
            "$ref": "./defs.yaml#/$defs/typeDefinitions/category"
          alternate:
            description:
              Alternate categories of the place. Some places might fit into two
              categories, e.g. a book store and a coffee shop. In such a case,
              the primary category can be augmented with additional applicable
              categories.
            type: array
            items:
              "$ref": "./defs.yaml#/$defs/typeDefinitions/category"
            uniqueItems: true
      confidence:
        description: The confidence of the existence of the place. It's a number between 0 and 1. 0 means that we're sure that the place doesn't exist (anymore). 1 means that we're sure that the place exists. If there's no value for the confidence, it means that we don't have any confidence information.
        type: number
        minimum: 0
        maximum: 1
      websites:
        description: The websites of the place.
        type: array
        items:
          type: string
          format: uri
        uniqueItems: true
      socials:
        description: The social media URLs of the place.
        type: array
        items:
          type: string
          format: uri
        uniqueItems: true
      emails:
        description: The email addresses of the place.
        type: array
        items:
          type: string
          format: email
        uniqueItems: true
      phones:
        description: The phone numbers of the place.
        type: array
        items:
          type: string
        uniqueItems: true
      brand:
        description: >-
          The brand of the place. A location with multiple brands is
          modeled as multiple separate places, each with its own brand.
        type: object
        allOf:
          - "$ref": "../defs.yaml#/$defs/propertyContainers/namesContainer"
        properties:
          wikidata: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/wikidata" }
      addresses:
        description: The addresses of the place.
        type: array
        items:
          "$ref": "../defs.yaml#/$defs/propertyDefinitions/address"
        uniqueItems: true