內容參考清單
我們備有參考清單,幫助您進一步了解旅宿內容。
旅宿由提供的 Rapid Content APIs 中的資訊,通常以識別碼 (ID) 的形式呈現。請使用參考清單來查明這些 ID 的含意。
內容參考 API
Rapid Content References API 是一個提供旅宿資訊的資源。相較於使用靜態清單,使用 API 具有以下幾項顯著優勢,包括:
- 透過 API 存取參考資料時,資料將始終保持最新狀態。
- 可透過 API 取得本地化的參考資料,而靜態清單則僅提供英文版本。
參考資料詳情
設施服務
設施是指提供給旅客的各項功能或服務。
在「Rapid 內容 API」中,我們在 amenities 物件內分別為每項設施服務提供了 id、本地化 name 和特定 value (如果適用)。
設施服務可見於旅宿、客房和房價計畫等三個層級,且除非規定載明付費或限制條件,設施服務皆為免費使用。
- 旅宿層級: 所有旅客均可享用相關設施。
- **房型層級:**僅相關客房可使用的設施服務。
- **房價層級:**僅相關房價計畫可使用的設施服務。
「內容 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 內容 API」中,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 內容 API」中,我們在 attributes 物件內,為屬性提供了 id、本地化 name 和特定 value (如果適用)。
屬性可見於旅宿層級,指的是旅宿和住宿的規定和特色。
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 內容 API」中,我們為 category 物件內的旅宿類別提供了 id 和 name。
每家旅宿僅可設定一種旅宿類別,用以代表其所提供的旅宿類型。
「內容 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 |