콘텐츠 참조 목록
숙박 시설 콘텐츠의 이해를 돕는 참조 목록이 제공됩니다.
숙박 시설 Rapid Content API에서 제공하는 정보는 대개 식별자(ID) 형태로 표시됩니다. 참조 목록을 통해 ID의 의미를 이해할 수 있습니다.
콘텐츠 참조 API
Rapid Content References API는 숙박 시설 정보에 대한 리소스입니다. API를 사용하면 정적 목록을 사용할 때와 비교해 다음과 같은 뚜렷한 장점이 있습니다.
- API를 통해 액세스할 경우 참조 데이터는 항상 최신 상태로 제공됩니다.
- API를 통해 현지화된 참조 데이터를 이용할 수 있는 반면, 정적 목록은 영어로만 제공됩니다.
참고 자료 정보
편의 시설
편의 시설이란 여행객이 이용할 수 있는 시설이나 서비스를 말합니다.
Rapid Content API에서는 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 API에서 categories 객체는 편의 시설가 속하는 카테고리를 나타냅니다. 이를 통해 관련 편의 시설을 더 쉽게 그룹화하여 표시, 검색 또는 필터링할 수 있습니다.
콘텐츠 API 응답 예:
{
"12345": {
"property_id": "12345",
...
"amenities": {
"2070": {
"id": "2070",
"name": "Dry cleaning/laundry service",
"categories": [
"drycleaning_and_laundry_services"
]
}
}
}
}| 사용 가능한 카테고리 |
|---|
accessibility |
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 |
spa_services |
swimming_pool |
washer |
water_park |
wifi |
속성
속성은 숙박 시설과 숙박에 적용되는 정책과 특징을 나타냅니다.
Rapid Content API에서는 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 API에서는 id 객체 내에서 숙박 시설 카테고리에 속하는 name 및 category 를 모두 제공합니다.
각 숙박 시설은 제공되는 숙박 시설의 유형을 나타내는 하나의 숙박 시설 카테고리에만 연결됩니다.
콘텐츠 API 응답 예:
"category": {
"id": 1,
"name": "Hotel"
},참조 목록
아래에 나와 있는 숙박 시설 카테고리 목록에서 빠르게 확인할 수 있습니다. 다운로드 파일에서도 제공됩니다.
id | name |
|---|---|
| 0 | 숙박 시설 |
| 1 | 호텔 |
| 2 | 모텔 |
| 3 | 리조트 |
| 4 | 인/여관 |
| 5 | B&B |
| 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 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 개체에 대해 찾아보세요.
각 이미지 범주에는 다음 두 가지 필드가 포함되어 있습니다:
idname
현장 결제 유형
현장 결제 유형은 숙박 시설에서 발생하거나 지불해야 하는 요금을 결제할 수 있는 방법을 나타냅니다.
Rapid Content API에서는 id 객체 내에 포함된 name 객체를 통해, 해당 사이트의 결제 유형에 대한 ‘ types ’ 및 현지화된 ‘ onsite_payments ’ 정보를 제공합니다.
현장 결제 유형은 숙박 시설 수준에 서 사용 가능하며, 숙박 시설에서 발생하거나 지불해야 하는 요금을 결제할 수 있는 방법을 나타냅니다.
콘텐츠 API 응답 예:
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},참조 목록
콘텐츠 참조 목록 파일(위의 내용 참조)에서 onsite_payment_types 개체에 대해 찾아보세요.
각 결제 유형에는 2개의 필드가 포함되어 있습니다:
idname
통계
통계는 층수, 객실 수와 같은 숙박 시설 수준 정보를 나타냅니다.
Rapid Content API에서는 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 API에서는 id 객체 내에서 테마의 name 및 현지화된 버전인 themes 을 모두 제공합니다.
테마는 숙박 시설 수준에서 사용할 수 있으며, 일반적으로 대상이 되는 여행객 유형이나 숙박 시설의 분위기를 나타냅니다. 숙박 시설은 둘 이상의 테마와 연결될 수 있지만, 모든 숙박 시설에 테마가 있는 것은 아닙니다.
콘텐츠 API 응답 예:
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},참조 목록
콘텐츠 참조 목록 파일(위의 내용 참조)에서 themes 개체에 대해 찾아보세요.
각 테마에는 2개의 필드가 포함되어 있습니다:
idname
객실 전망
객실 전망은 해당 객실에서 볼 수 있는 전망을 나타냅니다.
Rapid Content API에서는 id 객체를 통해 액세스할 수 있는 뷰의 name 및 지역화된 views 를 제공합니다.
콘텐츠 API 응답 예:
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},참조 목록
콘텐츠 참조 목록 파일(위의 내용 참조)에서 room_views에 대해 찾아보세요.
각 뷰에는 2개의 필드가 포함되어 있습니다:
idname
사용 언어
사용 언어는 숙박 시설에서 사용되는 언어를 나타냅니다.
Rapid Content API에서는 id 객체를 통해 해당 언어의 spoken_languages 및 현지화된 이름을 제공합니다.
콘텐츠 API 응답 예:
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},참조 목록
콘텐츠 참조 목록 파일에서 spoken_languages에 대해 찾아보세요.
각 언어에는 2개의 필드가 포함되어 있습니다:
idname