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

> URL: https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-napravleniy/ · Язык: Русский

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

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

- **Поиск «Белек» находит все отели Белека:** Даже если один поставщик присылает отель под Белеком, другой под Сериком, а третий только под Анталье, отель отображается в правильной курортной зоне.
- **Иерархия, соответствующая местному административному делению:** Иерархия объединяет административное деление страны на провинции и районы с курортными зонами, используемыми в туризме. Например, зафиксировано, что Кадрие находится в зоне Белек, а Сиде — в районе Манавгат.
- **Коды поставщиков в одном узле:** Код направления каждого поставщика привязывается к узлу иерархии вместе с информацией о том, какому уровню он соответствует.
- **Связь с аэропортом:** Каждая курортная зона связывается с кодами IATA ближайших аэропортов; поиск пакетов «авиабилет + отель» может использовать те же данные.

## До и после

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

**supplier_destinations.csv**

```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)**

```json
{
  "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. **Сбор кодов:** Берутся списки направлений каждого поставщика и поля локации из записей отелей; исходный вид сохраняется.
2. **Определение уровня:** Определяется, какому уровню — стране, провинции, району или курортной зоне — соответствует каждый код поставщика. «Antalya Region» относится к уровню провинции, «Belek» — к уровню курортной зоны.
3. **Привязка к иерархии:** Код привязывается к узлу иерархии по схожести названий, многоязычным написаниям и информации о вышестоящем уровне. Привязки, в которых нет уверенности, передаются на проверку эксперту.
4. **Уточнение локации отеля:** Даже если поставщик присылает только провинцию или район, нижний уровень — курортная зона — определяется по координатам отеля, выбранным из записей поставщиков (проверка координат планируется).
5. **Доставка:** Иерархия и соответствия кодов доставляются через API и ежедневный dump. В записях отелей возвращаются ID направления и полный путь.

## Пример API

**GET /v1/destinations/{id}**

```bash
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "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._

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

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

Маппинг направлений привязывает все эти коды к единой иерархии и присваивает каждому отелю один ID направления. Об общей картине читайте в [руководстве по маппингу отелей](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/).

## Иерархия

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

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

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

ID направления является частью записи отеля, поэтому он работает вместе с [маппингом отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/). Чтобы найти HM ID по названию и координатам, [Find Match API](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/) использует ту же иерархию. В каких странах иерархия доведена до уровня района и курортной зоны, публикуется на [странице покрытия](https://hotelmapping.org/ru/pokrytie/). По терминам см. страницы глоссария: [HM ID](https://hotelmapping.org/ru/glossariy/hm-id/), [код поставщика](https://hotelmapping.org/ru/glossariy/kod-postavshchika/) и [геокодирование](https://hotelmapping.org/ru/glossariy/geokodirovanie/).

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

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

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

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

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

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

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

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

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

## Связанные продукты

- [Решения для маппинга отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-mappinga-oteley/)
- [Решение Find Match API](https://hotelmapping.org/ru/produkty/reshenie-find-match-api/)
- [Решения для описаний отелей](https://hotelmapping.org/ru/produkty/resheniya-dlya-opisaniy-oteley/)

## Связанные статьи

- [Что такое маппинг отелей (сопоставление отелей) и как он работает? Подробное руководство](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-mapping-otelei/)
- [Что такое XML-интеграция отелей? Статические и динамические данные](https://hotelmapping.org/ru/rukovodstvo/chto-takoe-xml-integratsiya-otelei/)
- [Стоимость дубликатов отелей для агентства: конверсия, отмены и жалобы клиентов](https://hotelmapping.org/ru/rukovodstvo/stoimost-dublikatov-otelei/)
