Решения для маппинга номеров
Разбирает названия номеров на тип, класс, вид, кровать и вместимость; один номер — один ID.
Фото номеров привязывает фотографии, которые поставщики присылают для каждого номера, к стандартным типам номеров, созданным при маппинге номеров (например, HM-1048213-R03). Так каждое предложение номера показывается со снимками именно этого номера, а не с общей галереей отеля. Одна и та же фотография от разных поставщиков группируется в одно изображение, а изображения возвращаются из API вместе с данными номера.
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} Предложение номера с видом на море и балконом показывается с фотографиями этого номера; гостю не нужно искать свой номер в общей галерее отеля.
Фотографии, которые три поставщика присылают для одного номера, собираются под единым идентификатором номера, созданным при маппинге номеров.
Копии одной фотографии номера, пришедшие от разных поставщиков и разных размеров, группируются под одним изображением.
Изображения приходят в том же ответе, что и тип номера, вид, кровать и вместимость; отдельный шаг сопоставления не нужен.
Фотографии номеров от трёх поставщиков
supplier,hotel_code,room_code,room_name,image_url,width
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony,https://img.supplier-a.example/88213/rooms/dblsv-1.jpg,1920
B,40917,DZMB,DZ Meerblick Balkon,https://cdn.supplier-b.example/40917/zimmer/dzmb_01.jpg,1024
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1),https://media.supplier-c.example/551/IMG_3101.jpg,800
B,40917,FZLS,FZ Landseite,https://cdn.supplier-b.example/40917/zimmer/fzls_01.jpg,1024 Изображения, привязанные к стандартным типам номеров
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"images": [
{
"image_id": "HM-1048213-R03-I001",
"copies": [
{ "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
{ "supplier": "B", "room_code": "DZMB", "width": 1024 }
]
},
{
"image_id": "HM-1048213-R03-I002",
"copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
}
]
},
{
"room_id": "HM-1048213-R07",
"name": "Standard Family Room, Land View",
"images": [
{
"image_id": "HM-1048213-R07-I001",
"copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
}
]
}
]
} Пример данных; отель, названия номеров, коды и адреса изображений не относятся к реальному объекту.
Коды номеров поставщиков связываются через маппинг номеров со стандартными идентификаторами номеров, привязанными к HM ID отеля.
Фотографии, которые поставщик присылает с кодом номера, собираются под стандартным идентификатором номера, с которым связан этот код.
Для каждого изображения вычисляется отпечаток по содержимому; копии одной фотографии номера от разных поставщиков группируются в одно изображение.
Изображения, группы копий и коды номеров поставщиков возвращаются в ответе API вместе с данными номера.
Когда на странице отеля перечислено пять предложений номеров, большинство систем показывает рядом с каждым одну и ту же общую галерею. Выбирая номер с видом на море и балконом, гость видит фотографию бассейна или лобби; чтобы понять, как выглядит семейный номер, ему приходится листать галерею целиком. Поставщики чаще всего присылают фотографии номеров со своими кодами номеров, но у каждого поставщика эти коды разные.
Фото номеров привязывает эти фотографии к стандартным типам номеров, которые получаются в результате маппинга номеров. Поскольку «Dbl Sea View Balcony», «DZ Meerblick Balkon» и «Standart Oda Deniz Manzaralı Balkonlu» привязаны к одному идентификатору номера, фотографии всех трёх поставщиков собираются в одном номере. О том, как стандартизируются типы номеров, читайте в руководстве что такое маппинг номеров, а об общей картине — в руководстве по маппингу отелей.
| Фото отелей | Фото номеров | |
|---|---|---|
| К чему привязываются | HM ID отеля | Стандартный идентификатор номера (например, HM-1048213-R03) |
| Что включают | Фасад, лобби, бассейн, пляж, ресторан, спа, общие зоны | Фотографии этого типа номера |
| Предварительное условие | Маппинг отелей | Маппинг отелей и маппинг номеров |
| Обнаружение дублей | Внутри галереи отеля | Внутри типа номера |
| Передача | Ответ с контентом отеля и dump | Ответ с данными номера |
Об общей галерее отеля см. сервис фото отелей. Когда оба сервиса используются вместе, страница отеля показывает общую галерею, а каждое предложение номера — собственные фотографии.
Несколько поставщиков могут прислать одну и ту же фотографию номера другого размера или сжатия. Для каждого изображения вычисляется отпечаток по содержимому, и одинаковые кадры внутри одного типа номера группируются под одним изображением. В ответе для каждого изображения указаны число копий и код номера поставщика, от которого они пришли.
Изображения работают на тех же HM ID и идентификаторах номеров, что и контент отелей и данные маппинга номеров. Конечная точка GET /v1/hotels/{hm_id}/rooms?include=images и поля ответа в примере — черновик API v1; окончательная схема будет опубликована на странице для разработчиков. Об объёме и стоимости можно запросить предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"view": "sea",
"bed": "double",
"max_occupancy": 3,
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" },
"images": [
{
"image_id": "HM-1048213-R03-I001",
"url": "https://img.supplier-a.example/88213/rooms/dblsv-1.jpg",
"width": 1920,
"copy_count": 2
},
{
"image_id": "HM-1048213-R03-I002",
"url": "https://media.supplier-c.example/551/IMG_3101.jpg",
"width": 800,
"copy_count": 1
}
]
}
]
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Да. Фотографии привязываются к стандартным идентификаторам номеров, созданным при маппинге номеров. Пока типы номеров не стандартизированы, фотографии, которые разные поставщики присылают для одного номера, невозможно собрать вместе.
Фото отелей — это общая галерея отеля: фасад, лобби, бассейн, пляж, ресторан, спа и общие зоны. Фото номеров — это фотографии, которые привязываются отдельно к каждому стандартному типу номера. Это два отдельных сервиса.
Фото номера привязывается к типу номера по коду номера, с которым поставщик прислал фотографию. Фотографии без кода номера ни к какому типу номера не привязываются; фотографии, пришедшие на уровне отеля, обрабатывает сервис фото отелей.
Нет. Фото номеров — часть статических данных номера. Цена и наличие приходят от поставщика в вашу систему; мы лишь сообщаем, к какому номеру относится предложение, и отдаём изображения этого номера.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.