Abstract

The STR-AP (Short Term Rental Application Profile) is a data model that captures the concepts expressed in the current proposed Regulation on short-term accommodation rental services.

Introduction

On 7 November 2022, the Commission submitted to the European Parliament and to the Council a proposal for a Regulation on data collection and sharing relating to short-term accommodation rental services and amending Regulation (EU) 2018/1724, accompanied by an impact assessment.

The proposal seeks to harmonise and streamline the framework for data generation and data sharing on short-term accommodation rental services across the EU.

More specifically, the proposal seeks to establish:

This Regulation is without prejudice to the rules laid down by other Union legal acts regulating other aspects of the provision of services by online short-term rental platforms and the provision of short-term accommodation rental services, in particular:

This Application Profile specifies a semantic data model and it consists of terms with their constraints.

The specification is based on the [[ISA2]] [[SEMIC]] Core Vocabularies and Application Profiles, in particular:

Status

This Application Profile has the status Working Draft published at 2024-02-28.

Information about the process and the decisions involved in the creation of this specification are consultable at the Changelog.

License

Copyright © 2024 European Union. All material in this repository is published under the license CC-BY 4.0, unless explicitly otherwise mentioned.

Terminology

An Application Profile is a data specification aimed to facilitate the data exchange in a well-defined application context. It re-uses concepts from one or more semantic data specifications, while adding more specificity, by identifying mandatory, recommended, and optional elements, addressing particular application needs, and providing recommendations for controlled vocabularies to be used. More information can be found on the SEMIC Style Guide.

This specification uses the following prefixes to shorten the URIs for readibility.
PrefixNamespace IRI
admshttp://www.w3.org/ns/adms#
cpsvhttp://purl.org/vocab/cpsv#
cvhttp://data.europa.eu/m8g/
dcathttp://www.w3.org/ns/dcat#
dcthttp://purl.org/dc/terms/
foafhttp://xmlns.com/foaf/0.1/
legalhttp://www.w3.org/ns/legal#
locnhttp://www.w3.org/ns/locn#
orghttp://www.w3.org/ns/org#
personhttp://www.w3.org/ns/person#
rdfhttp://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfshttp://www.w3.org/2000/01/rdf-schema#
schemahttps://schema.org/
skoshttp://www.w3.org/2004/02/skos/core#
strhttps://w3id.org/str/
timehttp://www.w3.org/2006/time#
xsdhttp://www.w3.org/2001/XMLSchema#

Overview

This document describes the usage of the following main entities for a correct usage of the Core Vocabulary:
| Activity Data | Evidence | Legal Entity | Online Short Term Rental Platform | Order | Person | Public Organisation | Registration Number | Registration Procedure | Short Term Accomodation Rental Service | Single Digital Entry Point | Unit |

The main entities are supported by:
| Address | Catalogue | Catalogue Record | Catalogued Resource | Concept | Contact Point | Coordination Group | Cost | Data Service | Dataset | Distribution | Document | Geometry | Group | Identifier | Literal | Location | Output | Period of time | Public Registry Service |

And supported by these datatypes:
| Boolean | DateTime | Double | Integer | langString | String | Temporal Literal | Time instant | URL |

Main Entities

The main entities are those that form the core of the Core Vocabulary.

Activity Data

Definition
The number of nights for which a unit is rented and the number of guests that the unit was rented to per night, and their country of residence, in accordance with Regulation (EU) 692/2011.
Properties
For this entity the following properties are defined: country of the guests , is about , number of guests , temporal .
Property Range Card Definition Usage Use Case
[o] country of the guests Concept 1..* The country of residence of the guests. The recommended values are those from the Country authority table of the Publications Office. UC 6
[o] is about Unit 1 The Unit associated to the activity data. UC 6
[o] number of guests Integer 1 The number of guest that the unit was rented to per night. UC 6
[o] temporal Period of time 1 It indicates the period of time associated. UC 6

Evidence

Definition
Proof that a Requirement is met.
Usage Note
Evidence can be any resource - document, artefact - anything needed for executing the Public Service. In the context of Public Services, Evidence is usually administrative documents or completed application forms. A specific Public Service may require the presence of certain Evidence or combinations of Evidence in order to be delivered. In some cases, the Output of one service will be Evidence for another service. Such relationships should be described in the associated Rule(s).
Properties
For this entity the following properties are defined: describes , identifier , name , related documentation , submission date , update date , validity period .
Property Range Card Definition Usage Use Case
[o] describes Unit 0..1 It indicates the Unit described. UC 1
[o] identifier Literal 1 An Identifier for the piece of Evidence. UC 1
[o] name langString 1..* The official Name of the piece of Evidence. UC 1
[o] related documentation Document 0..* The documentation that contains information. For instance, a particular template for an administrative document, an application or a guide on formatting the Evidence. UC 1
[o] submission date DateTime 1 The date in which the Document has been submitted. UC 1
[o] update date DateTime 0..1 The date in which the Document has been updated. UC 1
[o] validity period Period of time 0..1 Period of Time during which the Evidence holds true or has force. UC 1

Legal Entity

Definition
A self-employed person, company, or organization that has legal rights and obligations.
Usage Note
A Legal Entity able to transact business, typically registered with a body able to confer legal status such as a national business register. It is able to trade, is legally liable for its actions, accounts, tax affairs etc. This makes Legal Entities distinct from the concept of organisations or groups. Many organisations exist that are not Legal Entities, yet to the outside world they have staff, hierarchies, locations etc. Other organisations exist that are an umbrella for several Legal Entities (universities are often good examples of this). In STR, a legal person acting as a "host", that provides, or intends to provide, on a professional or non-professional basis, on a regular or on a temporary basis, a short-term accommodation rental service provided for remuneration through an online short-term rental platform.
Properties
For this entity the following properties are defined: has legal representative , is notified by , is referred in , legal identifier , legal name , offers , provides , registered address .
Property Range Card Definition Usage Use Case
[o] has legal representative Person 1..* It indicates the Person that can represent legally an organization. UC 1
[o] is notified by Public Organisation 0..* It indicates the competent auhority notifying.
[o] is referred in Order 0..* It indicates the Order in which the host is referred. UC 5
[o] legal identifier Identifier 1 The unambiguous structured reference assigned to the Legal Entity by the legal authority that registered it. UC 1
[o] legal name langString 1..* The name under which the Legal Entity is legally registered. The legal name is different from the alternative (trade) name which is a pseudonym used by companies that do not operate under their registered company name. A business might have more than one legal name, particularly in countries with more than one official language. In such cases, and where the encoding technology allows, the language of the string should be identified. UC 1
[o] offers Short Term Accomodation Rental Service 0..* It indicates the rental service offered. UC 4
[o] provides Evidence 0..* It indicates the Evidence provided. UC 1
[o] registered address Address 1 The address at which the Legal Entity is legally registered. UC 1

Online Short Term Rental Platform

Definition
An online platform within the meaning of Article 3, point (i), of Regulation (EU) 2022/2065, that allows guests to conclude distance contracts with hosts for the provision of short-term accommodation rental services.
Properties
For this entity the following properties are defined: checks , identifier , provides information to , publishes , requests area , type .
Property Range Card Definition Usage Use Case
[o] checks Single Digital Entry Point 0..* It indicates the Single Digital Entry Point being checked.
[o] identifier Literal 1 An Identifier for the OnlineShortTermRentalPlatform
[o] provides information to Single Digital Entry Point 0..* It indicates the Single Digital Entry Point receiving information.
[o] publishes Dataset 1..* It indicates the Dataset of listings published.
[o] requests area Geometry 0..* The area requested by the Online Short Term Rental Platform. UC 3
[o] type Concept 1 The type of an Online Short Term Rental Platform. Values can take small, micro or medium.

Order

Definition
A decision issued by a court or authoritative body.
Properties
For this entity the following properties are defined: concerns , has listing , identifier , reason , sent to .
Property Range Card Definition Usage Use Case
[o] concerns Registration Number 1 It indicated the Registration Number concerned. UC 5
[o] has listing Unit 1 The reference to a unit offered for short-term accommodation rental services and published on an online short-term rental platform’s website. UC 5
[o] identifier Literal 1 An Identifier for the Order. UC 5
[o] reason langString 1 The statement indicating the reason of the Order. UC 5
[o] sent to Online Short Term Rental Platform 1 It indicates the receiver of the Order. UC 5

Person

Definition
A individual human being who may be dead or alive,but not imaginary.
Usage Note
In STR, a natural person acting as a "host", that provides, or intends to provide, on a professional or non-professional basis, on a regular or on a temporary basis, a short-term accommodation rental service provided for remuneration through an online short-term rental platform. It can also be a person appointed as national coordinator for a Single Digital Entry Point.
Properties
For this entity the following properties are defined: contact point , domicile , family name , given name , identifier , is notified by , is point of contact for , is referred in , offers , provides .
Property Range Card Definition Usage Use Case
[o] contact point Contact Point 1..* The main contact information of the resource. UC 1
[o] domicile Address 1..* The place that the Person treats as permanent home. UC 1
[o] family name langString 1 The hereditary surname of a family. Usually referring to a group of people related by blood, marriage or adoption. This attribute also carries prefixes or suffixes which are part of the family name, e.g. "de Boer", "van de Putte", "von und zu Orlow". Multiple family names, such as are commonly found in Hispanic countries, are recorded in the single family name property so that, for example, Miguel de Cervantes Saavedra's family name would be recorded as "de Cervantes Saavedra". UC 1
[o] given name langString 1 The name(s) that identify the Person within a family with a common surname. Usually a first name. Given to a person by his or her parents at birth or legally recognised as 'given names' through a formal process. All given names are ordered in one property so that, for example, the given name for Johann Sebastian Bach is "Johann Sebastian". UC 1
[o] identifier Identifier 1 The unambiguous structured reference to the Person. Examples include a national identification number, a student ID, national fiscal number, etc. We also refer to the eIDAS regulation on "electronic identification and trust services" and its mapping to the Core Person Vocabulary. UC 1
[o] is notified by Public Organisation 0..* It indicates the competent auhority notifying.
[o] is point of contact for Single Digital Entry Point 0..1 The Single Digital Entry point for which the person acts as contact point for all matters related.
[o] is referred in Order 0..* It indicates the Order in which the host is referred. UC 5
[o] offers Short Term Accomodation Rental Service 0..* It indicates the rental service offered. UC 4
[o] provides Evidence 0..* It indicates the Evidence provided. UC 1

Public Organisation

Definition
An Organization that is defined as being part of the public sector by a legal framework at any level.
Usage Note
Organizations which exist to provide services for its citizens and companies are called Public Organizations. The Public Organization class represents the organization. One organization may comprise several sub-organizations and any organization may have one or more organizational units. Each of these is described using the same properties and relationships.

This definition is consistent with the more detailed definition of a "public sector body" as given in the PSI Directive: "the State, regional or local authorities, bodies governed by public law and associations formed by one or several such authorities or one or several such bodies governed by public law". It further defines a body governed by public law as any body "(a) established for the specific purpose of meeting needs in the general interest, not having an industrial or commercial character; and (b) having legal personality; and (c) financed, for the most part by the State, or regional or local authorities, or other bodies governed by public law; or subject to management supervision by those bodies; or having an administrative, managerial or supervisory board, more than half of whose members are appointed by the State, regional or local authorities or by other bodies governed by public law".
Properties
For this entity the following properties are defined: address , alternative label , classification , description , establishes , has national coordinator , issues , preferred label , purpose , verifies .
Property Range Card Definition Usage Use Case
[o] address Address 1 The Address of a Public Organization.
[o] alternative label langString 0..* An alternative or informal name(s) of a Public Organization, irrespective of language.
[o] classification Concept 0..* The categorisation of the Public Organization. As an example, the Publications Office of the European Union provides a Named Authority list of Organization Types which is appropriate for European institutions. Other classification schemes should be used at other levels of Public Organization.
[o] description langString 0..* The textual description of the Public Organization.
[o] establishes Single Digital Entry Point 0..1 It indicates the Single Digital Entry Point being managed.
[o] has national coordinator Person 0..1 It indicates the Person appointed as national coordinator.
[o] issues Order 0..* It indicates ther Order issued.
[o] preferred label langString 1..* A preferred label is used to provide the primary, legally recognised name of the Public Organization, as defined in the ORG Ontology. Refers to the official or legal name of a Public Organization. An organization may only have one such name in any given language. Primary names may be provided in multiple languages with multiple instances of the preferred label property.
[o] purpose Concept 0..* This property describes the reasons of existence of an Organization. The ORG ontology suggests that this property can also be thought of as meaning 'remit' or 'responsibility.' Ideally this will link to a COFOG code but where this isn't possible or appropriate, other controlled vocabularies may be used.
[o] verifies Evidence 0..* It indicates the Evidence verified.

Registration Number

Definition
A unique identifier issued by the competent authority which identifies a unit in that Member State.
Subclass of
Output
Properties
For this entity the following properties are defined: identifies , issue date , status , temporal .
Property Range Card Definition Usage Use Case
[o] identifies Unit 1 The Unit identified by the Registration Number. UC 1, UC 2, UC 4
[o] issue date DateTime 1 Date of formal issuance of the resource. UC 1, UC 2, UC 4
[o] status Concept 1 The status of the Asset in the context of a particular workflow process. A registration number can be valid, suspended or withdrawn. UC 1, UC 2, UC 4
[o] temporal Period of time 0..1 It indicates the period of time associated. UC 1

Registration Procedure

Definition
Any procedure by which hosts must provide specific information and documentation to the competent authorities in order to obtain a registration number enabling them to offer short-term accommodation rental services through online short-term rental platforms
Subclass of
Public Registry Service
Properties
For this entity the following properties are defined: applies to , has cost .
Property Range Card Definition Usage Use Case
[o] applies to Geometry 1 The area in which the registration procedure applies. UC 3
[o] has cost Cost 0..* It indicates the costs related to the execution of a Public Service for the citizen or business related to the execution of the particular Public Service. UC 1

Short Term Accomodation Rental Service

Definition
The short-term letting of a unit, provided for remuneration, whether on a professional or non-professional basis, on a regular or on a temporary basis, as further defined by national law.
Properties
For this entity the following properties are defined: provides access to .
Property Range Card Definition Usage Use Case
[o] provides access to Online Short Term Rental Platform 1..* It indicates the Online Short Term Rental Platform being accessed by the service.

Single Digital Entry Point

Definition
A gateway for the electronic transmission of data between online short-term rental platforms and competent authorities, ensuring timely, reliable and efficient data sharing processes
Properties
This specification does not impose any additional requirements to properties for this entity.

Unit

Definition
A furnished accommodation located in the Union that is the subject of the provision of a short-term accommodation rental service.
Usage Note
It does not include the following:
  • (a) hotels and similar accommodation including resort hotels, suite or apartment hotels ¦and motels as described in NACE Rev. 2, group 55.1 ('hotels and similar accommodation') and hostels as described in NACE Rev. 2, group 55.2 ('holiday and other short-stay accommodation') of Annex I to Regulation (EC) No 1893/2006 of the European Parliament and of the Council24;
  • (b) the provision of accommodation in camping grounds, recreational vehicle parks and trailer parks, as described in NACE Rev. 2 group 55.3 of Annex I to Regulation 1893/2006.
Properties
For this entity the following properties are defined: description , floor level , has authorization , has unit address , is authorization obtained , is offered on , is subject to authorization , number of bedrooms , occupancy , purpose , type , url .
Property Range Card Definition Usage Use Case
[o] description langString 0..1 An account of the resource. A textual description of the Unit. UC 1, UC 2, UC 4
[o] floor level langString 0..1 The level of the floor of the Unit as textual description. UC 1, UC 2, UC 4
[o] has authorization Document 0..1 It indicated the document attesting the authorization. UC 1, UC 2, UC 4
[o] has unit address Address 1 The specific address of the Unit. UC 1, UC 2, UC 4
[o] is authorization obtained Boolean 0..1 it indicates whether the host has obtained an authorisation for the Unit. UC 1, UC 2, UC 4
[o] is offered on Online Short Term Rental Platform 0..1 The Online Short Term Rental Platform where the Unit is declared. UC 2
[o] is subject to authorization Boolean 0..1 It indicates whether the Unit is subject to authorization. UC 1, UC 2, UC 4
[o] number of bedrooms Integer 1 The maximum number of available bed places. UC 1, UC 2, UC 4
[o] occupancy Integer 1 The maximum number of guests that the unit accommodates. UC 1, UC 2, UC 4
[o] purpose langString 1 It indicates whether the unit is offered as a part or whole of the host's primary or secondary residence, or for other purposes. UC 1, UC 2, UC 4
[o] type Concept 1 A classification of the unit. UC 1, UC 2, UC 4
[o] url URL 0..1 URL of the item. UC 4

Supportive Entities

The supportive entities are supporting the main entities in the Core Vocabulary. They are included in the Core Vocabulary because they form the range of properties.

Address

Definition
A spatial object that in a human-readable way identifies a fixed location.
Usage Note
An "address representation" as conceptually defined by the INSPIRE Address Representation data type: "Representation of an address spatial object for use in external application schemas that need to include the basic, address information in a readable way.".

The representation of Addresses varies widely from one country's postal system to another. Even within countries, there are almost always examples of Addresses that do not conform to the stated national standard. However, ISO 19160-1 provides a method through which different Addresses can be converted from one conceptual model to another.

This specification was heavily based on the INSPIRE Address Representation data type. It is noteworthy that if an Address is provided using the detailed breakdown suggested by the properties for this class, then it will be INSPIRE-conformant. To this very granular set of properties, we add two further properties:

- full address (the complete address as a formatted string)
- addressID (a unique identifier for the address). The first of these allows publishers to simply provide the complete Address as one string, with or without formatting. This is analogous to vCard's label property.

The addressID is part of the INSPIRE guidelines and provides a hook that can be used to link the Address to an alternative representation, such as vCard or OASIS xAL.

This class belongs to Core Location Vocabulary
Properties
For this entity the following properties are defined: address area , address ID , administrative unit level 1 , administrative unit level 2 , full address , land register , locator designator , locator name , post code , post name , post office box , thoroughfare .
Property Range Card Definition Usage Use Case
[o] address area langString 0..1 The name of a geographic area that groups Addresses. This would typically be part of a city, a neighbourhood or village, e.g. Montmartre. Address area is not an administrative unit.
[o] address ID Literal 0..1 A globally unique identifier for each instance of an Address. The concept of adding a globally unique identifier for each instance of an address is a crucial part of the INSPIRE data spec. A number of EU countries have already implemented an ID (a UUID) in their Address Register/gazetteer, among them Denmark. OASIS xAL also includes an address identifier. It is the address Identifier that allows an address to be represented in a format other than INSPIRE whilst remaining conformant to the Core Vocabulary.

The INSPIRE method of representing addresses is very detailed, designed primarily for use in databases of addresses. Whilst data that is published in full conformance with the INSPIRE data structure can be made available using the Core Location Vocabulary the reverse is not true since the Core Vocabulary allows much greater flexibility.

Many datasets that include address data as one piece of information about something else are likely to have that data in simpler formats. These might be tailored to the specific need of the dataset, follow a national norm, or make use of a standard like vCard.

To provide maximum flexibility in the Core Vocabulary, whilst remaining interoperable with INSPIRE Address Guidelines (which EU Member States are obliged to use), the Core Location Vocabulary provides the extra property of full address and makes use of INSPIRE's addressID.

The datatype of addressID is indicated as Literal (keeping backward compatibility with the old W3C specification) that can be typed differently, see more.
[o] administrative unit level 1 langString 0..1 The name of the uppermost level of the address, almost always a country. Best practice is to use the ISO 3166-1 code but if this is inappropriate for the context, country names should be provided in a consistent manner to reduce ambiguity. For example, either write 'France' or 'FRA' consistently throughout the dataset and avoid mixing the two. The Country controlled vocabulary from the Publications Office can be reused for this.
[o] administrative unit level 2 langString 0..1 The name of a secondary level/region of the address, usually a county, state or other such area that typically encompasses several localities. Values could be a region or province, more granular than level 1.
[o] full address langString 0..1 The complete address written as a string. Use of this property is recommended as it will not suffer any misunderstandings that might arise through the breaking up of an address into its component parts. This property is analogous to vCard's label property but with two important differences: (1) formatting is not assumed so that, unlike vCard label, it may not be suitable to print this on an address label, (2) vCard's label property has a domain of vCard Address; the fullAddress property has no such restriction. An example of a full address is "Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France".
[o] land register Dataset 0..1 The land register in which the Address is registered in.
[o] locator designator Literal 0..1 A number or sequence of characters that uniquely identifies the locator within the relevant scope. In simpler terms, this is the building number, apartment number, etc. For an address such as "Flat 3, 17 Bridge Street", the locator is "flat 3, 17".

The datatype of locatorDesignator is indicated as Literal (keeping backward compatibility with the old W3C specification) that can be typed differently, see more.
[o] locator name langString 0..1 Proper noun(s) applied to the real world entity identified by the locator. The locator name could be the name of the property or complex, of the building or part of the building, or it could be the name of a room inside a building.

The key difference between a locator and a locator name is that the latter is a proper name and is unlikely to include digits. For example, "Shumann, Berlaymont" is a meeting room within the European Commission headquarters for which locator name is more appropriate than locator.
[o] post code Literal 0..1 The code created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points. Post codes are common elements in many countries' postal address systems. One of the many post codes of Paris is for example "75000". The datatype of addressID is indicated as Literal (keeping backward compatibility with the old W3C specification) that can be typed differently, see more.
[o] post name langString 0..1 A name created and maintained for postal purposes to identify a subdivision of addresses and postal delivery points. Usually a city, for example "Paris".
[o] post office box Literal 0..1 A location designator for a postal delivery point at a post office, usually a number. INSPIRE's name for this is "postalDeliveryIdentifier" for which it uses the locator designator property with a type attribute of that name. This vocabulary separates out the Post Office Box for greater independence of technology. An example post office box number is "9383".

The datatype of poBox is indicated as Literal (keeping backward compatibility with the old W3C specification) that can be typed differently, see more.
[o] thoroughfare langString 0..1 The name of a passage or way through from one location to another. A thoroughfare is usually a street, but it might be a waterway or some other feature. For example, "Avenue des Champs-Élysées".

Catalogue

Definition
A catalogue or repository that hosts the Datasets or Data Services being described.
Reference in DCAT
Link
Properties
For this entity the following properties are defined: dataset , record , service .
Property Range Card Definition Usage Use Case
[o] dataset Dataset 0..* A Dataset that is part of the Catalogue. As empty Catalogues are usually indications of problems, this property should be combined with the next property service to implement an empty Catalogue check.
[o] record Catalogue Record 0..* A Catalogue Record that is part of the Catalogue.
[o] service Data Service 0..* A site or end-point (Data Service) that is listed in the Catalogue. As empty Catalogues are usually indications of problems, this property should be combined with the previous property dataset to implement an empty Catalogue check.

Catalogue Record

Definition
A description of a Dataset's entry in the Catalogue.
Reference in DCAT
Link
Properties
For this entity the following properties are defined: primary topic .
Property Range Card Definition Usage Use Case
[o] primary topic Catalogued Resource 1 A link to the Dataset, Data service or Catalog described in the record. A catalogue record will refer to one entity in a catalogue. This can be either a Dataset or a Data Service. To ensure an unambigous reading of the cardinality the range is set to Catalogued Resource. However it is not the intend with this range to require the explicit use of the class Catalogued Record. As abstract class, an subclass should be used.

Catalogued Resource

Definition
Resource published or curated by a single agent.
Reference in DCAT
Link
Usage Note
For DCAT-AP, the class is considered an abstract notion.
Properties
This specification does not impose any additional requirements to properties for this entity.

Concept

Definition
A concept can be viewed as an idea or notion; a unit of thought. However, what constitutes a unit of thought is subjective, and this definition is meant to be suggestive, rather than restrictive.
Properties
This specification does not impose any additional requirements to properties for this entity.

Contact Point

Definition
Information (e.g. e-mail address,telephone number) of a person or department through which the user can get in touch with.
Usage Note
The Core Public Organization Vocabulary defines properties for telephone number, e-mail address and opening hours although it is noteworthy that the class is based on schema.org's ContactPoint class that has additional properties that some implementations may find useful.
Properties
For this entity the following properties are defined: has email , has telephone .
Property Range Card Definition Usage Use Case
[o] has email Literal 1 An electronic address through which the Contact Point can be contacted. UC 1
[o] has telephone Literal 1 A telephone number through which the Contact Point can be contacted. UC 1

Coordination Group

Definition
A group composed of the national coordinators of Single Digital Entry Point.
Subclass of
Group
Properties
For this entity the following properties are defined: member .
Property Range Card Definition Usage Use Case
[o] member Person 1..* Indicates a member of a Group.

Cost

Definition
The Cost class represents any costs related to the execution of a Public Service that the Agent consuming it needs to pay.
Properties
For this entity the following properties are defined: currency , has value , identifier .
Property Range Card Definition Usage Use Case
[o] currency Concept 1 The currency in which the Cost needs to be paid and the value of the Cost is expressed. UC 1
[o] has value Double 1 A numeric value indicating the amount of the Cost. UC 1
[o] identifier Literal 1 An Identifier for the Cost. UC 1

Data Service

Definition
A collection of operations that provides access to one or more datasets or data processing functions.
Reference in DCAT
Link
Subclass of
Catalogued Resource
Properties
For this entity the following properties are defined: serves dataset .
Property Range Card Definition Usage Use Case
[o] serves dataset Dataset 0..* This property refers to a collection of data that this data service can distribute.

Dataset

Definition
A conceptual entity that represents the information published.
Reference in DCAT
Link
Subclass of
Catalogued Resource
Properties
For this entity the following properties are defined: dataset distribution .
Property Range Card Definition Usage Use Case
[o] dataset distribution Distribution 0..* An available Distribution for the Dataset.

Distribution

Definition
A physical embodiment of the Dataset in a particular format.
Reference in DCAT
Link
Usage Note
Bulk downloads should be encoded as a Distribution.
Properties
For this entity the following properties are defined: access service , has listing .
Property Range Card Definition Usage Use Case
[o] access service Data Service 0..* A data service that gives access to the distribution of the dataset.
[o] has listing Unit 0..* The reference to a unit offered for short-term accommodation rental services and published on an online short-term rental platform’s website.

Document

Definition
A textual resource intended for human consumption that contains information, e.g. a web page about a Dataset.
Properties
This specification does not impose any additional requirements to properties for this entity.

Geometry

Definition
A shape or form of a Location.
Usage Note
This class defines the notion of "geometry" at the conceptual level, and it shall be encoded by using different formats (see usage note of the locn:geometry property). Can be a point, line or polygon, expressed using coordinates in some coordinate reference system.
Properties
For this entity the following properties are defined: coordinates , geometry type , latitude , longitude .
Property Range Card Definition Usage Use Case
[o] coordinates String 0..1 A list of geographic coordinates that define the extent of the Geometry. Can be expressed as longitude, latitude, elevation. UC 3
[o] geometry type Concept 1 The classification of the Geometry. Can be a point, line or polygon. UC 3
[o] latitude String 0..1 The geographic coordinate that specifies the north / south position of the Geomerty on the Earth's surface. UC 3
[o] longitude String 0..1 The geographic coordinate that specifies the east / west position of the Geometry on the Earth's surface. UC 3

Group

Definition
A class of Agents.
Properties
This specification does not impose any additional requirements to properties for this entity.

Identifier

Definition
A structured reference that identifies an entity.
Usage Note
The Identifier class is based on the UN/CEFACT class of the same name and is defined under the ADMS namespace.
Properties
For this entity the following properties are defined: notation .
Property Range Card Definition Usage Use Case
[o] notation Literal 1 A string of characters to uniquely identify a concept. UC 1

Literal

Definition
A literal value such as a string or integer; Literals may be typed, e.g. as a date according to xsd:date. Literals that contain human-readable text have an optional language tag as defined by BCP 4715.
Properties
This specification does not impose any additional requirements to properties for this entity.

Location

Definition
A spatial region or named place. It can be represented using a controlled vocabulary or with geographic coordinates. In the latter case, the use of the Core Location Vocabulary16 is recommended, following the approach described in the GeoDCAT-AP specification.
Reference in DCAT
Link
Properties
For this entity the following properties are defined: bbox , centroid , geometry .
Property Range Card Definition Usage Use Case
[o] bbox Literal 0..1 The geographic bounding box of a resource.
[o] centroid Literal 0..1 The geographic center (centroid) of a resource.
[o] geometry Geometry 0..1 The corresponding geometry for a resource

Output

Definition
An output can be any resource - document, artefact - anything produced by the Public Service. In the context of a Public Service, the output provides an official document or other artefact of the Competent Authority (Public Organization) that permits/authorises/entitles an Agent to (do) something.
Usage Note
In some cases, the Output of one Public Service will be used as evidence to fulfil a requirement of another Public Service. Such relationships should be described in the associated Rule(s)
Properties
For this entity the following properties are defined: identifier , name .
Property Range Card Definition Usage Use Case
[o] identifier Literal 1 An Identifier for the Output. UC 1
[o] name langString 1..* The official Name of the Output. UC 1

Period of time

Definition
An interval of time that is named or defined by its start and end dates.
Reference in DCAT
Link
Properties
For this entity the following properties are defined: beginning , end , end date , start date .
Property Range Card Definition Usage Use Case
[o] beginning Time instant 0..1 The beginning of a period or interval.
[o] end Time instant 0..1 The end of a period or interval
[o] end date Temporal Literal 0..1 The end of the period
[o] start date Temporal Literal 0..1 The start of the period

Public Registry Service

Definition
A Registry Service is a public service that creates, maintains and/or manages Base Registries or a Registry of Base Registries. This service, provided by public administrations, or by other organisations on their behalf, stores and provides basic information on authoritative data items such as people, companies, vehicles, licences, buildings, locations and roads.
Properties
For this entity the following properties are defined: description , has competent authority , has input , identifier , name , produces , produces .
Property Range Card Definition Usage Use Case
[o] description langString 1..* A free text Description of the Public Service.
[o] has competent authority Public Organisation 1 It links a Public Service to a Public Organization, which is the responsible Agent for the delivery of the Public Service.
[o] has input Evidence 0..* It links a Public Service to one or more instances of the Evidence class. In the case of STR, the Evidence is all information and documents provided by the host. UC 1
[o] identifier Literal 1 A formally-issued Identifier for the Public Service.
[o] name langString 1..* The official Name of the Public Service.
[o] produces Catalogued Resource 0..* This property defines the output of the service as a data resource available and managed by a Base Registry Service. The output must be also described as a dcat:Catalog, a dcat:Dataset or a dcat:DataService.
[o] produces Output 0..1 It links a Public Service to one or more instances of the Output class, describing the actual result of executing a given Public Service. Outputs can be any resource, for instance a document, artefact or anything else being produced as a result of executing the Public Service. UC 1

Datatypes

The following datatypes are used within this specification.
Class Definition
(create issue) Boolean has the value space required to support the mathematical concept of binary-valued logic: {true, false}
(create issue) Object with integer-valued year, month, day, hour and minute properties, a decimal-valued second property, and a boolean timezoned property.
(create issue) The double datatype is patterned after the IEEE double-precision 64-bit floating point type [IEEE 754-1985].
(create issue) integer is derived from decimal by fixing the value of fractionDigits to be 0 and disallowing the trailing decimal point. This results in the standard mathematical concept of the integer numbers.
(create issue) The class rdf:langString is the class of language-tagged string values. rdf:langString is an instance of rdfs:Datatype and a subclass of rdfs:Literal .
(create issue) The string datatype represents character strings in XML.
(create issue) rdfs:Literal encoded using the relevant ISO 8601 Date and Time compliant string and typed using the appropriate XML Schema datatype (xsd:gYear, xsd:gYearMonth, xsd:date, or xsd:dateTime).
(create issue) A temporal entity with zero extent or duration
(create issue)
URL
A uniform resource locator (URL), colloquially known as an address on the Web,[1] is a reference to a resource that specifies its location on a computer network and a mechanism for retrieving it.

Use cases

The below sequence diagram illustrates how the different entities interact between each other. The sequence diagram is then divided in use cases described below.

Use Case 1 - Host requests a registration number to the Competent Authority

Actors:

The use case is divided in the below steps:

Use Case 2 - Host provides a description of the unit to the STR Platform.

Actors:

The use case is divided in the below steps:

Use Case 3 - The STR Platform get a list of the area from the Competent Authority

Actors:

The use case is divided in the below steps:

Use Case 4 - The STR Platform publishes the new listing and provides it the to the Competent Authority

Actors:

The use case is divided in the below steps:

Use Case 5 - The STR Platform get a list of orders from the Single Digital Entry Point

Actors:

The use case is divided in the below steps:

Use Case 6 - The STR Platform provides activity data to the Competent Authority

Actors:

The use case is divided in the below steps:

Examples

The examples in this section are fictitious; their sole purpose is to illustrate the metadata.

Providing information about a unit

In the below example a natural person, acting as host, having its identifier, contact point and address, provides information about a unit.

Example 1 - Natural person provides information about a unit

Registration procedure issues Registration number

In the below example a registration procedure takes the information provided in the example before and issues a registration number.

The unit is then listed into Online Short Term Rental Platform so the host can provide the service.

Example 2 - Registration Procedure issues Registration Number

Usage Guidelines

Support for implementation

The following section provides support for implementing the STR Application Profile (STR-AP).

JSON-LD context file

One common technical question is the format in which the data is being exchanged. For conformance with the STR Application Profile (STR-AP), it is not mandatory that this happens in a RDF serialisation, but the exhanged format SHOULD be unambiguously be transformable into RDF. For the format JSON, a popular format to exchange data between systems, SEMIC provides a JSON-LD context file. JSON-LD is a W3C Recommendation [[[json-ld11]]] that provided a standard approach to interpret JSON structures as RDF. The provided JSON-LD context file can be used by implementers. This JSON-LD context is not normative, i.e. other JSON-LD contexts are allowed.

The JSON-LD context file downloadable here.

Validation

To verify if the data is (technically) conformant to the STR Application Profile (STR-AP), the exchanged data can be validated using the provided SHACL shapes. SHACL is a W3C Recommendation to express constraints on a RDF knowledge graph.

To support the check whether or not a catalogue satisfies the expressed constraints in this Core Vocabulary, the constraints in this specification are expressed using SHACL [[shacl]]. Each constraint in this specification that could be converted into a SHACL expression has been included. As such this collection of SHACL expressions that can be used to build a validation check for data.

It is up to the implementers to define the validation they expect. Each implementation happens within a context, and that context is beyond the SHACL expressions here.

The shapes can be found here.

Governance

Versioning governance

All specifications produced in SEMIC will follow the versioning rule described by the SEMIC Style Guide rule PC-R3. In case a SEMIC asset is deprecated the asset will remain available through its PURI.

The serialisation will have:

Governance requirements for re-used assets

In order to adhere to the SEMIC Style Guide rule GC-R2 a specification should have quality and governance standards for the assets that are being reused.

In order for an asset to be considered for reuse within a SEMIC specification it can be requested by a community member or it requires to adhere to the following requirements:

After being taken into consideration the asset will be validated in three steps:

Once considered and validated an asset can be adopted if it is approved by the community.

Lexicalisation rules

In order to adhere to the SEMIC Style Guide rule SC-R3 a specification requires formal lexicalisation rules. The Style Guide proposes two options either by using RDFS or SKOS lexicalisation.

SEMIC uses and will use the RDFS lexicalisation for all of its specifications. More specifically:

Quick Reference of Classes and Properties

This section provides a condensed tabular overview of the mentioned classes and properties in this specification. The properties are indicated as mandatory, recommended, optional and deprecated. These terms have the following meaning.
ClassClass IRIProperty TypePropertyProperty IRI
Activity Data
https://w3id.org/str/ActivityData
country of the guests
https://w3id.org/str/countryOfGuests
Activity Data
https://w3id.org/str/ActivityData
is about
https://w3id.org/str/isAbout
Activity Data
https://w3id.org/str/ActivityData
number of guests
https://w3id.org/str/numberOfGuests
Activity Data
https://w3id.org/str/ActivityData
temporal
http://purl.org/dc/terms/temporal
Address
http://www.w3.org/ns/locn#Address
address area
http://www.w3.org/ns/locn#addressArea
Address
http://www.w3.org/ns/locn#Address
address ID
http://www.w3.org/ns/locn#addressId
Address
http://www.w3.org/ns/locn#Address
administrative unit level 1
http://www.w3.org/ns/locn#adminUnitL1
Address
http://www.w3.org/ns/locn#Address
administrative unit level 2
http://www.w3.org/ns/locn#adminUnitL2
Address
http://www.w3.org/ns/locn#Address
full address
http://www.w3.org/ns/locn#fullAddress
Address
http://www.w3.org/ns/locn#Address
land register
https://w3id.org/str/landRegister
Address
http://www.w3.org/ns/locn#Address
locator designator
http://www.w3.org/ns/locn#locatorDesignator
Address
http://www.w3.org/ns/locn#Address
locator name
http://www.w3.org/ns/locn#locatorName
Address
http://www.w3.org/ns/locn#Address
post code
http://www.w3.org/ns/locn#postCode
Address
http://www.w3.org/ns/locn#Address
post name
http://www.w3.org/ns/locn#postName
Address
http://www.w3.org/ns/locn#Address
post office box
http://www.w3.org/ns/locn#poBox
Address
http://www.w3.org/ns/locn#Address
thoroughfare
http://www.w3.org/ns/locn#thoroughfare
Catalogue
http://www.w3.org/ns/dcat#Catalog
Recommended dataset
http://www.w3.org/ns/dcat#dataset
Catalogue
http://www.w3.org/ns/dcat#Catalog
Recommended service
http://www.w3.org/ns/dcat#service
Catalogue
http://www.w3.org/ns/dcat#Catalog
Optional record
http://www.w3.org/ns/dcat#record
Catalogue Record
http://www.w3.org/ns/dcat#CatalogRecord
Mandatory primary topic
http://xmlns.com/foaf/0.1/primaryTopic
Catalogued Resource
http://www.w3.org/ns/dcat#Resource
Concept
http://www.w3.org/2004/02/skos/core#Concept
Contact Point
http://data.europa.eu/m8g/ContactPoint
has email
http://data.europa.eu/m8g/email
Contact Point
http://data.europa.eu/m8g/ContactPoint
has telephone
http://data.europa.eu/m8g/telephone
Coordination Group
https://w3id.org/str/CoordinationGroup
member
http://xmlns.com/foaf/0.1/member
Cost
http://data.europa.eu/m8g/Cost
currency
http://data.europa.eu/m8g/currency
Cost
http://data.europa.eu/m8g/Cost
has value
http://data.europa.eu/m8g/hasValue
Cost
http://data.europa.eu/m8g/Cost
identifier
http://purl.org/dc/terms/identifier
Data Service
http://www.w3.org/ns/dcat#DataService
Recommended serves dataset
http://www.w3.org/ns/dcat#servesDataset
Dataset
http://www.w3.org/ns/dcat#Dataset
Recommended dataset distribution
http://www.w3.org/ns/dcat#distribution
Distribution
http://www.w3.org/ns/dcat#Distribution
Optional access service
http://www.w3.org/ns/dcat#accessService
Distribution
http://www.w3.org/ns/dcat#Distribution
has listing
https://w3id.org/str/hasListing
Document
http://xmlns.com/foaf/0.1/Document
Evidence
http://data.europa.eu/m8g/Evidence
describes
https://w3id.org/str/describes
Evidence
http://data.europa.eu/m8g/Evidence
identifier
http://purl.org/dc/terms/identifier
Evidence
http://data.europa.eu/m8g/Evidence
name
http://purl.org/dc/terms/title
Evidence
http://data.europa.eu/m8g/Evidence
related documentation
http://xmlns.com/foaf/0.1/page
Evidence
http://data.europa.eu/m8g/Evidence
submission date
https://w3id.org/str/submissionDate
Evidence
http://data.europa.eu/m8g/Evidence
update date
https://w3id.org/str/updateDate
Evidence
http://data.europa.eu/m8g/Evidence
validity period
http://data.europa.eu/m8g/validityPeriod
Geometry
http://www.w3.org/ns/locn#Geometry
coordinates
http://data.europa.eu/m8g/coordinates
Geometry
http://www.w3.org/ns/locn#Geometry
geometry type
http://data.europa.eu/m8g/geometryType
Geometry
http://www.w3.org/ns/locn#Geometry
latitude
http://data.europa.eu/m8g/latitude
Geometry
http://www.w3.org/ns/locn#Geometry
longitude
http://data.europa.eu/m8g/longitude
Group
http://xmlns.com/foaf/0.1/Group
Identifier
http://www.w3.org/ns/adms#identifier
Mandatory notation
http://www.w3.org/2004/02/skos/core#notation
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
has legal representative
https://w3id.org/str/hasLegalRepresentative
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
is notified by
https://w3id.org/str/isNotifiedBy
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
is referred in
https://w3id.org/str/isReferredIn
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
legal identifier
http://www.w3.org/ns/legal#legalIdentifier
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
legal name
http://www.w3.org/ns/legal#legalName
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
offers
https://w3id.org/str/offers
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
provides
https://w3id.org/str/provides
Legal Entity
http://www.w3.org/ns/legal#LegalEntity
registered address
http://data.europa.eu/m8g/registeredAddress
Literal
http://www.w3.org/2000/01/rdf-schema#Literal
Location
http://purl.org/dc/terms/Location
Recommended bbox
http://www.w3.org/ns/dcat#bbox
Location
http://purl.org/dc/terms/Location
Recommended centroid
http://www.w3.org/ns/dcat#centroid
Location
http://purl.org/dc/terms/Location
Optional geometry
http://www.w3.org/ns/locn#geometry
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
checks
https://w3id.org/str/checks
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
identifier
http://purl.org/dc/terms/identifier
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
provides information to
https://w3id.org/str/providesInformationTo
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
publishes
https://w3id.org/str/publishes
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
requests area
https://w3id.org/str/requestsArea
Online Short Term Rental Platform
https://w3id.org/str/OnlineShortTermRentalPlatform
type
http://purl.org/dc/terms/type
Order
https://w3id.org/str/Order
concerns
https://w3id.org/str/concerns
Order
https://w3id.org/str/Order
has listing
https://w3id.org/str/hasListing
Order
https://w3id.org/str/Order
identifier
http://purl.org/dc/terms/identifier
Order
https://w3id.org/str/Order
reason
https://w3id.org/str/reason
Order
https://w3id.org/str/Order
sent to
https://w3id.org/str/sentTo
Output
http://data.europa.eu/m8g/Output
identifier
http://purl.org/dc/terms/identifier
Output
http://data.europa.eu/m8g/Output
name
http://purl.org/dc/terms/title
Period of time
http://purl.org/dc/terms/PeriodOfTime
Recommended end date
http://www.w3.org/ns/dcat#endDate
Period of time
http://purl.org/dc/terms/PeriodOfTime
Recommended start date
http://www.w3.org/ns/dcat#startDate
Period of time
http://purl.org/dc/terms/PeriodOfTime
Optional beginning
http://www.w3.org/2006/time#hasBeginning
Period of time
http://purl.org/dc/terms/PeriodOfTime
Optional end
http://www.w3.org/2006/time#hasEnd
Person
http://www.w3.org/ns/person#Person
contact point
http://data.europa.eu/m8g/contactPoint
Person
http://www.w3.org/ns/person#Person
domicile
http://data.europa.eu/m8g/domicile
Person
http://www.w3.org/ns/person#Person
family name
http://xmlns.com/foaf/0.1/familyName
Person
http://www.w3.org/ns/person#Person
given name
http://xmlns.com/foaf/0.1/givenName
Person
http://www.w3.org/ns/person#Person
identifier
http://www.w3.org/ns/adms#identifier
Person
http://www.w3.org/ns/person#Person
is notified by
https://w3id.org/str/isNotifiedBy
Person
http://www.w3.org/ns/person#Person
is point of contact for
https://w3id.org/str/isPointOfContactFor
Person
http://www.w3.org/ns/person#Person
is referred in
https://w3id.org/str/isReferredIn
Person
http://www.w3.org/ns/person#Person
offers
https://w3id.org/str/offers
Person
http://www.w3.org/ns/person#Person
provides
https://w3id.org/str/provides
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
address
http://www.w3.org/ns/locn#address
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
alternative label
http://www.w3.org/2004/02/skos/core#altLabel
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
classification
http://www.w3.org/ns/org#classification
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
description
http://purl.org/dc/terms/description
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
establishes
https://w3id.org/str/establishes
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
has national coordinator
https://w3id.org/str/hasNationalCoordinator
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
issues
https://w3id.org/str/issues
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
preferred label
http://www.w3.org/2004/02/skos/core#prefLabel
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
purpose
http://www.w3.org/ns/org#purpose
Public Organisation
http://data.europa.eu/m8g/PublicOrganisation
verifies
https://w3id.org/str/verifies
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
description
http://purl.org/dc/terms/description
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
has competent authority
http://data.europa.eu/m8g/hasCompetentAuthority
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
has input
http://purl.org/vocab/cpsv#hasInput
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
identifier
http://purl.org/dc/terms/identifier
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
name
http://purl.org/dc/terms/title
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
Optional produces
http://purl.org/vocab/cpsv#produces
Public Registry Service
http://purl.org/vocab/cpsv#PublicService
produces
http://purl.org/vocab/cpsv#produces
Registration Number
https://w3id.org/str/RegistrationNumber
identifies
https://w3id.org/str/identifies
Registration Number
https://w3id.org/str/RegistrationNumber
issue date
http://purl.org/dc/terms/issued
Registration Number
https://w3id.org/str/RegistrationNumber
status
http://www.w3.org/ns/adms#status
Registration Number
https://w3id.org/str/RegistrationNumber
temporal
http://purl.org/dc/terms/temporal
Registration Procedure
https://w3id.org/str/RegistrationProcedure
applies to
https://w3id.org/str/appliesTo
Registration Procedure
https://w3id.org/str/RegistrationProcedure
has cost
http://data.europa.eu/m8g/hasCost
Short Term Accomodation Rental Service
https://w3id.org/str/ShortTermAccomodationRentalService
provides access to
https://w3id.org/str/providesAccessTo
Single Digital Entry Point
https://w3id.org/str/SingleDigitalEntryPoint
Unit
https://w3id.org/str/Unit
description
http://purl.org/dc/terms/description
Unit
https://w3id.org/str/Unit
floor level
https://w3id.org/str/floorLevel
Unit
https://w3id.org/str/Unit
has authorization
https://w3id.org/str/hasAuthorization
Unit
https://w3id.org/str/Unit
has unit address
https://w3id.org/str/hasUnitAddress
Unit
https://w3id.org/str/Unit
is authorization obtained
https://w3id.org/str/isAuthorizationObtained
Unit
https://w3id.org/str/Unit
is offered on
https://w3id.org/str/isOfferedOn
Unit
https://w3id.org/str/Unit
is subject to authorization
https://w3id.org/str/isSubjectToAuthorization
Unit
https://w3id.org/str/Unit
number of bedrooms
https://w3id.org/str/numberOfBedrooms
Unit
https://w3id.org/str/Unit
occupancy
https://w3id.org/str/occupancy
Unit
https://w3id.org/str/Unit
purpose
https://w3id.org/str/purpose
Unit
https://w3id.org/str/Unit
type
http://purl.org/dc/terms/type
Unit
https://w3id.org/str/Unit
url
https://schema.org/URL