Otel eşleştirme çözümü
Her tesise kalıcı bir HM ID; tedarikçi kodları ve çapraz ID'ler tek kayıtta.
Destinasyon eşleştirme, tedarikçilerin farklı seviyede ve farklı kodla gönderdiği konumları tek bir hiyerarşiye bağlar: ülke → il → ilçe → resort bölgesi (Türkiye → Antalya → Serik → Belek). Her düğümün kalıcı bir kimliği (ör. TR-07-SERIK-BELEK), bağlı tedarikçi destinasyon kodları ve en yakın havalimanlarının IATA kodları vardır.
{
"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" }
}
} Bir tedarikçi oteli Belek, diğeri Serik, üçüncüsü yalnız Antalya altında gönderse de otel doğru resort bölgesinde görünür.
Hiyerarşi ülkenin il ve ilçe idari yapısını turizmde kullanılan resort bölgeleriyle birleştirir. Örneğin Kadriye'nin Belek bölgesinde, Side'nin Manavgat ilçesinde olduğu gibi ilişkiler kayıtlıdır.
Her tedarikçinin destinasyon kodu, hangi seviyeye karşılık geldiği bilgisiyle birlikte hiyerarşideki düğüme bağlanır.
Her resort bölgesi en yakın havalimanlarının IATA kodlarıyla ilişkilendirilir; uçak + otel paket aramaları aynı veriyi kullanabilir.
Aynı otel için üç tedarikçinin destinasyon bilgisi
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 Tek hiyerarşide konum
{
"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" }
}
} Örnek veridir; otel ve tedarikçi kodları kurgusaldır. Bölge ve havalimanı adları gerçektir.
Her tedarikçinin destinasyon listesi ve otel kayıtlarındaki konum alanları alınır; ham hali saklanır.
Her tedarikçi kodunun ülke, il, ilçe veya resort bölgesi seviyesinden hangisine karşılık geldiği belirlenir. "Antalya Region" il, "Belek" resort seviyesindedir.
Kod, ad benzerliği, çok dilli yazımlar ve üst seviye bilgisiyle hiyerarşideki düğüme bağlanır. Emin olunmayan bağlantılar uzman kontrolüne gider.
Tedarikçi yalnız il veya ilçe gönderse bile otelin tedarikçi kayıtlarından seçilen koordinatıyla en alt seviye olan resort bölgesi belirlenir (koordinat doğrulama planlanıyor).
Hiyerarşi ve kod eşlemeleri API ve günlük dump ile teslim edilir. Otel kayıtlarında destinasyon kimliği ve tam yol birlikte döner.
Tedarikçiler konumu farklı seviyelerde gönderir. Biri Belek’teki bir oteli “Belek” altında, biri “Serik” altında, biri yalnız “Antalya” altında listeler. Bazıları destinasyon olarak doğrudan havalimanı kodunu kullanır. Eşleştirme yapılmadığında “Belek” araması otellerin bir kısmını getirmez, bölge filtreleri eksik çalışır ve aynı otel farklı bölgelerde görünür.
Destinasyon eşleştirme tüm bu kodları tek bir hiyerarşiye bağlar ve her otele tek bir destinasyon kimliği verir. Genel çerçeve için otel eşleştirme rehberine bakabilirsiniz.
| Seviye | Örnek | Kimlik | Not |
|---|---|---|---|
| Ülke | Türkiye | TR | ISO 3166-1 ülke kodu |
| İl | Antalya | TR-07 | ISO 3166-2 il kodu (plaka numarası) |
| İlçe | Serik | TR-07-SERIK | İdari ilçe |
| Resort bölgesi | Belek | TR-07-SERIK-BELEK | Turizmde kullanılan bölge adı |
| Durum | Örnek | Nasıl çözülür |
|---|---|---|
| Resort adı ilçe adından farklı | Side, Manavgat ilçesindedir | Resort bölgesi doğru ilçenin altına bağlanır |
| Bölge içinde alt yerleşim | Kadriye, Belek bölgesindedir | Tedarikçinin “Kadriye” kodu Belek düğümüne bağlanır |
| İlçe ve resort aynı adı taşır | Kemer; içinde Beldibi, Göynük, Tekirova | Kemer hem ilçe hem bölge olarak tutulur, alt bölgeler ayrılır |
| Bir bölgeye birden çok havalimanı | Alanya: AYT ve GZP | Bölge her iki IATA koduyla ilişkilendirilir |
| Kod yalnız il seviyesinde | “Antalya Region” | Otelin koordinatıyla alt seviye belirlenir |
Destinasyon kimliği otel kaydının parçasıdır; bu yüzden otel eşleştirme ile birlikte çalışır. Ad ve koordinattan HM ID bulmak için eşleştirme API aynı hiyerarşiyi kullanır. Hiyerarşinin hangi ülkelerde ilçe ve resort seviyesine kadar tamamlandığı kapsam sayfasında yayımlanır. Terimler için HM ID, tedarikçi kodu ve geokodlama sözlük sayfalarına bakabilirsiniz.
İstek
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"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" }
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
İlçe idari bir birimdir; resort bölgesi ise turizmde kullanılan bölge adıdır. Belek, Serik ilçesindeki bir resort bölgesidir; Side ise Manavgat ilçesindedir. Misafir "Belek" veya "Side" diye arar, tedarikçi ise çoğu zaman ilçe ya da il gönderir.
Otel önce otel eşleştirmesiyle HM ID'ye bağlanır. Ardından tedarikçi kayıtlarından seçilen koordinatı kullanılarak hangi ilçe ve resort bölgesinde olduğu belirlenir; koordinat doğrulama planlanıyor. Tedarikçinin il kodu da kayıtta ayrıca saklanır.
Uçak + otel paket aramaları varış havalimanıyla başlar. Bir resort bölgesine birden fazla havalimanı hizmet verebilir; örneğin Alanya için hem AYT hem GZP kullanılabilir. Bu bağlantı sayesinde arama, havalimanından o bölgedeki otellere ulaşabilir.
İlçe ve resort bölgesi seviyesinin ilk olarak Türkiye (Antalya, Muğla, İstanbul), BAE ve Mısır için tamamlanması planlanıyor. Hangi ülkelerde bu ayrıntının tamamlandığı kapsam sayfasında güncel olarak yayımlanır.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.