place

A place is a business or point of interest within the world.

Geometry Type	Point
Theme	places
Type	place

Schema

Browsable

Loading ....

YAML

---
"$schema": https://json-schema.org/draft/2020-12/schema
title: Place Schema
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
    required: [categories]
    allOf:
      - "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
    properties:
      names: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/names" }
      categories:
        description: The categories of the place. The list of categories can be found <TODO>.
        type: object
        required: [main]
        properties:
          main:
            description: The main category of the place.
            type: string
          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 main category can be augmented with additional applicable categories.
            type: array
            items:
              type: string
            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. We consider a location with multiple brands as separate places, each with their own brand.
        type: object
        properties:
          names: { "$ref": "../defs.yaml#/$defs/propertyDefinitions/names" }
          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": {
      "main": "someCategory"
    },
    "confidence": 0.9,
    "websites": [
      "https://www.example.com"
    ],
    "emails": [
      "info@example.com"
    ],
    "socials": [
      "https://www.twitter.com/example"
    ],
    "phones": [
      "+32 1207"
    ],
    "brand": {
      "names": {
        "common": [
          {
            "value": "My Sweet POI Brand",
            "language": "local"
          }
        ]
      },
      "wikidata": "Q1000"
    },
    "addresses": [
      {
        "freeform": "770 Broadway, Floor 8",
        "locality": "New York"
      },
      {
        "freeform": "770 Brodway, #802",
        "locality": "New York",
        "region": "NY",
        "country": "US"
      }
    ],
    "theme": "places",
    "type": "place",
    "version": 0,
    "updateTime": "2023-02-22T23:55:01-08:00",
    "sources": [
      {
        "property": "",
        "dataset": "metaPlaces",
        "recordId": "10101"
      },
      {
        "property": "/properties/brand",
        "dataset": "msftPlaces",
        "recordId": "10df72b8"
      }
    ],
    "names": {
      "common": [
        {
          "value": "My Sweet POI",
          "language": "local"
        },
        {
          "value": "Something in Spanish",
          "language": "es"
        }
      ],
      "short": [
        {
          "value": "MSPOI",
          "language": "local"
        }
      ]
    }
  }
}

Alternate Categories

{
  "id": "overture:places:place:1",
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      0,
      0
    ]
  },
  "properties": {
    "categories": {
      "main": "someCategory",
      "alternate": [
        "anotherCategory"
      ]
    },
    "confidence": 0.9,
    "websites": [
      "https://www.example.com"
    ],
    "emails": [
      "info@example.com"
    ],
    "socials": [
      "https://www.twitter.com/example"
    ],
    "phones": [
      "+32 1207"
    ],
    "brand": {
      "names": {
        "common": [
          {
            "value": "My Sweet POI Brand",
            "language": "local"
          }
        ]
      },
      "wikidata": "Q1000"
    },
    "addresses": [
      {
        "freeform": "770 Broadway, Floor 8",
        "locality": "New York"
      },
      {
        "freeform": "770 Brodway, #802",
        "locality": "New York",
        "region": "NY",
        "country": "US"
      }
    ],
    "theme": "places",
    "type": "place",
    "version": 0,
    "updateTime": "2023-02-22T23:55:01-08:00",
    "names": {
      "common": [
        {
          "value": "My Sweet POI",
          "language": "local"
        },
        {
          "value": "Something in Spanish",
          "language": "es"
        }
      ],
      "short": [
        {
          "value": "MSPOI",
          "language": "local"
        }
      ]
    }
  }
}