Oda resimleri çözümü

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
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
{
  "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. 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. 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. 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. 4

    Teslim

    Resimler, kopya grupları ve tedarikçi oda kodları oda verisiyle birlikte API yanıtında döner.

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 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 rehberinde, genel çerçeveyi otel eşleştirme rehberinde 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 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 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 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 yayımlanır. Kapsam ve fiyat için teklif alabilirsiniz.

Otel eşleştirme nedir? Kapsamlı rehber

API örneği

İstek

Bir otelin odalarını resimleriyle isteme
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"

Yanıt

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

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.

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