Static Data Information

STATIC DATA UPDATES

All static data, especially item information, must be stored on your local server and should be updated at least once a month.

In order to retrieve the static data for our hotel inventory we recommend using the Item Information Download request which provides the client with a single zip file containing multiple XML files. It is possible to request a file for a complete download of all our static data, a file for incremental updates; e.g.: last week, or a file for yesterday’s incremental updates. Specifications for this new functionality can be found in chapter 34 of the Static Data documentation.

Alternatively, and to download the static data for sightseeing tours and transfers, we suggest you write a small program that enables you to first retrieve all country codes (using the <SearchCountryRequest>), then uses the country codes to retrieve all city codes (using the <SearchCityRequest>), then uses the city codes to retrieve all item codes (using the <SearchItemRequest>) and finally uses the item codes to retrieve all item information (using the <SearchItemInformationRequest>).

If you use this method we suggest that when sending asynchronous requests to us, you wait until you have received a response for your first request before sending the second request.

Another and more efficient solution to collect and update the static data would be to store it locally with a "last updated" timestamp. If a customer requests any item information the local database should be checked. If the item information is present and the timestamp is not older than a set number of days (we would propose 30 days) the information from the local data base is retrieved. If the item information is not present or if the timestamp is older than 150 days, the item information is requested from our server and saved in your local database with an updated timestamp.

We may also inform you of major changes to the information (e.g.: a change in category or star rating) by email and we would suggest that you then update this specific item immediately.

Both methods of downloading static data, the <SearchItemInformationRequest> and the <ItemInformationDownloadRequest>, can be used in conjunction or independently from each other.

DELETION/REMOVAL OF ITEM CODES

We do not provide any files or reports to advise of inactive item codes. The reason for this is that on most occasions where we stop working with a particular property, tour company or transfer provider, this is only temporary and at some stage (often rather sooner than later) we will resume our cooperation with the relevant provider and include them again in our inventory offers. There is no need to remove these item codes from your data base as they will simply not surface when performing price and availability searches during this time. Once they become active again you will immediately be able to use them again without the need to re-map these item codes.

LANGUAGE CODES FOR ITEM INFORMATION

Following is a list of languages and their codes (ISO 639-1 format) which are supported via our XML API:

Language Code

Language Name
AR ARABIC
ZH CHINESE SIMPLIFIED
ZZ CHINESE TRADITIONAL
EN ENGLISH
FR FRENCH
DE GERMAN
IW HEBREW
IT ITALIAN
JA JAPANESE
KO KOREAN
RU RUSSIAN
ES SPANISH
TH THAI

Please refer to the API Architecture specifications, section 3.3.2 for information about the parameter that needs to be populated with the relevant ISO language code to retrieve the item information in the required language.

While we aim to provide all our item information in these languages there will always be new properties or changes to the information for existing contracts for which the translations have not yet been processed at the time you retrieve it. If the translation for a particular language has not been completed the information will be returned in English instead of the requested language.

IMAGES AND RICH MEDIA

We are sourcing our images and rich media from VFM Leonardo, Inc. and as such are obliged to ensure that all third party users are adhering to their terms and conditions which are as follows:

  • All of the licensed content must display the correct attribution. Please refer to the screen shot below for an example. that you MUST display ‘Image from VFM Leonardo, Inc.’ at least once on each page that displays property images that you retrieve through our XML API.
  • If you are able to display rich media / moving media this will need to be displayed together with the images and also carry the attribution ‘Media from VFM Leonardo, Inc.’
  • You need to ensure that all images are updated no less frequently than once a month.
  • The tab or section where the property images are being displayed should be headed ‘Photos’. If multi-media is displayed along-side the hotel images the tab or section can be named ‘Photos & Videos’ or ‘Multimedia’.

Your commercial agreement with GTA will include a clause referring to these four points to which you will have to agree to in order to obtain VFM images and multi-media through us.

LOCATIONS

A business decision has been made to discontinue the use of the <SearchLocationRequest>.

In recent developments the use of many of the codes has become less relevant and less maintained, and as a result of this we will be deleting the majority of them from the API.

 We will be keeping only four location codes:

• G1 = Central

• G2 = Airport

• G5 = Waterfront/Beach

• G9 = Outside Centre 

All of our other generic location codes will be re-mapped as follows:

• G3 = Station mapped to ‘G1=Central’

• G4 = Port mapped to ‘G9=Outside Centre’

• G6 = Countryside mapped to ‘G9=Outside Centre’

• G7 = Mountainside mapped to ‘G9=Outside Centre’

• G8 = Suburbs mapped to ‘G9=Outside Centre’

 Please be aware that we will not be re-mapping city specific location codes such as: 15= Holborn, 16= Battersea, 17= Sloane Sq / Kings Road, etc. These codes will be completely eradicated.

 Note that regardless of the discontinuation of the SearchLocationRequest you will still be able to send a SearchHotelPriceRequest filtering with the use of the above four generic location codes.

STAR RATINGS FOR HOTELS

Hotel-star ratings are used to symbolise the overall quality, level of service, food standard and range of facilities available in any given property. The criteria applied within each country will vary depending on the specific requirements established by the relevant issuing body and some countries do not at all use star ratings for official categorisation of accommodation but the below outlines will give a general understanding of what can typically be expected within each banding.  

1-star:            The majority will be small, independently owned properties. There is likely to be a limited range of meals and facilities.

2-star:            Varying from small to medium sized properties offering more extensive facilities. Reception and staff will aim for a more professional presentation than at one star level and a wider range of services, including food and drink is likely to be found. Some rooms may be provided with                              en-suite facilities but this is not guaranteed.

3-star:            Hotel properties will usually be of a size to support higher staffing levels and with a greater quality and range of facilities. Reception and public areas will be more spacious. All bedrooms should come with en-suite facilities and room service may be available.

4-star:            At this level there should be a noticeable difference in the degree of quality in the furnishings, décor and equipment. Bedrooms are usually more spacious than those found in lower starred properties. Services such as 4’-hour room service, laundry and dry cleaning may be                                          available.

5-star:            These properties should provide spacious and luxurious accommodation throughout the Hotel. Formal service and flawless attention to the guests’ requirements should be provided.

 In a minority of cases we are not permitted by the hotels to output any star rating as these properties do not follow the numerical star rating and have their own categorisation. Since our systems require an entry to be added in numerical format for the star rating field, we are currently displaying these properties with a ‘-1’ star rating.

 MEAL BASIS INFORMATION FOR HOTELS

Meal basis information for hotels is NOT part of the static data. The meal basis is part of the rate plans and any property can offer any number of different rate plans, some of which may only be available during certain periods of the year. Therefore meal basis information for hotels is only supplied with price and availability responses; e.g.:

<SearchHotelPriceResponse>
    <HotelDetails>
        <Hotel
            HasExtraInfo = "true"
            HasMap = "true"
            HasPictures = "true">
            <City Code = "SSH"><![CDATA[Sharm El Sheikh]]></City>
            <Item Code = "PAR2"><![CDATA[Sunset Partner]]></Item>
            <LocationDetails>
                <Location Code = "G9"><![CDATA[Outside Centre]]></Location>
            </LocationDetails>
            <StarRating>3</StarRating>
            <HotelRooms>
                <HotelRoom Code = "DB" NumberOfRooms = "1"/>
            </HotelRooms>
            <RoomCategories>
                <RoomCategory Id = "001:PAR1">
                    <Description><![CDATA[Standard]]></Description>
                    <ItemPrice Currency = "EUR">32.00</ItemPrice>
                    <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                    <Meals>
                        <Basis Code = "D"><![CDATA[breakfast and dinner]]></Basis>
                        <Breakfast Code = "F"><![CDATA[Full]]></Breakfast>
                    </Meals>
                </RoomCategory>
                <RoomCategory Id = "001:PAR2">
                    <Description><![CDATA[Standard]]></Description>
                    <ItemPrice Currency = "EUR">27.50</ItemPrice>
                    <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                    <Meals>
                        <Basis Code = "B"><![CDATA[Breakfast]]></Basis>
                        <Breakfast Code = "F"><![CDATA[Full]]></Breakfast>
                    </Meals>
                </RoomCategory>
                <RoomCategory Id = "001:SUN3">
                    <Description><![CDATA[Standard]]></Description>
                    <ItemPrice Currency = "EUR">53.00</ItemPrice>
                    <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                    <Meals>
                        <Basis Code = "I"><![CDATA[All Inclusive]]></Basis>
                        <Breakfast Code = "F"><![CDATA[Full]]></Breakfast>
                    </Meals>
                </RoomCategory>
            </RoomCategories>
        </Hotel>
    </HotelDetails>
</SearchHotelPriceResponse>

Location Codes

LOCATION CODE ENGLISH FRENCH GERMAN ITALIAN SPANISH SWEDISH
  EN FR DE IT ES SW
G1 Central Central Zentral Centrale Céntrico Central
G2 Airport Aeroport Flughafen Aeroporto Aeropuerto Huvudflygplats
G5 Beach/Waterfront Front de Mer/Plage Ufer/Strand Spiaggia Frente al Mar/Playa Centralt hamnområde/Strandområde
G9 Outside Centre Alentours Ausserhalb des Stadtzentrums Fuori dal centro Area Suburbana Utanför stadskärnan


Facility Codes

HOTEL
FACILITY
CODES
FACILITY CODE ENGLISH ARABIC      CHINESE SIMPLIFIED CHINESE TRADITIONAL FRENCH GERMAN HEBREW ITALIAN JAPANESE KOREAN RUSSIAN SPANISH THAI SWEDISH
  EN AR ZH ZZ FR DE IW IT JA KO RU ES TH SW
*BC Business centre مركز للأعمال 商务中心 商務中心 Centre d''affaires Businesszentrum מרכז עסקים Business centre ビジネスセンター 비지니스 센터 Бизнес-центр Centro de negocios ศูนย์กลางย่านธุรกิจ Konferens-/utställnings- centrum
*BP Beauty parlour صالون تّجميل 美容院 美容中心 Salon de beauté Kosmetiksalon סלון יופי Salone di bellezza 美容サロン 미용실 Салон красоты Salón de belleza ห้องเสริมสวย Skönhetssalong
*BQ Boutique بوتيك 精品店 時裝精品店 Boutique Boutique בוטיק Boutique ブティック 부티크(미용,악세사리점) Бутик Boutique บูติค Butik
*BS Baby sitting مجالسة الأطفال 婴儿托管 嬰兒托管服務 Garde d'enfants Babysitting שמרטפות Servizio baby-sitter 託児施設/ベビーシッター 탁아시설 Присмотр за детьми Cuidado de niños บริการเลี้ยงเด็ก Barnvaktservice
*CP Car parking (Payable to hotel, if applicable) (موقف سيارات( مدفوع الأجر إلى الفندق اذا تواجد 停车费(直接付给酒店) 停車費(直接付給酒店) Parking (à payer à l'hôtel, quand nécessaire) Parkplatz (zahlbar im Hotel, wo zutreffend) חניה (בתשלום למלון, במידה ויידרש) Parcheggio per la vettura (da pagare all'hotel, qualora applicabile) 駐車サービス(有料の場合はホテルに支払ってください) 주차 (유료일 경우 호텔 직불) Автомобильная стоянка (оплачивается в гостинице, если доступна) Aparcamiento (A pagar en el hotel, si se aplica) บริการที่จอดรถ (จ่ายเงินกับทางโรงแรม, หากใช้บริการ) Parkeringsplats (Avgift betalas till hotell)
*CR Car rental facilities خدمات تأجير السيارات 租车服务 租借汽車設施 Location de voitures Mietwagenagentur שירותי השכרת רכב Autonoleggio レンタカー 렌터카 Услуги по прокату автомобилей Servicio de Alquiler de coche บริการรถเช่า Biluthyrning
*DF Disabled facilities تسهيلات خاصة بالمعوقين 残疾人设施 殘障人士/無障礙設施 Equipé pour handicapés Behindertengerechte Einrichtung נגישות לנכים Servizi per disabili 障害者用設備 장애자용 시설 Удобства для инвалидов Accesible para minusválidos สิ่งอำนวยความสะดวกสำหรับผู้ที่พิการ Handikappsfaciliteter
*EC Early check-in التفقد المبكر 提前入住 提前入住 Arrivée tôt Zeitige Anreise רישום כניסה מוקדם Check-in anticipato アーリーチェックイン 일찍 체크인 하겠습니다. Ранняя регистрация въезда Registro temprano สามารถเข้าพักได้เร็วสุดเวลา Tidig incheckning
*GF Golf ملعب للغولف 高尔夫 高爾夫球 Golf Golf גולף Golf ゴルフ 골프장 Гольф Golf กอล์ฟ Golf
*GY Gymnasium صالة تمارين رياضية 健身房 健身室 Salle de sports Sporthalle חדר כושר Palestra ジム 체육관 Спортивный зал Gimnasio ห้องบริหารร่างกาย Gym
*HP Coach parking موقف للحافلات 旅游巴士停车场 旅遊巴士停泊處 Parking pour bus Parkplatz für Reisebusse חניה לאוטובוסים Parcheggio pullman バス駐車場 코치 주차장 Стоянка для автобусов Aparcamiento de Autobuses ที่จอดรถขนาดใหญ่ Bussparkering
*IP Indoor pool حوض سباحة داخلي 室内游泳池 室内游泳池 Piscine Couverte Innen-Swimmingpool בריכה מקורה Piscina coperta 屋内プール 실내 수영장 Плавательный бассейн внутри Piscina interior climatizada สระน้ำในร่ม Inomhus pool
*KP Children's pool حوض سباحة للأطفال 儿童游泳池 兒童游泳池 Piscine pour Enfants Kinderbecken בריכת ילדים Piscina per bambini 子供用プール 어린이 수영장 Бассейн для детей Piscina infantil สระน้ำเด็ก Barn pool
*LF Lifts المصاعد 电梯 電梯 Ascenceurs Fahrstühle מעליות Ascensori エレベーター 승강기 Лифты Ascensores ลิฟท์ Hissar
*LS Lobby الاستقبال 大堂 大廳 Entrée Lobby לובי Ingresso ロビー 로비 Лобби Vestíbulo ล็อบบี้ Lobby
*LY Laundry facilities خدمات تنظيف و كي الألبسة 洗衣服务 洗衣店設施 blanchisserie Wäscherei שירותי כביסה Servizio lavanderia ランドリーサービス 세탁시설 Услуги прачечной Servicio de lavandería บริการซักรีด Tvättmöjligheter
*PT Porterage الحمّال 行李搬运服务 行李搬運服務 Porteur Portierservice שוער Facchinaggio ポーター 포터서비스 Услуги носильщиков Servicio de maletero บริการยกกระเป๋า Portvakt
*OP Outdoor pool حوض سباحة خارجي 室外游泳池 室外游泳池 Piscine Découverte Freiluft-Swimmingpool בריכה חיצונית Piscina all'aperto 屋外プール 실외 수영장 Плавательный бассейн на открытом воздухе Piscina al aire libre สระน้ำกลางแจ้ง Utomhus pool
*RS Room Service خدمة الغرف 客房服务 客房餐飲服務 Service d'étages Zimmerservice שירות חדרים Servizio in camera ルームサービス 룸서비스 Обслуживание в номерах Servicio de habitaciones บริการอาหารที่ห้องพัก Rumservice
*SA Sauna ساونا 桑拿浴 三溫暖 Sauna Sauna סאונה Sauna サウナ 사우나 Сауна Sauna เซาว์น่า Bastu
*SH Shop متجر للتسوق 商店 商店 Magasin Shop חנות Negozio ショップ 상점 Магазин Tienda ร้านค้า Affär
*SO Solarium سولاريوم 日光浴室 日光浴室 Solarium Solarium מרפסת שמש Solarium 日焼けルーム 일광욕실 Солярий Solarium ห้องเรือนกระจก สำหรับอบตัว Solarium
*TA Travel agency facilities مكتب سفريات 旅行社设施 旅遊服務設施 Agence de voyages Reiseagentur שירותי סוכנות נסיעות Agenzia di viaggio in loco 旅行代理店 여행사 Услуги туристического агентства Servicio de Agencia de Viajes บริการบริษัทตัวแทนท่องเที่ยว Resebyrå
*FL Floors  طوابق  层楼  層樓 Étages Etagen  קומות Piani  フロア 층수 : 층 этажей Plantas ชั้น Våningar
*TE Tennis ملعب تنس 网球 網球 Tennis Tennis טניס Tennis テニスコート 테니스장 Теннис Tenis เทนนิส Tennis

 

 

ROOM
FACILITY
CODES
FACILITY CODE ENGLISH ARABIC      CHINESE SIMPLIFIED CHINESE TRADITIONAL FRENCH GERMAN HEBREW ITALIAN JAPANESE KOREAN RUSSIAN SPANISH THAI SWEDISH
*AC  Air conditioning تكييف 空调 空調設施 Climatisation Klimaanlage מיזוג אוויר Aria condizionata エアコン 에어컨디셔너 Кондиционирование Aire acondicionado เครื่องปรับอากาศ Luftkonditionering
*AW Automatic wake-up call خدمة الإيقاظ الآلي 自动叫醒电话 自動醒床傳訊 Réveil automatique Automatischer Weckruf השכמה אוטומטית Servizio di sveglia automatica モーニングコール 자동알람 Атоматический звонок для пробуждения Servicio de despertador โทรศัพท์ปลุกอัตโนมัติ Automatiskt väckning
*DD  Direct dial phone خط هاتفي مباشر 直拨电话 直撥電話 Ligne de téléphone directe Durchwahltelefon טלפון בחיוג ישיר Linea telefonica diretta 直通電話 직통전화 Прямой телефон Teléfono directo โทรศัพท์สายตรง Direkttelefon
*FI  In-house movie قناة خاصة بالأفلام 室内付费电影 付費電影 Sélection de vidéos Film vor Ort סרטים במעגל סגור Pay tv in camera インハウス映画 비디오시설 Внутренний кино-канал Película de video ภาพยนต์ทางโทรทัศน์ Intern bio
*HD Hairdryer مجفف شعر 吹风机 吹風機 Sèche-cheveux Haartrockner מייבש שיער Asciugacapelli ドライヤー(フロントにて貸出しの場合がございます) 헤어드라이어 Фен Secador de pelo เครื่องเป่าผม] Hårtork
*IN Internet via television انترنت عبر التلفاز 通过电视机连接因特网 可連接網路的電視 Internet sur la télévision Internet über TV אינטרנט באמצעות טלוויזיה Internet dalla tv インターネット機能付きテレビ 인터넷 Доступ к интернету через телевидение Internet por televisión อินเตอร์เน็ตผ่านโทรทัศน์ Internet via television
*LT Connection for laptop وصلة الكمبيوتر المحمول 连接笔记本电脑 連接手提電腦 Connexion pour ordinateur Anschluss für Laptop חיבור למחשב נייד Connessione laptop インターネット接続(詳細は直接ホテルへお問い合わせください) 랩탑컴퓨터 연결선 Соединение для переносных компьютеров Conexión para portátil เชื่อมต่อกับคอมพิวเตอร์แล็บท็อป Anslutning för laptop
*MB  Mini bar بار صغير 迷你酒吧 迷你酒吧 Mini-bar Minibar מיני בר Mini bar ミニバー 미니 바 Мини-бар Mini bar มินิบาร์ Minibar
*RA Radio راديو 收音机 收音機 Radio Radio רדיו Radio ラジオ 라디오 Радио Radio วิทยุ Radio
*SV Satellite television قنوات فضائية 卫星电视 衛星電視 Télévision satellite Satellitenfernsehen צלחת לוויין Televisione satellitare 衛星放送テレビ 위성 텔레비젼 Спутниковое телевидение Televisión por satélite โทรทัศน์ผ่านดาวเทียม Parabolantenn
*TP Trouser press مكواة للبنطال 裤子烫板 褲管摺線熨製器 Presse à pantalons Bügelpresse מגהץ מכנסיים Stirapantaloni ズボンプレス 다리미 Пресс для брюк Plancha para trajes เครื่องอัดกางเกงขายาว Byxpress
*TV  Television تلفاز 电视机 電視機 Télévision Fernsehen טלוויזיה Televisione テレビ 텔레비젼 Телевидение Televisión โทรทัศน์ Television
*VL  Voltage الفولط 电压 伏特數 Voltage Elektrische Spannung מתח Voltage 電圧 전압 Электрическое напряжение Voltaje โวลท์ (Voltage) Spänning

 

GTA Property List

We will download our static data on the 1st of every month and input this into an Excel file, for your reference. Please view the Static Data Mapping page.

 

 

 

Docs Navigation