Open Content Link

General considerations

The following URL provides a master list of the accommodation present within GIATA's Open Content link:

https://myhotel.giatamedia.com/sitemap/

Each accommodation is identified by its GIATA-ID, e.g.:

https://myhotel.giatamedia.com/4199

For both resources (master list and details of specific accommodation) there also exists a JSON and an XML representation, e.g.:

https://myhotel.giatamedia.com/sitemap/json

https://myhotel.giatamedia.com/4199/json

Details of an accommodation

The JSON representation has the following structure:

Field Type Definition
giataId int The GIATA-ID of the accommodation.
names array Names of the accomodation.
city object The city where the accommodation is located.
country object The country where the accommodation is located.
ratings array Star Ratings for the accommodation.
addresses array Address(es) of the accommodation.
phones array Phone number(s) of the accommodation.
emails array Email(s) of the accommodation.
urls array URL(s) of the accommodation.
geoCodes array Geo code(s) of the accommodation.
chains array Chain(s) that the accommodation is associated with.
images array Images for the accommodation.
facts object The facts, facilities or amenities available for the accommodation.
texts object The textual content for the accommodation in various languages.

Name

Field Type Definition
value string The name in a given locale.
locale string The locale of the name.
isDefault bool Indicates if this name is the default name.

City

Field Type Definition
giataId int The GIATA-ID of the city.
names array Names of the city.

Country

Field Type Definition
code string The code of the country (ISO 3166-1 Alpha-2 code)
names array Names of the country.

Rating

Field Type Definition
value string The value of the rating.
isDefault bool Indicates if this rating is the default rating.

Address

Field Type Definition
addressLines array List of strings, each representing an address line of the address.
street string The name of the street.
streetNum string The street number.
zip string The zip/postal code.
cityName string The name of the city.
poBox string The P.O. box number.
federalState object The federal state.

Federal State

Field Type Definition
giataId int The GIATA-ID of the federal state.
name string The name of the federal state.
code string The code identifying the federal state within a given country.

Phone number

Field Type Definition
phone string The phone number.
tech string Indicates the technical type of the phone number (phone or fax).

Email

Field Type Definition
email string The email address.

URL

Field Type Definition
url string The URL.

Geo code

Field Type Definition
latitude float The latitude of the accommodation.
longitude float The longitude of the accommodation.
accuracy string Indicates the level of accuracy of the geo code (address, street, locality or city).

Chain

Field Type Definition
giataId int The GIATA-ID of the chain.
names array List of names of the chain.

Image

Field Type Definition
id int The ID of the image.
motifType string The code of the motif type of the image. Please refer to the list of motif types for details.
lastUpdate int Unix timestamp of the last update of the image.
heroImage bool Indicates if the image is a hero image (primary image).
sizes object Represents the sizes/dimensions in which the image is available.

Image sizes

Field Type Definition
Numeric key identifying an image size, e.g. 1080 object Represents the information about the image in a given size/dimension.

Image size

Field Type Definition
maxWidth int The (maximum) width of the image in a given size.
href string The URL of the image in a given size.

Facts

Field Type Definition
Numeric key identifying a fact , e.g. 123 bool|object Represents the information about a given fact, facility or amenity. If the key is set, then the fact is applicable for the accommodation. If the value is a boolean true, then no further details are provided. If the value is an object, then it contains further details of the fact. For details about the structure and labels of the facts refer to the internationalized description of facts.

Fact

Field Type Definition
Numeric key identifying a sub-attribute of fact , e.g. 45 bool|object Represents the information about a given sub-attribute of a fact. If the key is set, then the attribute is applicable for the fact. If the value is a boolean true, then no further details are provided. If the value is an object, then it contains further details of the attribute.

Fact attribute

Field Type Definition
value string The value of the sub-attribute of a given fact.
unitId int The ID of the unit, specifying the value.

Texts

Field Type Definition
Key identifying the locale of a text, e.g. en object Represents the textual content for the accommodation in a given locale/language.

Text

Field Type Definition
locale string The locale/language of the text.
lastUpdate int Unix timestamp of the last update of the text.
sections array List of the sections of the text.

Text section

Field Type Definition
title string The title of a text section.
para string The content of a text section.

Internationalized description of facts

The list of locales/languages in which the labels of facts, attributes and units are available can be retrieved here:

https://myhotel.giatamedia.com/i18n/facts

The list includes the URL for the structure and the labels in a given locale/language, e.g.:

https://myhotel.giatamedia.com/i18n/facts/en

Description of facts

Field Type Definition
Key identifying the locale of the internationalized description of facts, e.g. en object Represents the internationalized description in a given locale/language.

Internationalized description

Field Type Definition
contextTree object Represents the context tree, i.e. the structure of fact descriptions.
facts object Represents the fact definitions.
attributes object Represents the attribute definitions.
units object Represents the unit definitions.

Context tree

Field Type Definition
Numeric key identifying a section , e.g. 12 object Represents a facts section.

Facts section

Field Type Definition
label string The label of the section.
facts array The IDs of the facts within the section.
sub object An optional child context tree.

Fact definitions

Field Type Definition
Numeric key identifying a fact, e.g. 123 object Represents a fact definition.

Fact definition

Field Type Definition
label string The label of the fact.
attributes array The IDs of the attributes applicable for the fact.

Attribute definitions

Field Type Definition
Numeric key identifying a sub-attribute of a fact , e.g. 45 object Represents an attribute definition.

Attribute definition

Field Type Definition
label string The label of the sub-attribute.

Unit definitions

Field Type Definition
Numeric key identifying a unit , e.g. 1 object Represents a unit definition.

Unit definition

Field Type Definition
label string The label of the unit.

Appendix

Motif types

Code Description
A Exterior
BA Bar
BD Bathroom Example
EK Shopping
F Sports and leisure
FAD Adventure
FO Folklore
FRE Relax
FRR Breakfast Room
GA Garden
HB Indoor Pool
IT Internet Café
K Conference Room
KL Culture
KU Art
L Lounge / Lobby
LG Logo
LK Map
LS Landscape
LU Aerial Photograph
MF Rental Car / Vehicle
MHS Sea / Harbour / Ship
MOD Model Impression
P Outdoor Pool
PE People
PEF Family
PEH Wedding
PEK Children
PEP Couple
PER Romance
PEY Party
PR Price
R Restaurant
S Beach
SD Deck of Ship
SE Point of Interest
STA City
TE Terrace
TI Pets
W Room Example
WEL Health & Beauty
X Miscellaneous