Place

A place is point of interest in the real world.

Geometry Type	Point
Theme	places
Type	place

Schema

Browsable

Loading ....

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

Examples

Place

{
  "id": "overture:places:place:1",
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      0,
      0
    ]
  },
  "properties": {
    "categories": {
      "primary": "some_category"
    },
    "confidence": 0.9,
    "websites": [
      "https://www.example.com"
    ],
    "emails": [
      "info@example.com"
    ],
    "socials": [
      "https://www.twitter.com/example"
    ],
    "phones": [
      "+32 1207"
    ],
    "brand": {
      "names": {
        "primary": "My Sweet POI Brand"
      },
      "wikidata": "Q1000"
    },
    "addresses": [
      {
        "freeform": "770 Broadway, Floor 8",
        "locality": "New York"
      },
      {
        "freeform": "770 Brodway, #802",
        "locality": "New York",
        "region": "US-NY",
        "country": "US"
      }
    ],
    "theme": "places",
    "type": "place",
    "version": 1,
    "sources": [
      {
        "property": "",
        "dataset": "metaPlaces",
        "record_id": "10101"
      },
      {
        "property": "/properties/brand",
        "dataset": "msftPlaces",
        "record_id": "10df72b8"
      }
    ],
    "names": {
      "primary": "My Sweet POI",
      "common": {
        "es": "Something in Spanish"
      },
      "rules": [
        {
          "variant": "short",
          "value": "MSPOI"
        }
      ]
    }
  }
}

Alternate Categories

{
  "id": "overture:places:place:1",
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      0,
      0
    ]
  },
  "properties": {
    "categories": {
      "primary": "the1_category_you_want_first",
      "alternate": [
        "another_category"
      ]
    },
    "confidence": 0.9,
    "websites": [
      "https://www.example.com"
    ],
    "emails": [
      "info@example.com"
    ],
    "socials": [
      "https://www.twitter.com/example"
    ],
    "phones": [
      "+32 1207"
    ],
    "brand": {
      "names": {
        "primary": "My Sweet POI Brand"
      },
      "wikidata": "Q1000"
    },
    "addresses": [
      {
        "freeform": "770 Broadway, Floor 8",
        "locality": "New York"
      },
      {
        "freeform": "770 Broadway, #802",
        "locality": "New York",
        "region": "US-NY",
        "country": "US"
      }
    ],
    "theme": "places",
    "type": "place",
    "version": 1,
    "names": {
      "primary": "My Sweet POI",
      "common": {
        "es": "Something in Spanish"
      },
      "rules": [
        {
          "variant": "short",
          "value": "MSPOI"
        }
      ]
    }
  }
}