Destinasyon eşleştirme çözümü

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.

Neler kazanırsınız

  • "Belek" araması tüm Belek otellerini getirir

    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.

  • Yerel idari yapıya uygun hiyerarşi

    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.

  • Tedarikçi kodları tek düğümde

    Her tedarikçinin destinasyon kodu, hangi seviyeye karşılık geldiği bilgisiyle birlikte hiyerarşideki düğüme bağlanır.

  • Havalimanı bağlantısı

    Her resort bölgesi en yakın havalimanlarının IATA kodlarıyla ilişkilendirilir; uçak + otel paket aramaları aynı veriyi kullanabilir.

Önce ve sonra

Aynı otel için üç tedarikçinin destinasyon bilgisi

supplier_destinations.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

Tek hiyerarşide konum

GET /v1/hotels/HM-1048213 (destination)
{
  "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.

Nasıl çalışır

  1. 1

    Kod toplama

    Her tedarikçinin destinasyon listesi ve otel kayıtlarındaki konum alanları alınır; ham hali saklanır.

  2. 2

    Seviye tespiti

    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.

  3. 3

    Hiyerarşiye bağlama

    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.

  4. 4

    Otelin konumunu kesinleştirme

    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).

  5. 5

    Teslim

    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.

Destinasyonlar neden eşleşmez?

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.

Hiyerarşi

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ı

Sık görülen zor durumlar

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.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

GET /v1/destinations/{id}
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

200 OK
{
  "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.

Sık sorulan sorular

Resort bölgesi ile ilçe arasındaki fark nedir?

İ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.

Tedarikçi yalnız il bilgisi gönderirse otel hangi bölgeye düşer?

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.

IATA kodları neden destinasyona bağlanıyor?

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 ayrıntısı hangi ülkelerde hazır?

İ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

Size özel teklifi alın

Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.

  1. 1 Çözümleri seçin
  2. 2 Tedarikçileri seçin
  3. 3 İletişim bilgilerinizi bırakın