Решения для маппинга направлений
Привязывает коды направлений поставщиков к иерархии страна → провинция → район → курортная зона и к кодам IATA.
Локация и POI проверяет координаты каждого отеля, сравнивая данные разных поставщиков, и считает расстояния до пляжа, аэропорта, центра и общественного транспорта. Ближайшие достопримечательности (POI) приходят с теми же кодами регионов, что и маппинг направлений. Продукт скоро будет запущен; для раннего доступа оставьте заявку на странице запроса предложения.
{
"hm_id": "HM-1048213",
"location": {
"lat": 36.8541,
"lon": 31.0552,
"status": "verified",
"rejected": [
{ "supplier": "B", "reason": "lat_lon_swapped" },
{ "supplier": "C", "reason": "city_center" }
]
},
"destination_id": "TR-07-SERIK-BELEK",
"distances_km": {
"beach": 0.3,
"airport_AYT": 31.5,
"center": 3.8,
"public_transport": 0.4
},
"poi": [
{ "name": "Pine Coast Golf Club", "category": "golf_course", "distance_km": 1.6 },
{ "name": "Belek Lagoon Mall", "category": "shopping_mall", "distance_km": 4.2 }
]
} На карте каждый отель стоит на своём реальном месте; записи, сброшенные в центр города или с перепутанными широтой и долготой, отсеиваются.
Фильтры вроде «рядом с пляжем» или «рядом с аэропортом» работают по одним и тем же данным во всех отелях.
Те же коды регионов используются в иерархии маппинга направлений; карта и фильтры по регионам не противоречат друг другу.
Верная координата — один из основных сигналов и для маппинга отелей.
Координаты одного отеля от трёх поставщиков
supplier,hotel_code,latitude,longitude,address
A,HTL-88213,36.8541,31.0552,"Belek Mah., Serik, Antalya"
B,40917,31.0552,36.8541,"Belek, Antalya"
C,TR-ANT-551,36.8969,30.7133,"Antalya" Проверенная локация, расстояния и места рядом
{
"hm_id": "HM-1048213",
"location": {
"lat": 36.8541,
"lon": 31.0552,
"status": "verified",
"rejected": [
{ "supplier": "B", "reason": "lat_lon_swapped" },
{ "supplier": "C", "reason": "city_center" }
]
},
"destination_id": "TR-07-SERIK-BELEK",
"distances_km": {
"beach": 0.3,
"airport_AYT": 31.5,
"center": 3.8,
"public_transport": 0.4
},
"poi": [
{ "name": "Pine Coast Golf Club", "category": "golf_course", "distance_km": 1.6 },
{ "name": "Belek Lagoon Mall", "category": "shopping_mall", "distance_km": 4.2 }
]
} Это пример данных; отель, координаты, расстояния и названия POI вымышлены. Названия регионов и аэропортов настоящие. Названия полей — черновик API v1.
Координаты одного отеля от разных поставщиков помещаются рядом под HM ID отеля.
Локации, не совпадающие с адресом, отсеиваются; неоднозначные проверяет команда данных.
От проверенной координаты считаются расстояния до пляжа, аэропорта, центра и общественного транспорта.
Пляж, музей, торговый центр, гольф-поле и другие достопримечательности приходят вместе с регионами маппинга направлений.
Координаты, которые присылают поставщики, не всегда верны. Частые ошибки: всем отелям региона присваивают координаты центра города, широту и долготу меняют местами, точка не совпадает с адресом. В итоге карта показывает не то место, фильтр «рядом с пляжем» теряет надёжность, а расстояния на странице отеля зависят от поставщика.
Локация и POI дают для каждого отеля одну проверенную координату, рассчитанные расстояния и ближайшие важные места. Продукт скоро будет запущен; эта страница описывает, как он будет работать, а поля и эндпоинты в примерах — черновик API v1. О получении координат по адресу читайте на странице словаря геокодирование.
| Компонент | Что даёт | Пример |
|---|---|---|
| Проверка координат | Разные координаты поставщиков сравниваются, ошибочные локации исправляются | Запись с перепутанными широтой и долготой отсеивается |
| Расстояния | До пляжа, аэропорта, центра и общественного транспорта | До пляжа 0,3 км |
| Места рядом | Пляж, музей, торговый центр, гольф-поле и другие важные места | Гольф-поле 1,6 км |
| Код региона | Та же иерархия, что и в маппинге направлений | TR-07-SERIK-BELEK |
Маппинг направлений привязывает отель к иерархии «страна → область → район → курортный регион»; Локация и POI используют те же коды регионов. Верная координата важна и для маппинга отелей: локация — один из компонентов оценки совпадения. Общая картина — в руководстве по маппингу отелей.
Собственный бассейн или частный пляж отеля — это не локация, а данные об удобствах отелей.
Для раннего доступа, информации об охвате и стоимости запросите предложение.
Запрос
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=location,poi" \
-H "X-API-Key: $HM_API_KEY" Ответ
{
"hm_id": "HM-1048213",
"location": { "lat": 36.8541, "lon": 31.0552, "status": "verified" },
"destination_id": "TR-07-SERIK-BELEK",
"distances_km": { "beach": 0.3, "airport_AYT": 31.5, "center": 3.8 },
"poi": [
{ "name": "Pine Coast Golf Club", "category": "golf_course", "distance_km": 1.6 }
]
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Локация и POI скоро будут запущены; точная дата пока не объявлена. Для раннего доступа напишите нам на странице запроса предложения.
POI (point of interest) — важные места вокруг отеля: пляж, музей, аэропорт, торговый центр, гольф-поле.
От проверенных координат отеля считаются расстояния до пляжа, аэропорта, центра и общественного транспорта.
Маппинг направлений привязывает отель к иерархии «страна, область, район, курортный регион». Локация и POI дают точные координаты отеля, расстояния и места вокруг. Оба используют одни и те же коды регионов.
Запросить предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.