內容參考清單
我們備有參考清單，幫助您進一步了解旅宿內容。
旅宿 Rapid Content APIs 中提供的資訊通常以識別碼 (ID) 的形式呈現。請使用參考清單來查明這些 ID 的含意。
內容參考 API
Rapid Content References API 是一項提供旅宿資訊的資源。相較於使用靜態清單，使用 API 具有以下幾項顯著優勢，包括：
- 透過 API 存取參考資料時，資料將始終為最新狀態。
- 可透過 API 取得本地化的參考資料，而靜態清單則僅提供英文版本。
參考資料詳情
設施服務
設施是指提供給旅客的各項功能或服務。
在 Rapid Content APIs 中，我們針對id 物件內的每項設施，提供其name、本地化版本value 以及明確的amenities（如適用）。
設施服務可見於旅宿、客房和房價計畫等三個層級，且除非規定載明付費或限制條件，設施服務皆為免費使用。
- 旅宿層級： 所有旅客均可享用相關設施。
- **房型層級：**僅相關客房可使用的設施服務。
- **房價層級：**僅相關房價計畫可使用的設施服務。
「內容 API」回應範例：
"amenities": {
"9": {
"id": 9,
"name": "Fitness facilities"
},
"2820": {
"id": 2820,
"name": "Number of indoor pools -",
"value": 10
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 amenities_property、amenities_rooms 和 amenities_rates 等物件。
每項設施包含 3 個欄位：
idnamehas_value
設施服務類別
設施服務類別允許對相關設施服務進行分組以供顯示、搜尋或篩選。
在 Rapid Content APIs 中，categories 物件用來描述某項設施所屬的類別。這讓您能更輕鬆地將相關的設施分組，以便進行顯示、搜尋或篩選。
「內容 API」回應範例：
{
"12345": {
"property_id": "12345",
...
"amenities": {
"2070": {
"id": "2070",
"name": "Dry cleaning/laundry service",
"categories": [
"drycleaning_and_laundry_services"
]
}
}
}
}| 可用類別 |
|---|
accessibility |
accessible_bathroom |
accessible_parking |
accessible_wheelchair |
air_conditioning |
airport_transfer |
all_inclusive |
bar |
casino |
crib |
dry_cleaning_laundry |
dryer |
electric_charging_station |
free_airport_transfer |
free_all_meals |
free_breakfast |
free_breakfast_1_or_2_guests |
free_dinner |
free_lunch |
free_wifi |
gym |
hot_tub |
kitchen |
meeting_facility |
ocean_view |
parking |
pets_allowed |
restaurant_in_hotel |
spa_services |
swimming_pool |
washer |
water_park |
wifi |
屬性
屬性代表飯店與住宿所適用的規定和特色。
在 Rapid Content APIs 中，我們提供id 物件內該屬性的name、本地化版本value，以及明確版本attributes（如適用）。
屬性可見於旅宿層級，指的是旅宿和住宿的規定和特色。
general：旅宿採用的一般規定。pets：旅宿採用的寵物規定。
「內容 API」回應範例：
"attributes": {
"general": {
"2549": {
"id": 2549,
"name": "No elevators"
},
"3357": {
"id": 3357,
"name": "Caters to adults only"
}
},
"pets": {
"51": {
"id": 51,
"name": "Pets allowed"
},
"2809": {
"id": 2809,
"name": "Dogs only"
}
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 attributes_general 和 attributes_pets 物件。
每個屬性包含 3 個欄位：
idnamehas_value
類型
每家旅宿僅可設定一種旅宿類別，所指的是該旅宿的類型。
在 Rapid Content APIs 中，我們於id 物件內，同時提供旅宿類別的name 與category 兩個連結。
每家旅宿僅可設定一種旅宿類別，用以代表其所提供的旅宿類型。
「內容 API」回應範例：
"category": {
"id": 1,
"name": "Hotel"
},參考清單
以下為旅宿類別清單，供作參考。在下載的文件中也可找到這份清單。
id | name |
|---|---|
| 0 | 旅宿 |
| 1 | 飯店 |
| 2 | 汽車旅館 |
| 3 | 度假村 |
| 4 | 旅店 |
| 5 | 民宿 |
| 6 | 家庭旅館 |
| 7 | 共管公寓 |
| 8 | 全包式住宿 |
| 9 | 木屋 |
| 10 | 山區木屋 |
| 11 | 鄉間房屋 |
| 12 | 青年旅館/背包客住宿 |
| 13 | 牧場 |
| 14 | 別墅 |
| 15 | 郊外小屋 |
| 16 | 出租公寓 |
| 17 | 私人度假屋 |
| 18 | 船屋 |
| 20 | 日式旅館 |
| 21 | 樹屋 |
| 22 | 飯店式公寓 |
| 23 | 公寓式度假村 |
| 24 | 營地 |
| 25 | 摩洛哥特色住宿 |
| 26 | 平價旅館 |
| 29 | 鄉村旅館 |
| 30 | 膳宿旅館 |
| 31 | 葡萄牙古蹟旅館 |
| 32 | 巴西特色住宿 |
| 33 | 法義公寓式飯店 |
| 34 | 義式旅館 |
| 36 | 城堡 |
| 37 | 遊獵營地 |
| 39 | 宮殿 |
| 40 | 觀光農場 |
| 41 | 遊輪 |
| 42 | 度假營地 |
| 43 | 膠囊旅館 |
| 44 | 移動式房屋 |
您可在「內容參考清單」檔案中找到 category 物件。
每個類別包含 2 個欄位：
idname
鏈式引用
連鎖旅宿指的是旗下有多個相關品牌的母公司。
在 Rapid Content API 中，我們提供了所有已識別鏈的鏈參考映射。
由於連鎖店和品牌可能經常變動，因此我們未將其列入參考檔案中。我們建議您查閱參考 API 以取得最新清單。此對應每日更新。
每家旅宿僅可設定一個品牌；品牌則有其隸屬的母公司/連鎖旅宿。
「內容 API」回應範例：
"chain": {
"id": -6,
"name": "Hyatt Hotels"
},
"brand": {
"id": 2209,
"name": "Hyatt Place"
},相片
根據圖片呈現的旅宿部分，按類別來分類圖片。
在 Rapid Content APIs 中，我們針對每張旅宿圖片，將類別 ID 放置於category 欄位中，並將類別名稱放置於caption 欄位中。客房相片也有圖片說明。
「內容 API」回應範例：
"images": [
{
"caption": "Featured Image",
"hero_image": true,
"category": 3,
"links": {
"350px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_b.jpg"
},
"70px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_t.jpg"
},
"1000px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_z.jpg"
}
}
},
]參考清單
您可在「內容參考清單」檔案中找到 images 物件。
每個圖片類別包含 2 個欄位：
idname
飯店內付款方式
旅宿內付款方式會呈現所產生費用或於旅宿付款時能接受的付款方式。
在 Rapid Content APIs 中，我們於id 物件內的name 物件中，提供了站內付款類型的types 以及其本地化版本onsite_payments。
住宿內付款方式見於旅宿層級，指的是住宿內產生的費用可接受的付款方式。
「內容 API」回應範例：
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 onsite_payment_types 物件。
每種付款方式包含 2 個欄位：
idname
統計數字
統計數字指的是旅宿層級資料，例如：樓層數和客房數。
在 Rapid Content APIs 中，我們於id 物件內提供該統計資料的name、本地化版本value，以及明確版本statistics（如適用）。
統計數字可見於旅宿層級，指的是樓層數和客房數等的資料。
「內容 API」回應範例：
"statistics": {
"52": {
"id": 52,
"name": "Total number of rooms -",
"value": "820"
},
"54": {
"id": 54,
"name": "Number of floors -",
"value": "38"
}
},參考清單
您可在「內容參考清單」檔案中找到 statistics 物件。
每項統計資料包含 3 個欄位：
idnamevalue
主打特色
主打特色指的是目標旅客類型或旅宿整體氣氛。
在 Rapid Content APIs 中，我們於id 物件內同時提供該主題的name 以及本地化版本themes。
主打特色可見於旅宿層級，指的是目標旅客類型或旅宿整體氣氛。一家旅宿可設定一種以上的主打特色，但不見得每家旅宿都有主打特色。
「內容 API」回應範例：
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 themes 物件。
每個主題包含 2 個欄位：
idname
客房景觀
客房景觀是指從該客房可看到的景觀。
在 Rapid Content APIs 中，我們提供了可從id 物件取得之檢視的name 以及本地化版本views。
「內容 API」回應範例：
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 room_views。
每個檢視包含 2 個欄位：
idname
交談語言
交談語言是指旅宿使用的語言。
在 Rapid Content APIs 中，我們會從id 物件中提供該語言的spoken_languages 以及其本地化名稱。
「內容 API」回應範例：
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},參考清單
您可在「內容參考清單」檔案中找到 spoken_languages
每種語言包含 2 個欄位：
idname