Accommodation
A Schema.org Type
- Canonical URL: https://schema.org/Accommodation
- Check for open issues.
An accommodation is a place that can accommodate human beings, e.g. a hotel room, a camping pitch, or a meeting room. Many accommodations are for overnight stays, but this is not a mandatory requirement.
For more specific types of accommodations not defined in schema.org, one can use additionalType with external vocabularies.
See also the dedicated document on the use of schema.org for marking up hotels and other forms of accommodations.
See also the dedicated document on the use of schema.org for marking up hotels and other forms of accommodations.
Property | Expected Type | Description |
---|---|---|
Properties from Accommodation | ||
accommodationCategory |
Text | Category of an Accommodation, following real estate conventions, e.g. RESO (see PropertySubType, and PropertyType fields for suggested values). |
accommodationFloorPlan |
FloorPlan | A floorplan of some Accommodation. |
amenityFeature |
LocationFeatureSpecification | An amenity feature (e.g. a characteristic or service) of the Accommodation. This generic property does not make a statement about whether the feature is included in an offer for the main accommodation or available at extra costs. |
bed |
BedDetails or BedType or Text |
The type of bed or beds included in the accommodation. For the single case of just one bed of a certain type, you use bed directly with a text. If you want to indicate the quantity of a certain kind of bed, use an instance of BedDetails. For more detailed information, use the amenityFeature property. |
floorLevel |
Text | The floor level for an Accommodation in a multi-storey building. Since counting systems vary internationally, the local system should be used where possible. |
floorSize |
QuantitativeValue | The size of the accommodation, e.g. in square meter or squarefoot. Typical unit code(s): MTK for square meter, FTK for square foot, or YDK for square yard. |
leaseLength |
Duration or QuantitativeValue |
Length of the lease for some Accommodation, either particular to some Offer or in some cases intrinsic to the property. |
numberOfBathroomsTotal |
Integer | The total integer number of bathrooms in some Accommodation, following real estate conventions as documented in RESO: "The simple sum of the number of bathrooms. For example for a property with two Full Bathrooms and one Half Bathroom, the Bathrooms Total Integer will be 3.". See also numberOfRooms. |
numberOfBedrooms |
Number or QuantitativeValue |
The total integer number of bedrooms in a some Accommodation, ApartmentComplex or FloorPlan. |
numberOfFullBathrooms |
Number | Number of full bathrooms - The total number of full and ¾ bathrooms in an Accommodation. This corresponds to the BathroomsFull field in RESO. |
numberOfPartialBathrooms |
Number | Number of partial bathrooms - The total number of half and ¼ bathrooms in an Accommodation. This corresponds to the BathroomsPartial field in RESO. |
numberOfRooms |
Number or QuantitativeValue |
The number of rooms (excluding bathrooms and closets) of the accommodation or lodging business. Typical unit code(s): ROM for room or C62 for no unit. The type of room can be put in the unitText property of the QuantitativeValue. |
occupancy |
QuantitativeValue | The allowed total occupancy for the accommodation in persons (including infants etc). For individual accommodations, this is not necessarily the legal maximum but defines the permitted usage as per the contractual agreement (e.g. a double room used by a single person). Typical unit code(s): C62 for person. |
permittedUsage |
Text | Indications regarding the permitted usage of the accommodation. |
petsAllowed |
Boolean or Text |
Indicates whether pets are allowed to enter the accommodation or lodging business. More detailed information can be put in a text value. |
tourBookingPage |
URL | A page providing information on how to book a tour of some Place, such as an Accommodation or ApartmentComplex in a real estate setting, as well as other kinds of tours as appropriate. |
yearBuilt |
Number | The year an Accommodation was constructed. This corresponds to the YearBuilt field in RESO. |
Properties from Place | ||
additionalProperty |
PropertyValue | A property-value pair representing an additional characteristic of the entity, e.g. a product feature or another characteristic for which there is no matching property in schema.org. Note: Publishers should be aware that applications designed to use specific schema.org properties (e.g. https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism. |
address |
PostalAddress or Text |
Physical address of the item. |
aggregateRating |
AggregateRating | The overall rating, based on a collection of reviews or ratings, of the item. |
amenityFeature |
LocationFeatureSpecification | An amenity feature (e.g. a characteristic or service) of the Accommodation. This generic property does not make a statement about whether the feature is included in an offer for the main accommodation or available at extra costs. |
branchCode |
Text | A short textual code (also called "store code") that uniquely identifies a place of business. The code is typically assigned by the parentOrganization and used in structured URLs. For example, in the URL http://www.starbucks.co.uk/store-locator/etc/detail/3047 the code "3047" is a branchCode for a particular branch. |
containedInPlace |
Place | The basic containment relation between a place and one that contains it.
Supersedes
containedIn.
Inverse property: containsPlace |
containsPlace |
Place | The basic containment relation between a place and another that it contains.
Inverse property: containedInPlace |
event |
Event | Upcoming or past event associated with this place, organization, or action. Supersedes events. |
faxNumber |
Text | The fax number. |
geo |
GeoCoordinates or GeoShape |
The geo coordinates of the place. |
geoContains |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a containing geometry to a contained geometry. "a contains b iff no points of b lie in the exterior of a, and at least one point of the interior of b lies in the interior of a". As defined in DE-9IM. |
geoCoveredBy |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a geometry to another that covers it. As defined in DE-9IM. |
geoCovers |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a covering geometry to a covered geometry. "Every point of b is a point of (the interior or boundary of) a". As defined in DE-9IM. |
geoCrosses |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a geometry to another that crosses it: "a crosses b: they have some but not all interior points in common, and the dimension of the intersection is less than that of at least one of them". As defined in DE-9IM. |
geoDisjoint |
GeospatialGeometry or Place |
Represents spatial relations in which two geometries (or the places they represent) are topologically disjoint: "they have no point in common. They form a set of disconnected geometries." (A symmetric relationship, as defined in DE-9IM.) |
geoEquals |
GeospatialGeometry or Place |
Represents spatial relations in which two geometries (or the places they represent) are topologically equal, as defined in DE-9IM. "Two geometries are topologically equal if their interiors intersect and no part of the interior or boundary of one geometry intersects the exterior of the other" (a symmetric relationship). |
geoIntersects |
GeospatialGeometry or Place |
Represents spatial relations in which two geometries (or the places they represent) have at least one point in common. As defined in DE-9IM. |
geoOverlaps |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a geometry to another that geospatially overlaps it, i.e. they have some but not all points in common. As defined in DE-9IM. |
geoTouches |
GeospatialGeometry or Place |
Represents spatial relations in which two geometries (or the places they represent) touch: "they have at least one boundary point in common, but no interior points." (A symmetric relationship, as defined in DE-9IM.) |
geoWithin |
GeospatialGeometry or Place |
Represents a relationship between two geometries (or the places they represent), relating a geometry to one that contains it, i.e. it is inside (i.e. within) its interior. As defined in DE-9IM. |
globalLocationNumber |
Text | The Global Location Number (GLN, sometimes also referred to as International Location Number or ILN) of the respective organization, person, or place. The GLN is a 13-digit number used to identify parties and physical locations. |
hasCertification |
Certification | Certification information about a product, organization, service, place, or person. |
hasDriveThroughService |
Boolean | Indicates whether some facility (e.g. FoodEstablishment, CovidTestingFacility) offers a service that can be used by driving through in a car. In the case of CovidTestingFacility such facilities could potentially help with social distancing from other potentially-infected users. |
hasGS1DigitalLink |
URL | The GS1 digital link associated with the object. This URL should conform to the particular requirements of digital links. The link should only contain the Application Identifiers (AIs) that are relevant for the entity being annotated, for instance a Product or an Organization, and for the correct granularity. In particular, for products:
|
hasMap |
Map or URL |
A URL to a map of the place. Supersedes map, maps. |
isAccessibleForFree |
Boolean | A flag to signal that the item, event, or place is accessible for free. Supersedes free. |
isicV4 |
Text | The International Standard of Industrial Classification of All Economic Activities (ISIC), Revision 4 code for a particular organization, business person, or place. |
keywords |
DefinedTerm or Text or URL |
Keywords or tags used to describe some item. Multiple textual entries in a keywords list are typically delimited by commas, or by repeating the property. |
latitude |
Number or Text |
The latitude of a location. For example 37.42242 (WGS 84).
|
logo |
ImageObject or URL |
An associated logo. |
longitude |
Number or Text |
The longitude of a location. For example -122.08585 (WGS 84).
|
maximumAttendeeCapacity |
Integer | The total number of individuals that may attend an event or venue. |
openingHoursSpecification |
OpeningHoursSpecification | The opening hours of a certain place. |
photo |
ImageObject or Photograph |
A photograph of this place. Supersedes photos. |
publicAccess |
Boolean | A flag to signal that the Place is open to public visitors. If this property is omitted there is no assumed default boolean value. |
review |
Review | A review of the item. Supersedes reviews. |
slogan |
Text | A slogan or motto associated with the item. |
smokingAllowed |
Boolean | Indicates whether it is allowed to smoke in the place, e.g. in the restaurant, hotel or hotel room. |
specialOpeningHoursSpecification |
OpeningHoursSpecification | The special opening hours of a certain place. Use this to explicitly override general opening hours brought in scope by openingHoursSpecification or openingHours. |
telephone |
Text | The telephone number. |
tourBookingPage |
URL | A page providing information on how to book a tour of some Place, such as an Accommodation or ApartmentComplex in a real estate setting, as well as other kinds of tours as appropriate. |
Properties from Thing | ||
additionalType |
Text or URL |
An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. |
alternateName |
Text | An alias for the item. |
description |
Text or TextObject |
A description of the item. |
disambiguatingDescription |
Text | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation. |
identifier |
PropertyValue or Text or URL |
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details. |
image |
ImageObject or URL |
An image of the item. This can be a URL or a fully described ImageObject. |
mainEntityOfPage |
CreativeWork or URL |
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity |
name |
Text | The name of the item. |
potentialAction |
Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. |
sameAs |
URL | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website. |
subjectOf |
CreativeWork or Event |
A CreativeWork or Event about this Thing.
Inverse property: about |
url |
URL | URL of the item. |
Instances of
Accommodation may appear as a value for the following properties
Property | On Types | Description |
---|---|---|
isPlanForApartment | FloorPlan | Indicates some accommodation that this floor plan describes. |
More specific Types
Acknowledgements
STI Accommodation Ontology
Examples
Example 1
Copied
Example notes or example HTML without markup.
Apartment example with min and max occupancy limits and floor size of 81 square meters(JSON-LD only).
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Apartment", "name": "227 Lynn Street - Medium apartment", "description": "Great downtown accommodation for family or group of friends.", "numberOfRooms": 3, "occupancy": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 4 }, "floorLevel": "5", "floorSize": { "@type": "QuantitativeValue", "value": 81, "unitCode": "MTK" }, "numberOfBathroomsTotal": 2, "numberOfBedrooms": 2, "petsAllowed": true, "tourBookingPage": "http://example.com", "yearBuilt": 2005, "telephone": "+1-617-312-9783", "address": { "@type": "PostalAddress", "addressCountry": "US", "addressLocality": "West Roxbury", "addressRegion": "MA", "postalCode": "02132", "streetAddress": "227 Lynn Street" }, "latitude": 42.2742, "longitude": -71.1430 } </script>
Structured representation of the JSON-LD example.
Example 2
Copied
Example notes or example HTML without markup.
Single family residence example with min and max occupancy limits, floor size of 2500 square foots and lease length of 6 months(JSON-LD only).
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "SingleFamilyResidence", "name": "1331 St George Street - Family House", "description": "Great opportunity to own this 2500 sqft originally built in 1988 family home with 4 bedroom, 3 bathroom. which was RENOVATED IN 2014:( New Windows, New Bathroom, New Hardwood Floors, Air Condition, New Kitchen, etc.)", "numberOfRooms": 5, "occupancy": { "@type": "QuantitativeValue", "minValue": 1, "maxValue": 5 }, "floorSize": { "@type": "QuantitativeValue", "value": 2500, "unitCode": "FTK" }, "leaseLength": { "@type": "QuantitativeValue", "value": 6, "unitText": "months" }, "numberOfBathroomsTotal": 3, "numberOfBedrooms": 4, "permittedUsage": "Perfectly suitable for a family with two kids.", "petsAllowed": "Only cats are allowed", "yearBuilt": 1988, "address": { "@type": "PostalAddress", "addressCountry": "CA", "addressLocality": "Vancouver", "addressRegion": "British Columbia", "postalCode": "V5T 1Z7", "streetAddress": "1331 St George Street" }, "telephone": "+1-604-829-6070" } </script>
Structured representation of the JSON-LD example.