Otel açıklamaları çözümü

Otel açıklamaları, her HM ID için çok dilli ve satışa hazır tanıtım metni sunar. Her otel için kısa, orta ve uzun olmak üzere üç sürüm vardır; ilk diller Türkçe, İngilizce, Almanca, Rusça ve Arapça. Metinler otelin factsheet verisinden ve tedarikçi metinlerinden üretilir, editör kontrolünden geçer, API ve dump dosyalarıyla teslim edilir.

Neler kazanırsınız

  • Üç uzunlukta metin

    Kısa metin arama sonuç kartına, orta metin otel sayfasının üstüne, uzun metin detay bölümüne uyar. Metni her ekran için ayrıca kırpmanız gerekmez.

  • Beş dilde aynı bilgi

    Türkçe, İngilizce, Almanca, Rusça ve Arapça açıklamalar aynı doğrulanmış bilgiye dayanır. Yeni bir pazara açılırken içeriği sıfırdan yazdırmazsınız.

  • Yapay zekâ ve editör

    Taslağı yapay zekâ üretir, editörler doğruluk ve üslup açısından kontrol eder. Saat, sayı ve politika gibi bilgiler factsheet alanlarından gelir.

  • Eşleşmiş otele bağlı

    Her açıklama bir HM ID'ye bağlıdır. Tedarikçi değiştirseniz veya yeni tedarikçi ekleseniz de metin aynı otelde kalır.

Önce ve sonra

Üç tedarikçiden gelen otel metni

supplier_descriptions.txt
[A / HTL-88213]  lang=en
Nice hotel near the beach. Great pools!! Check-in 14:00.
Great pools and great food. Close to the beach.

[B / 40917]  lang=tr
Belek'te 5 yıldızlı otel.

[C / TR-ANT-551]  lang=de
(açıklama yok)

HM ID altında üç uzunlukta açıklama

HM-1048213 otel açıklamaları (tr)
{
  "hm_id": "HM-1048213",
  "lang": "tr",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Belek'te, otele ait kum plaja 250 metre mesafede, üç açık havuzlu resort otel.",
    "medium": "Sunset Bay Resort & Spa, Antalya'nın Belek bölgesinde, otele ait kum plaja 250 metre uzaklıktadır. 412 odalı tesiste üç açık ve bir kapalı havuz bulunur.",
    "long": "Sunset Bay Resort & Spa, Belek'in sahil şeridinde yer alır. (Örnekte kısaltıldı.)"
  }
}

Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir. Tekrar eden ve abartılı ifadeler ayıklanır; metindeki mesafe ve sayılar factsheet alanlarından gelir.

Nasıl çalışır

  1. 1

    Doğru otelle başlama

    Otel eşleştirmeyle tek HM ID'de birleşen otelin tüm tedarikçi metinleri ve factsheet verisi bir araya getirilir.

  2. 2

    Taslak üretimi

    Yapay zekâ, factsheet verisinden ve tedarikçi metinlerinden kısa, orta ve uzun açıklama üretir; tekrar eden ve çelişen ifadeler ayıklanır.

  3. 3

    Editör kontrolü

    Editörler metni doğruluk ve üslup açısından kontrol eder. Tüm diller aynı bilgiye dayanır.

  4. 4

    Güncelleme

    Tesis bilgisi değiştiğinde açıklama da güncellenir; metin factsheet ile çelişir hâle gelmez.

  5. 5

    Teslim

    Açıklamalar GET /v1/hotels/{hm_id}/content ucundan dil parametresiyle döner; tüm envanter günlük tam ve delta dump dosyalarında gelir.

Otel açıklamaları neyi çözer?

Eşleştirme aynı oteli tek HM ID’de birleştirir; tanıtım metni ise hâlâ tedarikçi sayısı kadar farklıdır. Bir tedarikçi yalnız İngilizce ve tekrar eden cümleler gönderir, diğeri tek satırlık bir Türkçe not, üçüncüsü hiç metin göndermez. Otel sayfası hangi tedarikçinin içeriği kullanıldığına göre değişir; Almanca veya Rusça konuşan bir pazara açılmak istediğinizde metni sıfırdan yazdırmanız gerekir.

Otel açıklamaları bu farkı HM ID düzeyinde kapatır: her otel için tek, tutarlı ve satışa hazır bir metin. Bunun ön koşulu oteli doğru eşleştirmektir; yöntemi otel eşleştirme rehberinde, ürünü otel eşleştirme sayfasında bulabilirsiniz.

Üç uzunluk, üç kullanım

Sürüm Biçim Nerede kullanılır?
Kısa Tek cümle Arama sonuç kartı, harita kartı
Orta Tek paragraf Otel sayfasının üst bölümü
Uzun Birkaç paragraf Detay sekmesi: konum, odalar, yeme-içme, olanaklar

Her sürüm aynı bilgiye dayanır. Kısa metin, uzun metnin kırpılmış hâli değildir; kendi alanı için ayrıca yazılır.

Metinler nasıl hazırlanır?

Açıklama, otelin tüm tedarikçi kayıtlarından derlenen doğrulanmış bilgiye dayanır. Saat, sayı, mesafe ve politika gibi bilgiler otel factsheet alanlarından gelir. Böylece metinde geçen bir giriş saati veya plaj mesafesi, factsheet’teki değerle çelişmez.

Taslağı yapay zekâ üretir; tekrar eden, abartılı ve birbiriyle çelişen ifadeler ayıklanır. Ardından editörler metni doğruluk ve üslup açısından kontrol eder. Tesis bilgisi değiştiğinde açıklama da güncellenir.

Diller ve teslim

İlk sürümde Türkçe, İngilizce, Almanca, Rusça ve Arapça açıklama sunulur. Tüm diller aynı bilgiden üretildiği için bir dildeki sayfa ile diğerindeki sayfa aynı oteli anlatır.

Açıklamalar otel bazında REST API ile, tüm envanter için günlük tam ve delta dump dosyalarıyla teslim edilir. Örnekteki include ve lang parametreleri API v1 taslağıdır; kesin şema geliştirici sayfasında yayımlanır.

İlgili ürünler

Filtreleme ve karşılaştırma için gereken yapılandırılmış bilgiler otel factsheet ürünündedir. Otelin fotoğraf galerisi otel resimleri hizmetinde tekilleştirilir ve kategoriyle etiketlenir. Kapsam ve fiyat için teklif alabilirsiniz.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

İngilizce açıklamaları isteme
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

200 OK
{
  "hm_id": "HM-1048213",
  "lang": "en",
  "available_langs": ["tr", "en", "de", "ru", "ar"],
  "descriptions": {
    "short": "Resort hotel in Belek, 250 m from its private sandy beach, with three outdoor pools.",
    "medium": "Sunset Bay Resort & Spa is in Belek, Antalya, 250 metres from the hotel's private sandy beach. The 412-room property has three outdoor pools and one indoor pool.",
    "long": "Sunset Bay Resort & Spa sits on the Belek coastline. (Shortened in this example.)"
  },
  "updated_at": "2026-11-02T08:14:00Z"
}

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

Sık sorulan sorular

Otel açıklamaları hangi dillerde?

İlk diller Türkçe, İngilizce, Almanca, Rusça ve Arapça. Tüm diller aynı doğrulanmış bilgiye dayanır. Yeni dillerin takvimi henüz kesinleşmedi.

Açıklamaları kim yazıyor?

Metni yapay zekâ üretir; editörler doğruluk ve üslup açısından kontrol eder. Saat, sayı ve politika gibi bilgiler yapılandırılmış factsheet verisinden gelir.

Açıklama ile factsheet arasındaki fark nedir?

Açıklama okunmak için yazılmış metindir. Factsheet ise giriş-çıkış saati, plaj, havuz ve çocuk politikası gibi bilgileri filtreleme ve karşılaştırma için ayrı alanlarda verir. İkisi aynı veriye dayanır.

Açıklamalar nasıl teslim ediliyor?

Otel bazında REST API ile, tüm envanter için günlük tam ve delta dump dosyalarıyla. Değişiklik bildirimi için webhook planlanıyor.

Açıklamaları kendi sitemde ve uygulamamda yayınlayabilir miyim?

İçeriğin kullanım ve lisans koşulları sözleşmede belirlenir.

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