Решения для описаний отелей
Краткое, среднее и полное описание каждого отеля на TR, EN, DE, RU и AR, готовое к продаже.
Фактшит отеля передаёт основные сведения об отеле не свободным текстом, а в отдельных полях, доступных для фильтрации: тип объекта, звёзды, число номеров, время заезда и выезда, пляж и бассейны, правила для детей и животных, рестораны и контакты. Информация от всех поставщиков объединяется под HM ID отеля, противоречащие значения помечаются; данные передаются через API и dump-файлы.
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} Время заезда, правила для детей, тип пляжа и число номеров — отдельные поля, поэтому их можно сразу использовать в фильтрах и сравнении.
Сведения об отеле от всех поставщиков собираются под одним HM ID. Страница отеля не меняется в зависимости от того, от какого поставщика пришёл пользователь.
Если поставщики дают разные значения для одного поля, оно помечается. В ответе видно, какие сведения ждут проверки.
Описания отелей создаются из тех же данных factsheet; текст и поля не противоречат друг другу.
Необработанные сведения об объекте от двух поставщиков
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.
[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz Стандартный factsheet под HM ID
{
"hm_id": "HM-1048213",
"factsheet": {
"check_in": "14:00",
"check_out": "12:00",
"room_count": 412,
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false,
"review_flags": ["check_in", "room_count"]
}
} Это пример данных; отель и коды не относятся к реальному объекту. Поля, по которым поставщики противоречат друг другу (здесь время заезда и число номеров), помечаются в review_flags.
Сведения об отеле из всех записей поставщиков, привязанных к одному HM ID, собираются вместе. Исходные данные хранятся как есть, изменения версионируются.
Время, числа, расстояния и правила из свободного текста преобразуются в отдельные поля; форматы времени, расстояния и возраста стандартизируются.
Если источники дают разные сведения, значения сравниваются. Неоднозначные поля помечаются и попадают в очередь проверки команды данных.
Factsheet возвращается с эндпоинта GET /v1/hotels/{hm_id}/content; весь фонд поступает в ежедневных полных и delta dump-файлах.
Поставщики часто присылают сведения об отеле свободным текстом. Один поставщик пишет время заезда 14:00, другой — 15:00; один указывает 412 номеров, другой — 410. Информация о пляже теряется внутри предложения, возрастная граница для детей приходит в разных форматах. В таком виде нельзя построить фильтры «отели с собственным песчаным пляжем» или «дети 0–6 лет бесплатно».
Фактшит отеля выделяет эти сведения в отдельные поля и привязывает их к HM ID отеля. Обязательное условие — правильное сопоставление отеля; метод описан в руководстве по маппингу отелей, продукт — на странице маппинга отелей.
| Группа | Поля | Пример значения |
|---|---|---|
| Сведения об объекте | Тип объекта, звёзды, сеть и бренд, число номеров и этажей, год открытия и реновации | Резорт, 5 звёзд, 412 номеров |
| Правила | Время заезда и выезда; правила для детей, животных, курения и оплаты | 14:00 / 12:00, дети 0–6,99 лет бесплатно |
| Пляж и бассейн | Тип пляжа, принадлежность отелю, расстояние; число открытых и крытых бассейнов | Песок, собственный, 250 м; 3 открытых, 1 крытый |
| Питание и рестораны | Рестораны, бары, виды кухни, часы работы | Ресторан турецкой кухни, бар у бассейна |
| Контакты и адрес | Проверенный адрес, телефон, e-mail, сайт | [email protected] |
Названия и значения полей не зависят от языка; в интерфейсе вы показываете подпись на своём языке.
Если поставщики дают для одного отеля разные значения, они сравниваются. Неоднозначные поля помечаются в review_flags и проверяются командой данных. Так по ответу видно, какие сведения подтверждены, а какие ждут проверки.
Описания отелей создаются из тех же данных factsheet; время или расстояние в тексте не расходятся со значением в поле. Фотогалерея отеля находится в сервисе фото отелей; если в factsheet у отеля есть пляж, а фото с меткой «пляж» нет, вы можете отправить предупреждение команде контента.
Factsheet передаётся по отелям через REST API, а для всего фонда — ежедневными полными и delta dump файлами. Параметр include и названия полей в примере — черновик API v1; точная схема публикуется на странице для разработчиков. Для информации об охвате и стоимости запросите предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"hm_id": "HM-1048213",
"factsheet": {
"property": { "type": "resort", "stars": 5, "room_count": 412 },
"policies": {
"check_in": "14:00",
"check_out": "12:00",
"child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
"pets_allowed": false
},
"beach": { "type": "sand", "private": true, "distance_m": 250 },
"pools": { "outdoor": 3, "indoor": 1 },
"dining": [
{ "type": "restaurant", "cuisine": "turkish" },
{ "type": "bar", "location": "pool" }
],
"contact": { "email": "[email protected]" },
"review_flags": ["check_in", "room_count"]
},
"updated_at": "2026-11-02T08:14:00Z"
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Это основные сведения об отеле (тип объекта, звёзды, число номеров, время заезда и выезда, правила, питание и рестораны, контакты), представленные в структурированных полях.
Описание — это текст, написанный для чтения; factsheet — отдельные поля для фильтрации и сравнения. Оба основаны на одних и тех же проверенных данных.
Значения сравниваются; неоднозначные поля помечаются и проверяются командой данных. В ответе поля, ожидающие проверки, видны в review_flags.
По отелям — через REST API или для всего фонда — ежедневными полными и delta dump-файлами (CSV, JSON). Для уведомлений об изменениях планируется webhook.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.