Решения для фактшитов отелей

Фактшит отеля передаёт основные сведения об отеле не свободным текстом, а в отдельных полях, доступных для фильтрации: тип объекта, звёзды, число номеров, время заезда и выезда, пляж и бассейны, правила для детей и животных, рестораны и контакты. Информация от всех поставщиков объединяется под HM ID отеля, противоречащие значения помечаются; данные передаются через API и dump-файлы.

Что вы получаете

  • Готов к фильтрации

    Время заезда, правила для детей, тип пляжа и число номеров — отдельные поля, поэтому их можно сразу использовать в фильтрах и сравнении.

  • Один отель, одна правда

    Сведения об отеле от всех поставщиков собираются под одним HM ID. Страница отеля не меняется в зависимости от того, от какого поставщика пришёл пользователь.

  • Противоречия видны

    Если поставщики дают разные значения для одного поля, оно помечается. В ответе видно, какие сведения ждут проверки.

  • Согласован с описаниями

    Описания отелей создаются из тех же данных factsheet; текст и поля не противоречат друг другу.

До и после

Необработанные сведения об объекте от двух поставщиков

supplier_facts.txt
[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

Factsheet HM-1048213
{
  "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.

Как это работает

  1. 1

    Объединение источников

    Сведения об отеле из всех записей поставщиков, привязанных к одному HM ID, собираются вместе. Исходные данные хранятся как есть, изменения версионируются.

  2. 2

    Разбор на поля

    Время, числа, расстояния и правила из свободного текста преобразуются в отдельные поля; форматы времени, расстояния и возраста стандартизируются.

  3. 3

    Проверка противоречий

    Если источники дают разные сведения, значения сравниваются. Неоднозначные поля помечаются и попадают в очередь проверки команды данных.

  4. 4

    Передача и обновление

    Factsheet возвращается с эндпоинта GET /v1/hotels/{hm_id}/content; весь фонд поступает в ежедневных полных и delta dump-файлах.

Почему factsheet в отдельных полях?

Поставщики часто присылают сведения об отеле свободным текстом. Один поставщик пишет время заезда 14:00, другой — 15:00; один указывает 412 номеров, другой — 410. Информация о пляже теряется внутри предложения, возрастная граница для детей приходит в разных форматах. В таком виде нельзя построить фильтры «отели с собственным песчаным пляжем» или «дети 0–6 лет бесплатно».

Фактшит отеля выделяет эти сведения в отдельные поля и привязывает их к HM ID отеля. Обязательное условие — правильное сопоставление отеля; метод описан в руководстве по маппингу отелей, продукт — на странице маппинга отелей.

Поля factsheet

Группа Поля Пример значения
Сведения об объекте Тип объекта, звёзды, сеть и бренд, число номеров и этажей, год открытия и реновации Резорт, 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; точная схема публикуется на странице для разработчиков. Для информации об охвате и стоимости запросите предложение.

Что такое маппинг отелей? Подробное руководство

Пример API

Запрос

Запрос factsheet
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"

Ответ

200 OK
{
  "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 отличается от описания отеля?

Описание — это текст, написанный для чтения; factsheet — отдельные поля для фильтрации и сравнения. Оба основаны на одних и тех же проверенных данных.

Какое значение используется, если поставщики дают разные сведения?

Значения сравниваются; неоднозначные поля помечаются и проверяются командой данных. В ответе поля, ожидающие проверки, видны в review_flags.

В каких форматах можно получать данные factsheet?

По отелям — через REST API или для всего фонда — ежедневными полными и delta dump-файлами (CSV, JSON). Для уведомлений об изменениях планируется webhook.

Запросить предложение

Получите индивидуальное предложение

Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.

  1. 1 Выберите решения
  2. 2 Выберите поставщиков
  3. 3 Оставьте контактные данные