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

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

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**

```text
[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)**

```json
{
  "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. **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. **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. **Editör kontrolü:** Editörler metni doğruluk ve üslup açısından kontrol eder. Tüm diller aynı bilgiye dayanır.
4. **Güncelleme:** Tesis bilgisi değiştiğinde açıklama da güncellenir; metin factsheet ile çelişir hâle gelmez.
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.

## API örneği

**İngilizce açıklamaları isteme**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=descriptions&lang=en" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "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._

## 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](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/), ürünü [otel eşleştirme](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/) 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](https://hotelmapping.org/tr/urunler/otel-factsheet-cozumu/) 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](https://hotelmapping.org/tr/sozluk/delta-dump/) dosyalarıyla teslim edilir. Örnekteki `include` ve `lang` parametreleri API v1 taslağıdır; kesin şema [geliştirici sayfasında](https://hotelmapping.org/tr/gelistiriciler/) yayımlanır.

## İlgili ürünler

Filtreleme ve karşılaştırma için gereken yapılandırılmış bilgiler [otel factsheet](https://hotelmapping.org/tr/urunler/otel-factsheet-cozumu/) ürünündedir. Otelin fotoğraf galerisi [otel resimleri](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/) hizmetinde tekilleştirilir ve kategoriyle etiketlenir. Kapsam ve fiyat için [teklif alabilirsiniz](https://hotelmapping.org/tr/teklif-al/).

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

## İlgili ürünler

- [Otel factsheet çözümü](https://hotelmapping.org/tr/urunler/otel-factsheet-cozumu/)
- [Otel resimleri çözümü](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/)
- [Otel eşleştirme çözümü](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/)

## İlgili makaleler

- [Otel XML entegrasyonu nedir? Statik ve dinamik veri farkı](https://hotelmapping.org/tr/rehber/otel-xml-entegrasyonu-nedir/)
- [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/)
