內容參考清單
我們備有參考清單，幫助您進一步了解旅宿內容。
Rapid 內容 API 提供的旅宿資訊通常以 ID 顯示。請使用參考清單來查明這些 ID 的含意。
點選下方連結可下載一個 JSON 檔，內容包含前述的參考清單。若想進一步了解個別清單和 JSON 檔的內容，請按一下內容參考清單名稱。供下載的清單僅提供英文版 (參考用)。「內容 API」中會回傳本地化名稱。
最後更新：2024 年 10 月 21 日。
設施服務
設施服務代表提供給旅客的各項設備或服務。
在「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 等物件。
每項設施服務包含三個欄位：
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 物件。
每項屬性包含三個欄位：
idnamehas_value
類別
每家旅宿僅可設定一種旅宿類別，所指的是該旅宿的類型。
在「Rapid 內容 API」中，我們為 category 物件內的旅宿類別提供了 id 和 name。
每家旅宿僅可設定一種旅宿類別，用以代表其所提供的旅宿類型。
「內容 API」回應範例：
"category": {
"id": 1,
"name": "Hotel"
},參考清單
以下為旅宿類別清單，供作參考。在下載的文件中也可找到這份清單。
| 編號 | 名稱 |
|---|---|
| 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 物件。
每個類別包含兩個欄位：
idname
新連鎖 API
連鎖旅宿指的是旗下有多個相關品牌的母公司。
在「Rapid 內容 API」中，我們為 Rapid API 所能辨識的全部連鎖旅宿提供了連鎖旅宿參考對應。
由於連鎖旅宿和品牌時有變更，我們先不列入參考檔案中。若需要最新清單，建議您查詢參考 API。此對應每日更新。
每家旅宿僅可設定一個品牌；品牌則有其隸屬的母公司/連鎖旅宿。
「內容 API」回應範例：
"chain": {
"id": -6,
"name": "Hyatt Hotels"
},
"brand": {
"id": 2209,
"name": "Hyatt Place"
},相片
根據圖片呈現的旅宿部分，按類別來分類圖片。
在「Rapid 內容 API」中，我們針對每張旅宿相片，在 category 欄位提供類別 ID，以及在 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 物件。
每張相片包含三個欄位：
idgroupname
飯店內付款方式
旅宿內付款方式會呈現所產生費用或於旅宿付款時能接受的付款方式。
在「Rapid 內容 API」中，我們為types物件 (位於onsite_payments物件內) 內的旅宿內付款方式提供 id 和本地化 name。
住宿內付款方式見於旅宿層級，指的是住宿內產生的費用可接受的付款方式。
「內容 API」回應範例：
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 onsite_payment_types 物件。
每種付款方式包含兩個欄位：
idname
統計數字
統計數字指的是旅宿層級資料，例如：樓層數和客房數。
在「Rapid 內容 API」中，我們在 statistics 物件內，為統計數字提供了 id、本地化 name 和特定 value (如果適用)。
統計數字可見於旅宿層級，指的是樓層數和客房數等的資料。
「內容 API」回應範例：
"statistics": {
"52": {
"id": 52,
"name": "Total number of rooms -",
"value": "820"
},
"54": {
"id": 54,
"name": "Number of floors -",
"value": "38"
}
},參考清單
您可在「內容參考清單」檔案中找到 statistics 物件。
每個統計數字包含三個欄位：
idnamevalue
主打特色
主打特色指的是目標旅客類型或旅宿整體氣氛。
在「Rapid 內容 API」中，我們為 themes 物件內的主打特色提供了 id 和本地化 name。
主打特色可見於旅宿層級，指的是目標旅客類型或旅宿整體氣氛。一家旅宿可設定一種以上的主打特色，但不見得每家旅宿都有主打特色。
「內容 API」回應範例：
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 themes 物件。
每項主題包含兩個欄位：
idname
客房景觀
客房景觀是指從該客房可看到的景觀。
在「Rapid 內容 API」中，我們提供了 views 物件中客房景觀的 id 和本地化 name。
「內容 API」回應範例：
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},參考清單
您可在「內容參考清單」檔案 (上方) 中找到 room_views。
每個景觀包含兩個欄位：
idname
交談語言
交談語言是指旅宿使用的語言。
在「Rapid 內容 API」中，我們提供了 spoken_languages 物件中所使用語言的 ID 和本地化名稱。
「內容 API」回應範例：
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},參考清單
您可在「內容參考清單」檔案中找到 spoken_languages
每種語言包含兩個欄位：
idname