Destinasyon eşleştirme çözümü
Tedarikçi destinasyon kodlarını ülke → il → ilçe → resort bölgesi hiyerarşisine ve IATA kodlarına bağlar.
Konum ve POI, her otelin koordinatını farklı tedarikçilerin verisiyle karşılaştırarak doğrular; plaja, havalimanına, merkeze ve toplu taşımaya mesafeyi hesaplar. Yakındaki önemli noktalar (POI) destinasyon eşleştirmesiyle aynı bölge kodlarıyla gelir. Ürün yakında kullanıma açılacak; erken erişim için teklif sayfasından başvurabilirsiniz.
{
"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 }
]
} Haritada her otel gerçek konumunda durur; şehir merkezine yığılmış veya enlemi ile boylamı yer değiştirmiş kayıtlar ayıklanır.
"Plaja yakın" veya "havalimanına yakın" gibi filtreler tüm otellerde aynı veriyle çalışır.
Aynı bölge kodları destinasyon eşleştirme hiyerarşisinde de kullanılır; harita ve bölge filtreleri birbiriyle çelişmez.
Doğru koordinat, otel eşleştirmesinin de temel sinyallerinden biridir.
Aynı otel için üç tedarikçiden gelen koordinatlar
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" Doğrulanmış konum, mesafeler ve yakındaki noktalar
{
"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 }
]
} Örnek veridir; otel, koordinatlar, mesafeler ve POI adları kurgusaldır. Bölge ve havalimanı adları gerçektir. Alan adları API v1 taslağıdır.
Aynı otel için farklı tedarikçilerin gönderdiği koordinatlar, otelin HM ID'si altında yan yana konur.
Adresle uyuşmayan konumlar ayıklanır; belirsiz olanları veri ekibi doğrular.
Doğrulanmış koordinattan plaja, havalimanına, merkeze ve toplu taşımaya mesafe hesaplanır.
Plaj, müze, alışveriş merkezi, golf sahası gibi önemli noktalar destinasyon eşleştirme bölgeleriyle birlikte gelir.
Tedarikçilerin gönderdiği koordinatlar her zaman doğru değildir. Sık görülen hatalar: bir bölgedeki tüm otellere şehir merkezinin koordinatının verilmesi, enlem ile boylamın yer değiştirmesi, adresle uyuşmayan bir nokta. Sonuçta harita yanlış yeri gösterir, “plaja yakın” filtresi güvenilmez olur ve otel sayfasındaki mesafeler tedarikçiye göre değişir.
Konum ve POI her otel için tek bir doğrulanmış koordinat, hesaplanmış mesafeler ve yakındaki önemli noktalar verir. Ürün yakında kullanıma açılacak; bu sayfa nasıl çalışacağını anlatır, örneklerdeki alanlar ve uç noktalar API v1 taslağıdır. Adresten koordinat üretme konusunu geokodlama sözlük sayfasında bulabilirsiniz.
| Bileşen | Ne verir | Örnek |
|---|---|---|
| Koordinat doğrulama | Tedarikçilerin farklı koordinatları karşılaştırılır, hatalı konumlar düzeltilir | Enlem/boylamı yer değiştirmiş kayıt ayıklanır |
| Mesafeler | Plaja, havalimanına, merkeze ve toplu taşımaya mesafe | Plaja 0,3 km |
| Yakındaki noktalar | Plaj, müze, alışveriş merkezi, golf sahası ve diğer önemli noktalar | Golf sahası 1,6 km |
| Bölge kodu | Destinasyon eşleştirmeyle aynı hiyerarşi | TR-07-SERIK-BELEK |
Destinasyon eşleştirme oteli ülke → il → ilçe → resort bölgesi hiyerarşisine bağlar; Konum ve POI aynı bölge kodlarını kullanır. Doğru koordinat otel eşleştirme için de önemlidir: konum, eşleşme skorunun bileşenlerinden biridir. Genel çerçeve otel eşleştirme rehberinde.
Otelin kendi havuzu veya özel plajı ise konum değil, otel olanakları verisidir.
Erken erişim, kapsam ve fiyat için teklif alabilirsiniz.
İstek
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=location,poi" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"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 }
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Konum ve POI yakında kullanıma açılacak; kesin tarih henüz paylaşılmadı. Erken erişim için teklif sayfasından bize yazabilirsiniz.
POI (point of interest), bir otelin çevresindeki plaj, müze, havalimanı, alışveriş merkezi, golf sahası gibi önemli noktalardır.
Doğrulanmış otel koordinatından plaja, havalimanına, merkeze ve toplu taşımaya olan mesafe hesaplanır.
Destinasyon eşleştirme oteli ülke, il, ilçe ve resort bölgesi hiyerarşisine bağlar. Konum ve POI ise otelin kesin koordinatını, mesafelerini ve çevresindeki noktaları verir. İkisi aynı bölge kodlarını kullanır.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.