# Oda resimleri çözümü

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

Oda resimleri, tedarikçilerin her oda için gönderdiği fotoğrafları oda eşleştirmesiyle oluşan standart oda tiplerine (ör. HM-1048213-R03) bağlar. Böylece her oda teklifi genel otel galerisi yerine o odanın kendi fotoğraflarıyla gösterilir. Farklı tedarikçilerden gelen aynı fotoğraf tek resimde gruplanır ve resimler oda verisiyle birlikte API'den döner.

## Neler kazanırsınız

- **Doğru oda, doğru fotoğraf:** Deniz manzaralı balkonlu odanın teklifi, o odanın fotoğraflarıyla gösterilir; misafir otelin genel galerisinde odasını aramak zorunda kalmaz.
- **Tedarikçiler tek oda tipinde birleşir:** Üç tedarikçinin aynı oda için gönderdiği fotoğraflar, oda eşleştirmesinin oluşturduğu tek oda kimliği altında toplanır.
- **Kopyalar tek resimde:** Aynı oda fotoğrafının farklı tedarikçilerden ve farklı boyutlarda gelen kopyaları tek resim altında gruplanır.
- **Oda verisiyle birlikte:** Resimler oda tipi, manzara, yatak ve kapasite etiketleriyle aynı yanıtta döner; ayrı bir eşleştirme adımı gerekmez.

## Önce ve sonra

Üç tedarikçiden gelen oda fotoğrafları

**supplier_room_images.csv**

```csv
supplier,hotel_code,room_code,room_name,image_url,width
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony,https://img.supplier-a.example/88213/rooms/dblsv-1.jpg,1920
B,40917,DZMB,DZ Meerblick Balkon,https://cdn.supplier-b.example/40917/zimmer/dzmb_01.jpg,1024
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1),https://media.supplier-c.example/551/IMG_3101.jpg,800
B,40917,FZLS,FZ Landseite,https://cdn.supplier-b.example/40917/zimmer/fzls_01.jpg,1024
```

Standart oda tiplerine bağlanmış resimler

**HM-1048213 oda resimleri**

```json
{
  "hm_id": "HM-1048213",
  "rooms": [
    {
      "room_id": "HM-1048213-R03",
      "name": "Standard Double Room, Sea View, Balcony",
      "images": [
        {
          "image_id": "HM-1048213-R03-I001",
          "copies": [
            { "supplier": "A", "room_code": "DBLSV-B", "width": 1920 },
            { "supplier": "B", "room_code": "DZMB", "width": 1024 }
          ]
        },
        {
          "image_id": "HM-1048213-R03-I002",
          "copies": [{ "supplier": "C", "room_code": "STD-DNZ", "width": 800 }]
        }
      ]
    },
    {
      "room_id": "HM-1048213-R07",
      "name": "Standard Family Room, Land View",
      "images": [
        {
          "image_id": "HM-1048213-R07-I001",
          "copies": [{ "supplier": "B", "room_code": "FZLS", "width": 1024 }]
        }
      ]
    }
  ]
}
```

_Örnek veridir; otel, oda adları, kodlar ve resim adresleri gerçek bir tesise ait değildir._

## Nasıl çalışır

1. **Oda eşleştirme:** Tedarikçi oda kodları, oda eşleştirmesiyle otelin HM ID'sine bağlı standart oda kimliklerine bağlanır.
2. **Toplama:** Tedarikçinin bir oda koduyla gönderdiği fotoğraflar, o kodun bağlı olduğu standart oda kimliği altında toplanır.
3. **Mükerrer resim tespiti:** Her resmin içeriğe dayalı bir parmak izi çıkarılır; aynı oda fotoğrafının farklı tedarikçilerden gelen kopyaları tek resimde gruplanır.
4. **Teslim:** Resimler, kopya grupları ve tedarikçi oda kodları oda verisiyle birlikte API yanıtında döner.

## API örneği

**Bir otelin odalarını resimleriyle isteme**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "rooms": [
    {
      "room_id": "HM-1048213-R03",
      "name": "Standard Double Room, Sea View, Balcony",
      "view": "sea",
      "bed": "double",
      "max_occupancy": 3,
      "supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" },
      "images": [
        {
          "image_id": "HM-1048213-R03-I001",
          "url": "https://img.supplier-a.example/88213/rooms/dblsv-1.jpg",
          "width": 1920,
          "copy_count": 2
        },
        {
          "image_id": "HM-1048213-R03-I002",
          "url": "https://media.supplier-c.example/551/IMG_3101.jpg",
          "width": 800,
          "copy_count": 1
        }
      ]
    }
  ]
}
```

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

## Oda resimleri neyi çözer?

Bir otel sayfasında beş oda teklifi listelendiğinde çoğu sistem her teklifin yanında aynı genel galeriyi gösterir. Misafir deniz manzaralı balkonlu odayı seçerken havuz veya lobi fotoğrafı görür; aile odasının nasıl göründüğünü anlamak için galeriyi baştan sona gezmesi gerekir. Tedarikçiler oda fotoğraflarını çoğu zaman kendi oda kodlarıyla gönderir, ama bu kodlar her tedarikçide farklıdır.

Oda resimleri bu fotoğrafları [oda eşleştirme](https://hotelmapping.org/tr/urunler/oda-eslestirme-cozumu/) sonucunda oluşan standart oda tiplerine bağlar. "Dbl Sea View Balcony", "DZ Meerblick Balkon" ve "Standart Oda Deniz Manzaralı Balkonlu" aynı oda kimliğine bağlandığı için üç tedarikçinin fotoğrafları da aynı odada toplanır. Oda tiplerinin nasıl standartlaştığını [oda eşleştirme nedir](https://hotelmapping.org/tr/rehber/oda-eslestirme-nedir/) rehberinde, genel çerçeveyi [otel eşleştirme rehberinde](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/) bulabilirsiniz.

## Otel resimleri ile oda resimleri

| | Otel resimleri | Oda resimleri |
| --- | --- | --- |
| Neye bağlanır | Otelin HM ID'si | Standart oda kimliği (ör. HM-1048213-R03) |
| Ne içerir | Dış cephe, lobi, havuz, plaj, restoran, spa, ortak alanlar | O oda tipinin fotoğrafları |
| Ön koşul | [Otel eşleştirme](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/) | Otel eşleştirme ve oda eşleştirme |
| Mükerrer tespiti | Otel galerisi içinde | Oda tipi içinde |
| Teslim | Otel içeriği yanıtı ve dump | Oda verisi yanıtı |

Otelin genel galerisi için [otel resimleri](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/) hizmetine bakın. İki hizmet birlikte kullanıldığında otel sayfası genel galeriyi, her oda teklifi ise kendi fotoğraflarını gösterir.

## Kopyalar nasıl ayıklanır?

Birden fazla tedarikçi aynı oda fotoğrafını farklı boyut veya sıkıştırmayla gönderebilir. Her resmin içeriğe dayalı bir parmak izi çıkarılır ve aynı oda tipi içindeki aynı kareler tek resim altında gruplanır. Yanıtta her resmin kopya sayısı ve hangi tedarikçi oda kodundan geldiği yer alır.

## Teslim

Resimler, [otel içeriği](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/) ve oda eşleştirme verisiyle aynı HM ID ve oda kimlikleri üzerinden çalışır. Örnekteki `GET /v1/hotels/{hm_id}/rooms?include=images` uç noktası ve yanıt alanları API v1 taslağıdır; kesin şema [geliştirici sayfasında](https://hotelmapping.org/tr/gelistiriciler/) yayımlanır. Kapsam ve fiyat için [teklif alabilirsiniz](https://hotelmapping.org/tr/teklif-al/).

## Sık sorulan sorular

### Oda resimleri için oda eşleştirme gerekli mi?

Evet. Fotoğraflar, oda eşleştirmesinin oluşturduğu standart oda kimliklerine bağlanır. Oda tipleri standartlaşmadan farklı tedarikçilerin aynı oda için gönderdiği fotoğraflar bir araya getirilemez.

### Oda resimleri ile otel resimleri arasındaki fark nedir?

Otel resimleri otelin genel galerisidir: dış cephe, lobi, havuz, plaj, restoran, spa ve ortak alanlar. Oda resimleri her standart oda tipine ayrı ayrı bağlanan fotoğraflardır. İkisi ayrı hizmetlerdir.

### Tedarikçi oda fotoğrafını oda koduyla göndermezse ne olur?

Oda resmi, tedarikçinin fotoğrafı hangi oda koduyla gönderdiğine göre oda tipine bağlanır. Oda koduyla gelmeyen fotoğraflar bir oda tipine bağlanmaz; otel düzeyinde gelen fotoğraflar otel resimleri hizmetinde işlenir.

### Oda resimleri fiyat veya müsaitlik verisi de getirir mi?

Hayır. Oda resimleri statik oda verisinin bir parçasıdır. Fiyat ve müsaitlik tedarikçiden sizin sisteminize gelir; biz yalnız teklifin hangi odaya ait olduğunu ve o odanın resimlerini veririz.

## İlgili ürünler

- [Oda eşleştirme çözümü](https://hotelmapping.org/tr/urunler/oda-eslestirme-cozumu/)
- [Otel resimleri çözümü](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/)
- [Otel açıklamaları çözümü](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/)

## İlgili makaleler

- [Oda eşleştirme nedir? Oda adları neden bu kadar karışık?](https://hotelmapping.org/tr/rehber/oda-eslestirme-nedir/)
- [Oda tipi kısaltmaları sözlüğü: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/tr/rehber/oda-tipi-kisaltmalari/)
- [Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/)
