Решения для маппинга отелей
Постоянный HM ID для каждого объекта; коды поставщиков и перекрёстные ID в одной записи.
Маппинг направлений (сопоставление) привязывает локации, которые поставщики присылают на разных уровнях и с разными кодами, к единой иерархии: страна → провинция → район → курортная зона (Турция → Анталья → Серик → Белек). У каждого узла есть постоянный идентификатор (например, TR-07-SERIK-BELEK), привязанные коды направлений поставщиков и коды IATA ближайших аэропортов.
{
"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" }
}
} Даже если один поставщик присылает отель под Белеком, другой под Сериком, а третий только под Анталье, отель отображается в правильной курортной зоне.
Иерархия объединяет административное деление страны на провинции и районы с курортными зонами, используемыми в туризме. Например, зафиксировано, что Кадрие находится в зоне Белек, а Сиде — в районе Манавгат.
Код направления каждого поставщика привязывается к узлу иерархии вместе с информацией о том, какому уровню он соответствует.
Каждая курортная зона связывается с кодами IATA ближайших аэропортов; поиск пакетов «авиабилет + отель» может использовать те же данные.
Информация о направлении одного отеля от трёх поставщиков
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 Локация в единой иерархии
{
"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" }
}
} Это пример данных; коды отеля и поставщиков вымышлены. Названия зон и аэропортов реальны.
Берутся списки направлений каждого поставщика и поля локации из записей отелей; исходный вид сохраняется.
Определяется, какому уровню — стране, провинции, району или курортной зоне — соответствует каждый код поставщика. «Antalya Region» относится к уровню провинции, «Belek» — к уровню курортной зоны.
Код привязывается к узлу иерархии по схожести названий, многоязычным написаниям и информации о вышестоящем уровне. Привязки, в которых нет уверенности, передаются на проверку эксперту.
Даже если поставщик присылает только провинцию или район, нижний уровень — курортная зона — определяется по координатам отеля, выбранным из записей поставщиков (проверка координат планируется).
Иерархия и соответствия кодов доставляются через 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, код поставщика и геокодирование.
Запрос
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"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 с помощью маппинга отелей. Затем по координатам, выбранным из записей поставщиков, определяется, в каком районе и курортной зоне он находится; проверка координат планируется. Код провинции от поставщика также отдельно сохраняется в записи.
Поиск пакетов «авиабилет + отель» начинается с аэропорта прибытия. Одну курортную зону могут обслуживать несколько аэропортов; например, для Аланьи можно использовать и AYT, и GZP. Благодаря этой связи поиск может перейти от аэропорта к отелям в этой зоне.
Уровни района и курортной зоны планируется завершить сначала для Турции (Анталья, Мугла, Стамбул), ОАЭ и Египта. Актуальные сведения о том, в каких странах эта детализация уже завершена, публикуются на странице покрытия.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.