https://github.com/openactive/facility-attribute-list
Facility Attribute List controlled vocabularies data and documentation
https://github.com/openactive/facility-attribute-list
Last synced: 5 months ago
JSON representation
Facility Attribute List controlled vocabularies data and documentation
- Host: GitHub
- URL: https://github.com/openactive/facility-attribute-list
- Owner: openactive
- Created: 2022-01-30T18:39:16.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T14:52:09.000Z (over 1 year ago)
- Last Synced: 2025-02-08T07:08:33.435Z (over 1 year ago)
- Size: 12.7 KB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Facility Attribute List
> Status: Draft | [Please Provide Feedback via GitHub](https://github.com/openactive/facility-attribute-list/issues)
## Status
This list is in a draft state, however every effort will be made in subsequent revisions to maintain the IDs associated with the concepts enumerated here.
## Documentation
This repository holds the [JSON-LD definition](https://openactive.io/facility-attribute-list/facility-attribute-list.jsonld) of the OpenActive Facility Attribute List controlled vocabulary.
This controlled vocabulary MUST be referenced within a `Concept` via `inScheme` using the URL `"https://openactive.io/facility-attribute-list"` (which will return the [JSON-LD definition](https://openactive.io/facility-attribute-list/facility-attribute-list.jsonld) if the `Accept` header contains `application/ld+json`).
This controlled vocabulary SHOULD be retrieved frequently using an HTTP GET and cached within an application, to ensure that the most up-to-date version is displayed to the user, while also protecting against network failure when accessing the underlying resource. To access this controlled vocabulary the application MUST GET the URL `"https://openactive.io/facility-attribute-list/facility-attribute-list.jsonld"` (note there is no www in the URL) which does not require a specific `Accept` header, and is cached via CDN. The controlled vocabulary is also available via a GET of the URL `"https://openactive.io/facility-attribute-list"` using an `Accept` header of `application/ld+json`, for completeness, however this shorter URL MUST NOT be used in production.
Please raise requests for content or issues related to this controlled vocabulary via [GitHub](https://github.com/openactive/facility-attribute-list/issues).
## Example use
The example below illustrates an `"beta:facilityAttribute"` property for an `FacilityUse` that has the attribute "Concrete".
```json
"beta:facilityAttribute": [
{
"@type": "Concept",
"@id": "https://openactive.io/facility-attribute-list#8c4ba90c-2ceb-4a38-aeba-1875da03c227",
"prefLabel": "Concrete",
"inScheme": "https://openactive.io/facility-attribute-list"
}
]
```
## Source data
Please see the [spreadsheet](https://docs.google.com/spreadsheets/d/11jT9e2fzmIXHPrxm6zsnjWWUT2q8_Op5ZkRDmi1nYAw/edit) used to generate the JSON-LD representation, comments welcome!
## Licence
The documentation and data in this repository is published under the [Creative Commons CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/) license.