# Otel eşleştirme çözümü

> URL: https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/ · Dil: Türkçe

Otel eşleştirme, farklı tedarikçilerin aynı otel için gönderdiği farklı ad, kod ve adresleri tek bir kalıcı kimlikte (HM ID) birleştirir. Tedarikçi kodları, Google Place ID ve koordinat bu kimliğe bağlanır; mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimlikleri de çapraz referans olarak saklanır. Böylece her otel listenizde yalnız bir kez görünür.

## Neler kazanırsınız

- **Her otel listede bir kez:** Aynı otelin farklı tedarikçi kayıtları tek kartta toplanır; en uygun teklif tek yerde görünür.
- **Kalıcı kimlik:** HM ID asla başka bir otele yeniden verilmez. Birleşen oteller eski ID'yi yeni ID'ye yönlendirir.
- **Mevcut ID'leriniz korunur:** Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimliklerini çapraz referans olarak saklarız; bugüne kadar yaptığınız eşleştirmeyi kaybetmezsiniz.
- **Yeni tedarikçi hızla devrede:** Yeni bir tedarikçi dosyası normalleştirme ve skorlamadan geçip kısa sürede HM ID'lere bağlanır.

## Önce ve sonra

Üç tedarikçiden gelen ham kayıt

**supplier_static.csv**

```csv
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556
```

Tek HM ID altında standart kayıt

**GET /v1/hotels/HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "name": "Sunset Bay Resort & Spa",
  "destination_id": "TR-07-SERIK-BELEK",
  "destination": ["TR", "Antalya", "Serik", "Belek"],
  "geo": { "lat": 36.8541, "lng": 31.0552 },
  "supplier_codes": {
    "A": "HTL-88213",
    "B": "40917",
    "C": "TR-ANT-551"
  },
  "external_ids": { "client": "OTL-2231" },
  "status": "active"
}
```

_Örnek veridir; otel adı ve kodlar gerçek bir tesise ait değildir._

## Nasıl çalışır

1. **Veri alma:** Tedarikçi statik verisini API, CSV veya FTP ile alırız. Her kayıt ham haliyle saklanır, değişiklikler sürümlenir.
2. **Normalleştirme:** Otel adından "Hotel", "Resort & Spa" gibi ekler ayrılır; Rusça ve Arapça adlar Latin harfe çevrilir; adres, telefon ve web adresi standart biçime getirilir.
3. **Aday üretme ve skorlama:** Her kayıt yalnız yakınındaki otellerle karşılaştırılır. Ad benzerliği, çok dilli embedding, mesafe, telefon ve web eşleşmesi birleşerek 0–1 arası bir olasılık skoru verir.
4. **Karar ve insan kontrolü:** Skor 0,97 ve üstüyse otomatik eşleşme olur; 0,80–0,97 arası kayıtlar haritalı kontrol ekranında bir uzmana düşer; 0,80 altı yeni bir HM ID açar.
5. **Teslim:** Sonuç REST API ve günlük tam ve delta dump (CSV, JSON, Parquet) ile size ulaşır; webhook planlanıyor.

## API örneği

**Tedarikçi kodundan HM ID'ye**

```bash
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "supplier": "B",
  "code": "40917",
  "hm_id": "HM-1048213",
  "confidence": 0.998,
  "matched_at": "2026-11-02T08:14:00Z"
}
```

_Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir._

## Otel eşleştirme neden gerekli?

Bir acente ortalama birkaç tedarikçiyle çalışır ve her tedarikçi aynı oteli kendi adıyla, kendi koduyla ve kendi koordinatıyla gönderir. Eşleştirme yapılmadığında aynı otel listede birden fazla kez görünür, fiyat karşılaştırması bozulur ve müşteri hangi kartın doğru olduğunu anlayamaz.

hotelmapping.org dünya çapında 3,5 milyon otel ile çalışır ve bu kayıtları tek bir kalıcı kimlikte, **HM ID**'de birleştirir. Siz yalnız HM ID ile çalışırsınız; hangi tedarikçinin hangi kodu kullandığını biz takip ederiz.

## Neleri bağlıyoruz?

| Alan | Açıklama |
| --- | --- |
| Tedarikçi kodları | Her tedarikçinin otel kodu, HM ID'ye bağlı |
| Harici otel kimlikleri | Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin kimlikleri; varsa çapraz referans olarak saklanır |
| Google Place ID | Konum ve kimlik için ek referans |
| Koordinat | Tedarikçi kayıtlarından seçilen enlem ve boylam (koordinat doğrulama planlanıyor) |
| Destinasyon | Ülke → il → ilçe → resort bölgesi hiyerarşisi |

## Kalite nasıl ölçülüyor?

Eşleştirme kalitesi elle etiketlenmiş bir test setiyle her sürümde ölçülür. Sitede yalnız bu ölçümle doğrulanmış rakamları yayınlarız; güncel değerler [kapsam sayfasında](https://hotelmapping.org/tr/kapsam/) yer alır.

## Sık sorulan sorular

### HM ID ile tedarikçi kodu arasındaki fark nedir?

Tedarikçi kodu yalnız o tedarikçinin sisteminde geçerlidir ve tedarikçiye göre değişir. HM ID ise aynı otelin tüm tedarikçi kodlarını bir araya getiren, bizim verdiğimiz kalıcı kimliktir.

### Yanlış eşleşme olursa ne oluyor?

Emin olunmayan skorlar otomatik eşleşmez, insan kontrolüne düşer. Yine de bir hata bildirirseniz kayıt düzeltilir ve bu karar modele eğitim verisi olarak eklenir.

### Otel kapanırsa veya iki otel birleşirse HM ID ne olur?

HM ID asla başka bir otele verilmez. Kapanan otelin durumu "closed" olur. Birleşen otellerde eski ID'nin durumu "merged" olur ve merged_into alanı yeni ID'yi gösterir.

### Başka bir eşleştirme sağlayıcısından geçerken mevcut otel kimliklerimizi kullanmaya devam edebilir miyiz?

Evet. Mevcut eşleştirme sağlayıcınızın veya kendi sisteminizin otel kimliklerini çapraz referans olarak saklarız; bu kimlikler API yanıtında external_ids alanında HM ID ile birlikte döner. Böylece mevcut eşleştirmenizi bırakmadan HM ID'ye geçebilirsiniz.

## İlgili ürünler

- [Oda eşleştirme çözümü](https://hotelmapping.org/tr/urunler/oda-eslestirme-cozumu/)
- [Pansiyon tipi eşleştirme çözümü](https://hotelmapping.org/tr/urunler/pansiyon-tipi-eslestirme-cozumu/)
- [Find Match API çözümü](https://hotelmapping.org/tr/urunler/eslestirme-api-cozumu/)

## İlgili makaleler

- [Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/)
- [Mükerrer otel listelemenin acenteye maliyeti: dönüşüm, iptal ve müşteri şikâyeti](https://hotelmapping.org/tr/rehber/mukerrer-otel-maliyeti/)
- [Hotel mapping API seçerken sorulması gereken 12 soru](https://hotelmapping.org/tr/rehber/hotel-mapping-api-secerken-12-soru/)
