Решения для маппинга номеров
Разбирает названия номеров на тип, класс, вид, кровать и вместимость; один номер — один ID.
Контент номеров добавляет к каждому стандартному типу номера, возникшему при маппинге (например, HM-1048213-R03), многоязычное описание и структурированные сведения: площадь, максимум взрослых и детей, дополнительная кровать, расположение кроватей, вид и удобства номера. Гость чётко видит, что покупает. Продукт скоро будет запущен; для раннего доступа оставьте заявку на странице запроса предложения.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} Контент относится не к общему описанию отеля, а к продаваемому типу номера; он приходит вместе со стандартным идентификатором номера.
Описания номеров готовятся на турецком, английском, немецком, русском и арабском.
Вместимость и расположение кроватей приходят в отдельных полях; их можно сразу использовать в фильтрах и проверках размещения.
Описания быстро создаются ИИ, редакторы их проверяют.
Сведения об одном номере от трёх поставщиков
supplier,hotel_code,room_code,room_info
A,HTL-88213,DBLSV-B,"Sea view room, 28 m2, max 3 pax"
B,40917,DZMB,"Zimmer ca. 28 qm, Meerblick, Balkon, Klimaanlage"
C,TR-ANT-551,STD-DNZ,"Deniz manzaralı balkonlu oda, 2 yetişkin + 1 çocuk, minibar" Контент номера под стандартным типом номера
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} Это пример данных; отель, сведения о номере и коды не относятся к реальному объекту. Названия полей — черновик API v1.
Маппинг номеров привязывает названия номеров поставщиков к стандартному идентификатору номера, связанному с HM ID отеля.
Площадь, вместимость, расположение кроватей и вид собираются из всех источников и преобразуются в отдельные поля.
ИИ создаёт краткое и полное описание для конкретного типа номера; редакторы проверяют его.
Контент номера приходит вместе со стандартным идентификатором номера в ответе API и в файле для массовой загрузки.
На экране выбора номера гость чаще всего видит только название номера и цену. Чтобы понять разницу между «стандартным» и «улучшенным» номером, сколько человек он вмещает и есть ли балкон, ему приходится читать общее описание отеля. Поставщики присылают эти сведения в разных форматах: один пишет «28 m2, max 3 pax», другой прячет площадь внутри немецкого свободного текста, третий не указывает её вовсе.
Контент номеров собирает эти сведения в одну запись для каждого стандартного типа номера. Продукт скоро будет запущен; эта страница описывает, как он будет работать, а поля и эндпоинты в примерах — черновик API v1.
Контент номеров использует стандартные идентификаторы номеров, получаемые в результате маппинга номеров. Поскольку «Dbl Sea View Balcony», «DZ Meerblick Balkon» и «Standart Oda Deniz Manzaralı Balkonlu» привязаны к одному идентификатору, сведения трёх поставщиков объединяются в одном номере. О том, как стандартизируются типы номеров, читайте в руководстве что такое маппинг номеров, а общую картину — в руководстве по маппингу отелей.
| Поле | О чём говорит | Пример |
|---|---|---|
| Описание номера | Краткий и полный текст для конкретного типа номера | TR, EN, DE, RU, AR |
| Площадь | Размер номера | 28 м² |
| Вместимость | Максимум взрослых и детей, дополнительная кровать | 2 взрослых + 1 ребёнок |
| Расположение кроватей | Тип кровати | Двуспальная, две раздельные |
| Вид и расположение | Что видно из окна, где находится номер | Вид на море, этаж с садом |
| Удобства номера | Стандартные коды удобств | Балкон, кондиционер, мини-бар |
Удобства номера берутся из того же словаря, что и в продукте удобства отелей. При совместном использовании с фото номеров описание, размеры и фотографии объединяются под одним идентификатором номера. Для термина см. страницу словаря маппинг номеров.
Для раннего доступа, информации об охвате и стоимости запросите предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=content&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda."
}
}
]
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Контент номеров скоро будет запущен; точная дата пока не объявлена. Для раннего доступа напишите нам на странице запроса предложения.
Да. Контент привязывается к стандартному идентификатору номера, который даёт маппинг номеров. Пока типы номеров не стандартизированы, сведения разных поставщиков нельзя объединить в одном номере.
Многоязычное краткое и полное описание номера, площадь, максимум взрослых и детей, дополнительная кровать, расположение кроватей, вид и удобства номера.
Удобства номера берутся из того же стандартного словаря, что и в продукте «Удобства отелей». Поэтому удобства типа номера и список удобств отеля используют одни и те же коды.
Нет. Контент номеров — это статические данные о номере. Цена и наличие приходят от поставщика в вашу систему.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.