Type |
Field |
Definition |
Metadata
|
metadata
|
REQUIRED. The last updated timestamp must be specified.
|
string
|
place_id
|
REQUIRED. Unique Place ID identifier for the property.
https://developers.google.com/places/place-id.
Example: "ChIJrTLr-GyuEmsRBfy61i59si0".
|
Property
|
property
|
General factual information about the property's physical structure and
important dates.
|
Services
|
services
|
Conveniences or help provided by the property to facilitate an easier, more
comfortable stay.
|
Policies
|
policies
|
Property rules that impact guests.
|
FoodAndDrink
|
food_and_drink
|
Meals, snacks, and beverages available at the property.
|
Pools
|
pools
|
A body of water contained within a man-made structure either indoors or
outdoors for the purpose of swimming, soaking, or recreation.
|
Wellness
|
wellness
|
Guest facilities at the property to promote or maintain health, beauty, and
fitness.
|
Activities
|
activities
|
Amenities and features related to leisure and play.
|
Transportation
|
transportation
|
Vehicles or vehicular services facilitated or owned by the property.
|
Families
|
families
|
Groups of people who are related to each other, often consisting of
adults and at least 1 child.
|
Connectivity
|
connectivity
|
The ways in which the property provides guests with the ability to access
the internet.
|
Business
|
business
|
Features of the property of specific interest to the business traveler.
|
Accessibility
|
accessibility
|
Physical adaptations made to the property in consideration of varying levels
of human physical ability.
|
Pets
|
pets
|
Policies regarding guest-owned animals.
|
Parking
|
parking
|
An area on-site at a property where one can temporarily leave a motor
vehicle when not in use, or the services related to the act of parking
in this area.
|
Housekeeping
|
housekeeping
|
Conveniences provided in guest units to facilitate an easier, more
comfortable stay.
|
LivingArea
|
common_living_area
|
Additional amenities available in shared areas.
|
GuestUnitType
|
all_units
|
In-unit amenities available in ALL guest unit types.
|
GuestUnitType
|
some_units
|
In-unit amenities available in SOME guest unit types.
|
repeated GuestUnitType
|
guest_units
|
In-unit amenities available in individual guest unit types.
|
Type |
Field |
Definition |
int32
|
built_year
|
The year that construction of the property was completed.
|
int32
|
last_renovated_year
|
The year when a renovation of the property was completed. Renovation may
include all or any combination of the following: the units, the public
spaces, the exterior, or the interior.
|
int32
|
number_of_rooms
|
The total number of rooms and suites bookable by guests for an overnight
stay. Does not include event space, public spaces, conference rooms,
fitness rooms, business centers, spa, salon, restaurants/bars, or shops.
|
int32
|
floors
|
The number of stories the building has from the ground floor to the top
floor.
|
Type |
Field |
Definition |
float
|
class_rating
|
A rating system for classifying hotels based on their services and
facilities. Typically a system ranging from 1 to 5 stars, with the
greater number of stars indicating more services/luxury. In some
countries, hotel class is governed legally or by a known hotel
association.
|
bool
|
front_desk
|
A counter or desk in the lobby or the immediate interior of the hotel
where a member of the staff greets guests and processes the information
related to their stay (including check-in and check-out). May or may not
be manned and open 24/7.
|
bool
|
front_desk_24hrs
|
Front desk is staffed 24 hours a day.
|
bool
|
concierge
|
Hotel staff member(s) responsible for facilitating an easy, comfortable
stay through making reservations for meals, sourcing theater tickets,
arranging tours, finding a doctor, making recommendations, and answering
questions.
|
bool
|
elevator
|
There is a passenger elevator that transports guests from one story to
another. Also known as lift.
|
bool
|
baggage_storage
|
A provision for guests to leave their bags at the hotel when they arrive
for their stay before the official check-in time. May or may not apply
for guests who wish to leave their bags after check-out and before
departing the locale. Also known as bag dropoff.
|
bool
|
laundry_full_service
|
Laundry and dry cleaning facilitated and handled by the hotel on behalf
of the guest. Does not include the provision for guests to do their own
laundry in on-site machines.
|
bool
|
laundry_self_service
|
On-site clothes washers and dryers accessible to guests for the purpose
of washing and drying their own clothes. May or may not require payment
to use the machines.
|
bool
|
social_hour
|
A reception with complimentary soft drinks, tea, coffee, wine and/or
cocktails in the afternoon or evening. Can be hosted by hotel staff or
guests may serve themselves. Also known as wine hour. The availability
of coffee/tea in the lobby throughout the day does not constitute a
social or wine hour.
|
bool
|
wake_up_calls
|
By direction of the guest, a hotel staff member will phone the guest unit
at the requested hour. Also known as morning call.
|
bool
|
convenience_store
|
A shop at the hotel primarily selling snacks, drinks, non-prescription
medicines, health and beauty aids, magazines and newspapers.
|
bool
|
gift_shop
|
An on-site store primarily selling souvenirs, mementos and other gift
items. May or may not also sell sundries, magazines and newspapers,
clothing, or snacks.
|
bool
|
currency_exchange
|
A staff member or automated machine tasked with the transaction of
providing the native currency of the hotel's locale in exchange for the
foreign currency provided by a guest.
|
LanguagesSpoken
|
languages_spoken
|
At least one staff member speaks the given language.
|
Type |
Field |
Definition |
bool
|
arabic_spoken
|
At least one staff member speaks Arabic.
|
bool
|
cantonese_spoken
|
At least one staff member speaks Cantonese.
|
bool
|
dutch_spoken
|
At least one staff member speaks Dutch.
|
bool
|
english_spoken
|
At least one staff member speaks English.
|
bool
|
filipino_spoken
|
At least one staff member speaks Filipino.
|
bool
|
french_spoken
|
At least one staff member speaks French.
|
bool
|
german_spoken
|
At least one staff member speaks German.
|
bool
|
hindi_spoken
|
At least one staff member speaks Hindi.
|
bool
|
indonesian_spoken
|
At least one staff member speaks Indonesian.
|
bool
|
italian_spoken
|
At least one staff member speaks Italian.
|
bool
|
japanese_spoken
|
At least one staff member speaks Japanese.
|
bool
|
korean_spoken
|
At least one staff member speaks Korean.
|
bool
|
mandarin_spoken
|
At least one staff member speaks Mandarin.
|
bool
|
portuguese_spoken
|
At least one staff member speaks Portuguese.
|
bool
|
russian_spoken
|
At least one staff member speaks Russian.
|
bool
|
spanish_spoken
|
At least one staff member speaks Spanish.
|
bool
|
vietnamese_spoken
|
At least one staff member speaks Vietnamese.
|
Type |
Field |
Definition |
bool
|
parking_available
|
The hotel allows the cars of guests to be parked, either for free or for
a fee. Parking facility may be an outdoor lot or an indoor garage, but
must be onsite. Nearby parking does not apply. Parking may be performed
by the guest or by hotel staff.
|
bool
|
parking_for_free
|
The hotel allows the cars of guests to be parked without a fee. Parking
facility may be an outdoor lot or an indoor garage, but must be onsite.
Nearby parking does not apply. Parking may be performed by the guest or
by hotel staff. Free parking must be available to all guests (limited
conditions does not apply).
|
bool
|
self_parking_available
|
Guests park their own cars. Parking facility may be an outdoor lot or an
indoor garage, but must be onsite. Nearby parking does not apply. Can be
paid or free of charge.
|
bool
|
self_parking_for_free
|
Guests park their own cars for free. Parking facility may be an outdoor
lot or an indoor garage, but must be onsite. Nearby parking does not
apply.
|
bool
|
valet_parking_available
|
Hotel staff member parks the cars of guests. Parking with this service
can be paid or free of charge.
|
bool
|
valet_parking_for_free
|
Hotel staff member parks the cars of guests. Parking with this service is
free.
|
bool
|
electric_car_charging_stations
|
Electric power stations, usually located outdoors, into which guests plug
their electric cars to receive a charge.
|
Type |
Field |
Definition |
string
|
check_in_time
|
The hour of the day at which the hotel begins providing guests access to
their unit at the beginning of their stay.
|
string
|
check_out_time
|
The hour of the day on the last day of a guest's reserved stay at which
the guest must vacate their room and settle their bill. Some hotels may
offer late or early check out for a fee.
|
bool
|
kids_stay_for_free
|
The children of guests are allowed to stay in the room/suite of a parent
or adult without an additional fee. The policy may or may not stipulate
a limit of the child's age or the overall number of children allowed.
|
int32
|
max_number_of_kids_stay_for_free
|
The hotel allows a specific, defined number of children to stay in the
room/suite of a parent or adult without an additional fee.
|
int32
|
max_child_age
|
The hotel allows children up to a certain age to stay in the room/suite
of a parent or adult without an additional fee.
|
bool
|
smoke_free_property
|
Smoking is not allowed inside the building, on balconies, or in outside
spaces. Hotels that offer a designated area for guests to smoke are not
considered smoke-free properties.
|
bool
|
all_inclusive_available
|
The hotel offers a rate option that includes the cost of the room, meals,
activities, and other amenities that might otherwise be charged separately.
|
bool
|
all_inclusive_only
|
The only rate option offered by the hotel is a rate that includes the
cost of the room, meals, activities and other amenities that might
otherwise be charged separately.
|
PaymentOptions
|
payment_options
|
Forms of payment accepted.
|
Type |
Field |
Definition |
bool
|
room_service
|
A hotel staffer delivers meals prepared onsite to a guest's room as per
their request. May or may not be available during specific hours.
Services should be available to all guests (not based on rate/room
booked/reward program, etc).
|
bool
|
room_service_24hrs
|
Room service is available 24 hours a day.
|
bool
|
restaurant
|
A business onsite at the hotel that is open to the public as well as
guests, and offers meals and beverages to consume at tables or counters.
May or may not include table service. Also known as cafe, buffet,
eatery. A "breakfast room" where the hotel serves breakfast only to
guests (not the general public) does not count as a restaurant.
|
int32
|
number_of_restaurants
|
The number of businesses at the hotel that are open to the public as well
as guests and offer meals and beverages to consume onsite at tables or
counters. May or may not include table service. Also known as cafe,
buffet, or eatery.
|
bool
|
table_service
|
A restaurant in which a staff member is assigned to a guest's table to
take their order, deliver and clear away food, and deliver the bill, if
applicable. Also known as sit-down restaurant.
|
bool
|
buffet
|
A type of meal where guests serve themselves from a variety of
dishes/foods that are put out on a table.
|
bool
|
buffet_dinner
|
Dinner meal service where guests serve themselves from a variety of
dishes/foods that are put out on a table.
|
bool
|
buffet_breakfast
|
Breakfast meal service where guests serve themselves from a variety of
dishes/foods that are put out on a table.
|
bool
|
breakfast_available
|
The morning meal is offered to all guests. May be free or for a charge.
|
bool
|
breakfast_for_free
|
Breakfast is offered free to all guests. Does not apply if only limited
to certain room packages.
|
bool
|
bar
|
A designated room, lounge or area of a restaurant with seating at a
counter behind which a hotel staffer takes the guest's order and provides
the requested alcoholic drink. May be indoors or outdoors. Also known as
Pub.
|
bool
|
vending_machine
|
A glass-fronted mechanized cabinet displaying and dispensing snacks and
beverages for purchase by coins, paper money and/or credit cards.
|
Type |
Field |
Definition |
bool
|
pool
|
The presence of a pool, either indoors or outdoors.
|
int32
|
number_of_pools
|
The sum of all pools at the hotel.
|
bool
|
indoor_pool
|
A pool located inside the hotel and available for guests to use for
swimming and/or soaking. Use may or may not be restricted to adults
and/or children.
|
int32
|
number_of_indoor_pools
|
The sum of all indoor pools at the hotel.
|
bool
|
outdoor_pool
|
A pool located outside on the grounds of the hotel and available for
guests to use for swimming, soaking or recreation. Use may or may not be
restricted to adults and/or children.
|
int32
|
number_of_outdoor_pools
|
The sum of all outdoor pools at the hotel.
|
bool
|
hot_tub
|
A man-made pool containing bubbling water maintained at a higher
temperature and circulated by aerating jets for the purpose of soaking,
relaxation and hydrotherapy. Can be indoors or outdoors. Not used for
active swimming. Also known as Jacuzzi. Hot tub must be in a common area
where all guests can access it. Does not apply to room-specific hot tubs
that are only accessible to guest occupying that room.
|
bool
|
waterslide
|
A continuously wetted chute positioned by an indoor or outdoor pool which
people slide down into the water.
|
bool
|
lazy_river
|
A man-made pool or several interconnected recreational pools built to
mimic the shape and current of a winding river where guests float in the
water on inflated rubber tubes. Can be indoors or outdoors.
|
bool
|
adult_pool
|
A pool inside the hotel or outside on hotel grounds restricted for use by
adults only.
|
bool
|
wading_pool
|
A shallow pool designed for small children to play in. May be indoors or
outdoors. Also known as kiddie pool.
|
bool
|
wave_pool
|
A large indoor or outdoor pool with a machine that produces water
currents to mimic the ocean's crests.
|
bool
|
thermal_pool
|
A naturally occurring outdoor body of water that is heated by the earth's
crust to a higher temperature, or an indoor or outdoor man-made pool that
contains water maintained at a temperature higher than commonly found in
standard swimming pools. The pools are used for soaking, relaxation and
hydrotherapy. Not used for active swimming. Also known as mineral spa or
mineral spring.
|
bool
|
water_park
|
An aquatic recreation area with a large pool or series of pools that has
features such as a water slide or tube, wavepool, fountains, rope swings,
and/or obstacle course. May be indoors or outdoors. Also known as
adventure pool.
|
bool
|
lifeguard
|
A trained member of the hotel staff stationed by the hotel's indoor or
outdoor swimming area and responsible for the safety of swimming guests.
|
Type |
Field |
Definition |
bool
|
fitness_center
|
A room or building at the hotel containing equipment to promote physical
activity, such as treadmills, elliptical machines, stationary bikes,
weight machines, free weights, and/or stretching mats. Use of the fitness
center may or may not be free of charge. May or may not be staffed. May
or may not offer instructor-led classes in various styles of physical
conditioning. May or may not be open 24/7. May or may not include locker
rooms and showers. Also known as health club, gym, fitness room, health
center.
|
bool
|
fitness_center_for_free
|
Guests may use the fitness center for free.
|
bool
|
elliptical_machine
|
An electric, stationary fitness machine with pedals that simulates
climbing, walking or running and provides a user-controlled range of
speeds and tensions. May not have arm-controlled levers to work out the
upper body as well. Commonly found in a gym, fitness room, health center,
or health club.
|
bool
|
treadmill
|
An electric stationary fitness machine that simulates a moving path to
promote walking or running within a range of user-controlled speeds and
inclines. Also known as running machine. Commonly found in a gym,
fitness room, health center, or health club.
|
bool
|
weight_machine
|
Non-electronic fitness equipment designed for the user to target the
exertion of different muscles. Usually incorporates a padded seat, a
stack of flat weights and various bars and pulleys. May be designed for
toning a specific part of the body or may involve different
user-controlled settings, hardware and pulleys so as to provide an
overall workout in one machine. Commonly found in a gym, fitness center,
fitness room, or health club.
|
bool
|
free_weights
|
Individual handheld fitness equipment of varied weights used for upper
body strength training or bodybuilding. Also known as barbells,
dumbbells, or kettlebells. Often stored on a rack with the weights
arranged from light to heavy. Commonly found in a gym, fitness room,
health center, or health club.
|
bool
|
spa
|
A designated area, room or building at the hotel offering health and
beauty treatment through such means as steam baths, exercise equipment,
and massage. May also offer facials, nail care, and hair care. Services
are usually available by appointment and for an additional fee. Does not
apply if hotel only offers a steam room; must offer other beauty and/or
health treatments as well.
|
bool
|
salon
|
A room at the hotel where professionals provide hair styling services
such as shampooing, blow drying, hair dos, hair cutting and hair
coloring. Also known as hairdresser or beauty salon.
|
bool
|
sauna
|
A wood-paneled room heated to a high temperature where guests sit on
built-in wood benches for the purpose of perspiring and relaxing their
muscles. Can be dry or slightly wet heat. Not a steam room.
|
bool
|
massage
|
A service provided by a trained massage therapist involving the physical
manipulation of a guest's muscles in order to achieve relaxation or pain
relief.
|
bool
|
doctor_on_call
|
The hotel has a contract with a medical professional who provides
services to hotel guests should they fall ill during their stay. The
doctor may or may not have an on-site office or be at the hotel at all
times.
|
Type |
Field |
Definition |
bool
|
game_room
|
There is a room at the hotel containing electronic machines for play such
as pinball, prize machines, driving simulators, and other items commonly
found at a family fun center or arcade. May also include non-electronic
games like pool, foosball, darts, and more. May or may not be designed
for children. Also known as arcade, fun room, or family fun center.
|
bool
|
nightclub
|
There is a room at the hotel with a bar, a dance floor, and seating where
designated staffers play dance music. There may also be a designated area
for the performance of live music, singing and comedy acts.
|
bool
|
casino
|
A space designated for gambling and gaming featuring croupier-run table
and card games, as well as electronic slot machines. May be on hotel
premises or located nearby.
|
bool
|
boutique_stores
|
There are stores selling clothing, jewelry, art and decor either on hotel
premises or very close by. Does not refer to the hotel gift shop or
convenience store.
|
bool
|
tennis
|
The hotel has the requisite court(s) on site or has an affiliation with
a nearby facility for the purpose of providing guests with the
opportunity to play a two-sided court-based game in which players use a
stringed racquet to hit a ball across a net to the side of the opposing
player. The court can be indoors or outdoors. Instructors, racquets and
balls may or may not be provided.
|
bool
|
golf
|
There is a golf course on hotel grounds or there is a nearby,
independently run golf course that allows use by hotel guests. May be
free or for a charge.
|
bool
|
horseback_riding
|
The hotel has a horse barn onsite or an affiliation with a nearby barn to
allow for guests to sit astride a horse and direct it to walk, trot,
cantor, gallop and/or jump. Can be in a riding ring, on designated paths,
or in the wilderness. May or may not involve instruction.
|
bool
|
snorkeling
|
The provision for guests to participate in a recreational water activity
in which swimmers wear a diving mask, a simple, shaped breathing tube and
flippers/swim fins for the purpose of exploring below the surface of an
ocean, gulf or lake. Does not usually require user certification or
professional supervision. Equipment may or may not be available for rent
or purchase. Not scuba diving.
|
bool
|
scuba
|
The provision for guests to dive under naturally occurring water fitted
with a self-contained underwater breathing apparatus (SCUBA) for the
purpose of exploring underwater life. Apparatus consists of a tank
providing oxygen to the diver through a mask. Requires certification of
the diver and supervision. The hotel may have the activity at its own
waterfront or have an affiliation with a nearby facility. Required
equipment is most often supplied to guests. May or may not require a fee.
Not snorkeling. Not done in a swimming pool.
|
bool
|
water_skiing
|
The provision of giving guests the opportunity to be pulled across
naturally occurring water while standing on skis and holding a tow rope
attached to a motorboat. Can occur on hotel premises or at a nearby
waterfront. Most often performed in a lake or ocean.
|
bool
|
bicycles_rental
|
The hotel owns bicycles that it permits guests to borrow and use. Can be
free of charge or for a fee.
|
bool
|
bicycles_rental_for_free
|
The hotel owns bicycles that it permits guests to borrow and use for free.
|
bool
|
watercraft_rental
|
The hotel owns water vessels that it permits guests to borrow and use.
Can be free of charge or for a fee. Watercraft may include boats, pedal
boats, rowboats, sailboats, powerboats, canoes, kayaks, or personal
watercraft (such as a Jet Ski).
|
bool
|
watercraft_rental_for_free
|
The hotel owns water vessels that it permits guests to borrow and use for
free. Watercraft may include boats, pedal boats, rowboats, sailboats,
powerboats, canoes, kayaks, or personal watercraft (such as a Jet Ski).
|
bool
|
beach_access
|
Hotel property is in close proximity to a beach and offers a way to get
to that beach. This can include a route to the beach such as stairs down
if hotel is on a bluff, or a short trail. Not the same as beachfront
(with beach access, the hotel's proximity is close to but not right on
the beach).
|
bool
|
private_beach
|
The beach which is in close proximity to the hotel is open only to guests.
|
bool
|
beach_front
|
Lodging establishment is physically located on the beach alongside an
ocean, sea, gulf, or bay. It is not on a lake, river, stream, or pond.
The hotel is not separated from the beach by a public road allowing
vehicular, pedestrian, or bicycle traffic.
|
Type |
Field |
Definition |
bool
|
transfer
|
Hotel provides a shuttle service or car service to take guests to and
from the nearest airport or train station. May be free or for a charge.
Guests may share the vehicle with other guests unknown to them.
|
bool
|
airport_shuttle
|
Hotel provides guests with a chauffeured van or bus to and from the
airport. May be free or for a charge. Guests may share the vehicle with
other guests unknown to them. Applies if the hotel has a third-party
shuttle service (office/desk etc.) within the hotel. As long as hotel
provides this service, it doesn't matter if it's directly with them or a
third party they work with. Does not apply if guest has to coordinate
with an entity outside/other than the hotel.
|
bool
|
airport_shuttle_for_free
|
Hotel provides guests with a chauffeured van or bus to and from the
airport for free. Must be free to all guests without any conditions.
Guests may share the vehicle with other guests unknown to them.
|
bool
|
local_shuttle
|
A car, van or bus provided by the hotel to transport guests to
destinations within a specified range of distance around the hotel.
Usually shopping and/or convention centers, downtown districts, or
beaches. May be free or for a charge.
|
bool
|
car_rental_on_property
|
A branch of a rental car company with a processing desk in the hotel.
Available cars for rent may be awaiting at the hotel or in a nearby lot.
|
bool
|
private_car_service
|
Hotel provides a private chauffeured car to transport guests to
destinations. Passengers in the car are either alone or are known to one
another and have requested the car together. Service may be free or for a
charge and travel distance is usually limited to a specific range. Not a
taxi.
|
bool
|
private_car_service_for_free
|
Private chauffeured car service is free to guests.
|
Type |
Field |
Definition |
bool
|
mobility_accessible
|
Throughout the property there are physical adaptations to ease the stay of
a person in a wheelchair, such as auto-opening doors, wide elevators,
wide bathrooms or ramps.
|
bool
|
mobility_accessible_parking
|
The presence of a marked, designated area of prescribed size in which
only registered, labeled vehicles transporting a person with physical
challenges may park.
|
bool
|
mobility_accessible_elevator
|
A lift that transports people from one level to another and is built to
accommodate a wheelchair-using passenger owing to the width of its doors
and placement of call buttons.
|
bool
|
mobility_accessible_pool
|
A swimming pool equipped with a mechanical chair that can be lowered and
raised for the purpose of moving physically challenged guests into and
out of the pool. May be powered by electricity or water. Also known as
pool lift.
|