# Place

This type is derived from <https://schema.org/Place>, which means that any of this type's properties within schema.org may also be used. Note however the properties on this page must be used in preference if a relevant property is available.

## **Properties**

### **Required properties**

| Property | Expected Type                     | Description                                                                                         |
| -------- | --------------------------------- | --------------------------------------------------------------------------------------------------- |
| @type    | [`Text`](https://schema.org/Text) | Must always be present and set to `"@type": "Place"`                                                |
| name     | [`Text`](https://schema.org/Text) | <p>The name of the Place</p><p><br>Example</p><p><code>"name": "Raynes Park High School"</code></p> |

### **Required options**

While these properties are marked as recommended in the specification, a data publisher must provide as much detail in both `address` and `geo` for an event as possible.

| Property | Expected Type                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| address  | <p><a href="https://developer.openactive.io/data-model/types/postaladdress"><code>PostalAddress</code></a><br>- or -<br><a href="https://schema.org/Text"><code>Text</code></a></p> | <p>A structured PostalAddress object for the Place.</p><p>Ideally the address should be provided using the PostalAddress structured format. Google Reserve requires <a href="https://schema.org/PostalAddress"><https://schema.org/PostalAddress></a> and will not accept plain text addresses.</p><p><br>Example</p><p><code>"address": {</code><br>  <code>"@type": "PostalAddress",</code><br>  <code>"streetAddress": "Raynes Park High School, 46A West Barnes Lane",</code><br>  <code>"addressLocality": "New Malden",</code><br>  <code>"addressRegion": "London",</code><br>  <code>"postalCode": "NW5 3DU",</code><br>  <code>"addressCountry": "GB"</code><br><code>}</code></p> |
| geo      | [`GeoCoordinates`](https://developer.openactive.io/data-model/types/geocoordinates)                                                                                                 | <p>The geo coordinates of the Place.</p><p><br>Example</p><p><code>"geo": {</code><br>  <code>"latitude": 51.4034423828125,</code><br>  <code>"longitude": -0.2369088977575302,</code><br>  <code>"@type": "GeoCoordinates"</code><br><code>}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                    |

### **Recommended properties**

| Property                  | Expected Type                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| @id                       | [`URL`](https://schema.org/URL)                                                                                          | <p>A unique URI-based identifier for the record.</p><p><code>@id</code> properties are used as identifiers for compatibility with JSON-LD. The value of such a property must always be an absolute URI that provides a stable globally unique identifier for the resource, as described in <a href="https://tools.ietf.org/html/rfc3986">RFC3986</a>.</p><p>The primary purpose of the URI format in this context is to provide natural namespacing for the identifier. Hence, the URI itself may not resolve to a valid endpoint, but must use a domain name controlled by the resource owner (the organisation responsible for the OpenActive open data feed).</p><p><br>Example</p><p><code>"@id": "<https://id.bookingsystem.example.com/places/12345>"</code></p>                                                                                                                                                                                                                                                                                                                                           |
| amenityFeature            | Array of [`LocationFeatureSpecification`](https://developer.openactive.io/data-model/types/locationfeaturespecification) | <p>An array listing the Amenities of the Place.</p><p><br>Example</p><p><code>"amenityFeature": \[</code><br>  <code>{</code><br>    <code>"name": "Changing Facilities",</code><br>    <code>"value": true,</code><br>    <code>"@type": "ChangingFacilities"</code><br>  <code>},</code><br>  <code>{</code><br>    <code>"name": "Showers",</code><br>    <code>"value": false,</code><br>    <code>"@type": "Showers"</code><br>  <code>},</code><br>  <code>{</code><br>    <code>"name": "Lockers",</code><br>    <code>"value": true,</code><br>    <code>"@type": "Lockers"</code><br>  <code>},</code><br>  <code>{</code><br>    <code>"name": "Towels",</code><br>    <code>"value": false,</code><br>    <code>"@type": "Towels"</code><br>  <code>},</code><br>  <code>{</code><br>    <code>"name": "Creche",</code><br>    <code>"value": false,</code><br>    <code>"@type": "Creche"</code><br>  <code>},</code><br>  <code>{</code><br>    <code>"name": "Parking",</code><br>    <code>"value": true,</code><br>    <code>"@type": "Parking"</code><br>  <code>}</code><br><code>]</code></p> |
| description               | [`Text`](https://schema.org/Text)                                                                                        | <p>A plain text description of the Place, which must not include HTML or other markup.</p><p><br>Example</p><p><code>"description": "Raynes Park High School in London"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| image                     | Array of [`ImageObject`](https://developer.openactive.io/data-model/types/imageobject)                                   | <p>An image or photo that depicts the place, e.g. a photo taken at a previous event.</p><p><br>Example</p><p><code>"image": \[</code><br>  <code>{</code><br>    <code>"thumbnail": "<http://example.com/static/image/speedball_thumbnail.jpg>",</code><br>    <code>"@type": "ImageObject",</code><br>    <code>"url": "<http://example.com/static/image/speedball_large.jpg>"</code><br>  <code>}</code><br><code>]</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| openingHoursSpecification | Array of [`OpeningHoursSpecification`](https://developer.openactive.io/data-model/types/openinghoursspecification)       | The times the Place is open                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| telephone                 | [`Text`](https://schema.org/Text)                                                                                        | <p>The telephone number for the Place</p><p><br>Example</p><p><code>"telephone": "01253 473934"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| url                       | [`URL`](https://schema.org/URL)                                                                                          | <p>The website for the Place</p><p><br>Example</p><p><code>"url": "<http://www.rphs.org.uk/>"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

### **Optional properties**

| Property                         | Expected Type                                                                                                                                                                                                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| containedInPlace                 | <p><a href="https://developer.openactive.io/data-model/types/place"><code>Place</code></a><br>- or -<br><code>@id</code> reference</p>                                                                                                                                                                                                                                                       | <p>The place within which this Place exists</p><p><br>Example</p><p><code>"containedInPlace": {</code><br>  <code>"@type": "Place",</code><br>  <code>"url": "<https://www.everyoneactive.com/centres/Middlesbrough-Sports-Village>",</code><br>  <code>"name": "Middlesbrough Sports Village"</code><br><code>}</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| containsPlace                    | Array of [`Place`](https://developer.openactive.io/data-model/types/place)                                                                                                                                                                                                                                                                                                                   | <p>A specific identifiable facility (<code>SportsActivityLocation</code>) or place (<code>Place</code>) that exist within this place</p><p><br>Example</p><p><code>"containsPlace": \[</code><br>  <code>{</code><br>    <code>"@type": "SportsActivityLocation",</code><br>    <code>"@id": "<https://api.example.com/places/1402CBP20150217/sports-activity-locations/3>",</code><br>    <code>"url": "<https://www.better.org.uk/leisure-centre/manchester/belle-vue-sports-village/facilities>",</code><br>    <code>"name": "Studio",</code><br>    <code>"description": "We have a great range of Fitness Classes at Belle Vue Leisure Centre including Group Cycle, Zumba, Pilates and much much more.",</code><br>    <code>"image": \[</code><br>      <code>{</code><br>        <code>"@type": "ImageObject",</code><br>        <code>"url": "<https://res-1.cloudinary.com/gll/image/upload/c_fit,f_auto,h_169,w_384/v1592158966/production/0065/7/66/PHOTO-2020-06-09-14-25-53_3.jpg>"</code><br>      <code>}</code><br>    <code>],</code><br>    <code>"specialOpeningHoursSpecification": \[</code><br>      <code>{</code><br>        <code>"@type": "OpeningHoursSpecification",</code><br>        <code>"opens": "00:00",</code><br>        <code>"closes": "00:00",</code><br>        <code>"validFrom": "2022-01-01",</code><br>        <code>"validThrough": "2022-12-31"</code><br>      <code>}</code><br>    <code>]</code><br>  <code>}</code><br><code>]</code></p> |
| email                            | [`Text`](https://schema.org/Text)                                                                                                                                                                                                                                                                                                                                                            | <p>General enquiries e-mail address for the Place.</p><p><br>Example</p><p><code>"email": "<info@example.com>"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| identifier                       | <p><a href="https://schema.org/Text"><code>Text</code></a><br>- or -<br><a href="https://developer.openactive.io/data-model/types/propertyvalue"><code>PropertyValue</code></a><br>- or -<br>Array of <a href="https://developer.openactive.io/data-model/types/propertyvalue"><code>PropertyValue</code></a><br>- or -<br><a href="https://schema.org/Integer"><code>Integer</code></a></p> | <p>A local non-URI identifier for the resource</p><p><br>Example</p><p><code>"identifier": "SB1234"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| specialOpeningHoursSpecification | Array of [`OpeningHoursSpecification`](https://developer.openactive.io/data-model/types/openinghoursspecification)                                                                                                                                                                                                                                                                           | Explicitly override general opening hours brought in scope by `schema:openingHoursSpecification`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

### **Beta Extension properties**

These properties are defined in the [OpenActive Beta Extension](https://openactive.io/ns-beta). The OpenActive Beta Extension is defined as a convenience to help document properties that are in active testing and review by the community. Publishers should not assume that properties in the beta namespace will either be added to the core specification or be included in the namespace over the long term.

| Property                  | Expected Type                                                     | Description                                                                                                                                                                                                                                                                                            |
| ------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| beta:formattedDescription | [`Text`](https://schema.org/Text)                                 | <p><a href="https://github.com/openactive/modelling-opportunity-data/issues/276">Proposal #276</a></p><p>Sometimes a description is stored with formatting (e.g. href, bold, italics, embedded YouTube videos). This formatting can be useful for data consumers. This property must contain HTML.</p> |
| beta:placeType            | Array of [`Concept`](http://www.w3.org/2004/02/skos/core#Concept) | <p><a href="https://github.com/openactive/place-types/issues/1">Proposal #1</a></p><p>The type of Place. See <a href="https://openactive.io/place-types/"><https://openactive.io/place-types/></a>.</p>                                                                                                |
| beta:serviceOperator      | [`Organization`](https://schema.org/Organization)                 | <p><a href="https://github.com/openactive/modelling-opportunity-data/issues/307">Proposal #307</a></p><p>The organization responsible for the operation of the <code>Place</code>.</p>                                                                                                                 |
| beta:video                | Array of [`VideoObject`](https://schema.org/VideoObject)          | <p><a href="https://github.com/openactive/modelling-opportunity-data/issues/88">Proposal #88</a></p><p>A related video object.</p>                                                                                                                                                                     |

Except as otherwise noted, the content of this page is licensed under the [Creative Commons Attribution License (CC-BY V4.0)](https://creativecommons.org/licenses/by/4.0/), and code samples are licensed under the [MIT License](https://opensource.org/licenses/MIT), for anyone to access, use and share; using attribution "[OpenActive](https://www.openactive.io/)".