Решения для маппинга направлений

Маппинг направлений (сопоставление) привязывает локации, которые поставщики присылают на разных уровнях и с разными кодами, к единой иерархии: страна → провинция → район → курортная зона (Турция → Анталья → Серик → Белек). У каждого узла есть постоянный идентификатор (например, TR-07-SERIK-BELEK), привязанные коды направлений поставщиков и коды IATA ближайших аэропортов.

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

  • Поиск «Белек» находит все отели Белека

    Даже если один поставщик присылает отель под Белеком, другой под Сериком, а третий только под Анталье, отель отображается в правильной курортной зоне.

  • Иерархия, соответствующая местному административному делению

    Иерархия объединяет административное деление страны на провинции и районы с курортными зонами, используемыми в туризме. Например, зафиксировано, что Кадрие находится в зоне Белек, а Сиде — в районе Манавгат.

  • Коды поставщиков в одном узле

    Код направления каждого поставщика привязывается к узлу иерархии вместе с информацией о том, какому уровню он соответствует.

  • Связь с аэропортом

    Каждая курортная зона связывается с кодами IATA ближайших аэропортов; поиск пакетов «авиабилет + отель» может использовать те же данные.

До и после

Информация о направлении одного отеля от трёх поставщиков

supplier_destinations.csv
supplier,hotel_code,dest_code,dest_name,country,airport
A,HTL-88213,AYT-BLK,Belek,TR,AYT
B,40917,1452,Serik,Turkey,
C,TR-ANT-551,ANT,Antalya Region,TR,AYT

Локация в единой иерархии

GET /v1/hotels/HM-1048213 (destination)
{
  "hm_id": "HM-1048213",
  "destination_id": "TR-07-SERIK-BELEK",
  "path": [
    { "level": "country", "id": "TR", "name": "Türkiye" },
    { "level": "province", "id": "TR-07", "name": "Antalya" },
    { "level": "district", "id": "TR-07-SERIK", "name": "Serik" },
    { "level": "resort", "id": "TR-07-SERIK-BELEK", "name": "Belek" }
  ],
  "airports": ["AYT"],
  "supplier_destinations": {
    "A": { "code": "AYT-BLK", "level": "resort" },
    "B": { "code": "1452", "level": "district" },
    "C": { "code": "ANT", "level": "province" }
  }
}

Это пример данных; коды отеля и поставщиков вымышлены. Названия зон и аэропортов реальны.

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

  1. 1

    Сбор кодов

    Берутся списки направлений каждого поставщика и поля локации из записей отелей; исходный вид сохраняется.

  2. 2

    Определение уровня

    Определяется, какому уровню — стране, провинции, району или курортной зоне — соответствует каждый код поставщика. «Antalya Region» относится к уровню провинции, «Belek» — к уровню курортной зоны.

  3. 3

    Привязка к иерархии

    Код привязывается к узлу иерархии по схожести названий, многоязычным написаниям и информации о вышестоящем уровне. Привязки, в которых нет уверенности, передаются на проверку эксперту.

  4. 4

    Уточнение локации отеля

    Даже если поставщик присылает только провинцию или район, нижний уровень — курортная зона — определяется по координатам отеля, выбранным из записей поставщиков (проверка координат планируется).

  5. 5

    Доставка

    Иерархия и соответствия кодов доставляются через API и ежедневный dump. В записях отелей возвращаются ID направления и полный путь.

Почему направления не сопоставляются?

Поставщики присылают локацию на разных уровнях. Один указывает отель в Белеке под «Белек», другой — под «Серик», третий — только под «Анталья». Некоторые вообще используют в качестве направления код аэропорта. Без сопоставления поиск «Белек» не находит часть отелей, фильтры по зонам работают неполно, а один и тот же отель отображается в разных зонах.

Маппинг направлений привязывает все эти коды к единой иерархии и присваивает каждому отелю один ID направления. Об общей картине читайте в руководстве по маппингу отелей.

Иерархия

Уровень Пример Идентификатор Примечание
Страна Турция TR Код страны ISO 3166-1
Провинция Анталья TR-07 Код провинции ISO 3166-2 (номер автомобильного кода)
Район Серик TR-07-SERIK Административный район
Курортная зона Белек TR-07-SERIK-BELEK Название зоны, используемое в туризме

Часто встречающиеся сложные случаи

Ситуация Пример Как решается
Название курорта отличается от названия района Сиде находится в районе Манавгат Курортная зона привязывается под правильный район
Населённый пункт внутри зоны Кадрие находится в зоне Белек Код поставщика «Кадрие» привязывается к узлу Белек
Район и курорт носят одно название Кемер; внутри Бельдиби, Гёйнюк, Текирова Кемер хранится и как район, и как зона, а подзоны выделяются отдельно
Несколько аэропортов на одну зону Аланья: AYT и GZP Зона связывается с обоими кодами IATA
Код только на уровне провинции «Antalya Region» Нижний уровень определяется по координатам отеля

ID направления является частью записи отеля, поэтому он работает вместе с маппингом отелей. Чтобы найти HM ID по названию и координатам, Find Match API использует ту же иерархию. В каких странах иерархия доведена до уровня района и курортной зоны, публикуется на странице покрытия. По терминам см. страницы глоссария: HM ID, код поставщика и геокодирование.

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

Пример API

Запрос

GET /v1/destinations/{id}
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"

Ответ

200 OK
{
  "id": "TR-07-SERIK-BELEK",
  "name": "Belek",
  "level": "resort",
  "parent": "TR-07-SERIK",
  "path": ["TR", "TR-07", "TR-07-SERIK", "TR-07-SERIK-BELEK"],
  "names": { "tr": "Belek", "en": "Belek", "ru": "Белек" },
  "airports": ["AYT"],
  "supplier_codes": [
    { "supplier": "A", "code": "AYT-BLK", "level": "resort" },
    { "supplier": "D", "code": "BELEK-01", "level": "resort" }
  ]
}

Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.

Часто задаваемые вопросы

Чем курортная зона отличается от района?

Район — это административная единица, а курортная зона — название региона, используемое в туризме. Белек — курортная зона в районе Серик, а Сиде находится в районе Манавгат. Гость ищет «Белек» или «Сиде», а поставщик чаще всего присылает район или провинцию.

В какую зону попадёт отель, если поставщик присылает только провинцию?

Сначала отель привязывается к HM ID с помощью маппинга отелей. Затем по координатам, выбранным из записей поставщиков, определяется, в каком районе и курортной зоне он находится; проверка координат планируется. Код провинции от поставщика также отдельно сохраняется в записи.

Почему коды IATA привязаны к направлению?

Поиск пакетов «авиабилет + отель» начинается с аэропорта прибытия. Одну курортную зону могут обслуживать несколько аэропортов; например, для Аланьи можно использовать и AYT, и GZP. Благодаря этой связи поиск может перейти от аэропорта к отелям в этой зоне.

В каких странах уже готова детализация до района и курортной зоны?

Уровни района и курортной зоны планируется завершить сначала для Турции (Анталья, Мугла, Стамбул), ОАЭ и Египта. Актуальные сведения о том, в каких странах эта детализация уже завершена, публикуются на странице покрытия.

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

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

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

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