Zimmerbilder-Lösungen

Zimmerbilder ordnet die Fotos, die Anbieter für jedes Zimmer senden, den Standard-Zimmertypen aus dem Room-Mapping zu (z. B. HM-1048213-R03). So erscheint jedes Zimmerangebot mit den eigenen Fotos dieses Zimmers statt mit der allgemeinen Hotelgalerie. Dasselbe Foto aus verschiedenen Quellen wird zu einem Bild gruppiert, und die Bilder kommen zusammen mit den Zimmerdaten aus der API.

Ihre Vorteile

  • Das richtige Zimmer, das richtige Foto

    Das Angebot für ein Zimmer mit Meerblick und Balkon erscheint mit den Fotos genau dieses Zimmers; Gäste müssen ihr Zimmer nicht in der allgemeinen Hotelgalerie suchen.

  • Anbieter vereinen sich in einem Zimmertyp

    Fotos, die drei Anbieter für dasselbe Zimmer senden, werden unter der einen Zimmer-ID gesammelt, die das Room-Mapping erzeugt.

  • Duplikate in einem Bild

    Kopien desselben Zimmerfotos, die von verschiedenen Anbietern und in verschiedenen Größen kommen, werden unter einem Bild gruppiert.

  • Zusammen mit den Zimmerdaten

    Die Bilder kommen in derselben Antwort wie Zimmertyp, Ausblick, Bett und Kapazität zurück; ein separater Matching-Schritt ist nicht nötig.

Vorher und nachher

Zimmerfotos von drei Anbietern

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

Standard-Zimmertypen zugeordnete Bilder

Zimmerbilder HM-1048213
{
  "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 }]
        }
      ]
    }
  ]
}

Beispieldaten; Hotel, Zimmernamen, Codes und Bildadressen gehören zu keiner realen Unterkunft.

So funktioniert es

  1. 1

    Room-Mapping

    Anbieter-Zimmercodes werden über das Room-Mapping mit Standard-Zimmer-IDs verknüpft, die an die HM ID des Hotels gebunden sind.

  2. 2

    Sammeln

    Fotos, die ein Anbieter unter einem Zimmercode sendet, werden unter der Standard-Zimmer-ID gesammelt, mit der dieser Code verknüpft ist.

  3. 3

    Erkennung doppelter Bilder

    Für jedes Bild wird ein inhaltsbasierter Fingerabdruck erstellt; Kopien desselben Zimmerfotos von verschiedenen Anbietern werden zu einem Bild gruppiert.

  4. 4

    Lieferung

    Bilder, Duplikatgruppen und Anbieter-Zimmercodes kommen zusammen mit den Zimmerdaten in der API-Antwort zurück.

Was lösen Zimmerbilder?

Wenn auf einer Hotelseite fünf Zimmerangebote aufgelistet sind, zeigen die meisten Systeme neben jedem Angebot dieselbe allgemeine Galerie. Wer ein Zimmer mit Meerblick und Balkon wählt, sieht ein Pool- oder Lobbyfoto; um zu verstehen, wie das Familienzimmer aussieht, muss er die ganze Galerie durchblättern. Anbieter senden Zimmerfotos meist mit ihren eigenen Zimmercodes, doch diese Codes unterscheiden sich von Anbieter zu Anbieter.

Zimmerbilder ordnet diese Fotos den Standard-Zimmertypen zu, die das Room-Mapping erzeugt. Weil „Dbl Sea View Balcony“, „DZ Meerblick Balkon“ und „Standart Oda Deniz Manzaralı Balkonlu“ derselben Zimmer-ID zugeordnet sind, werden die Fotos aller drei Anbieter im selben Zimmer gesammelt. Wie Zimmertypen standardisiert werden, lesen Sie im Leitfaden Was ist Room-Mapping, den allgemeinen Rahmen im Leitfaden zum Hotel-Mapping.

Hotelbilder und Zimmerbilder

Hotelbilder Zimmerbilder
Zugeordnet zu HM ID des Hotels Standard-Zimmer-ID (z. B. HM-1048213-R03)
Inhalt Außenansicht, Lobby, Pool, Strand, Restaurant, Spa, Gemeinschaftsbereiche Fotos dieses Zimmertyps
Voraussetzung Hotel-Mapping Hotel-Mapping und Room-Mapping
Dublettenerkennung Innerhalb der Hotelgalerie Innerhalb des Zimmertyps
Lieferung Antwort zu Hotelinhalten und Dump Antwort mit Zimmerdaten

Für die allgemeine Galerie des Hotels siehe den Service Hotelbilder. Werden beide Services zusammen genutzt, zeigt die Hotelseite die allgemeine Galerie und jedes Zimmerangebot seine eigenen Fotos.

Wie werden Duplikate aussortiert?

Mehrere Anbieter können dasselbe Zimmerfoto in anderer Größe oder Komprimierung senden. Für jedes Bild wird ein inhaltsbasierter Fingerabdruck erstellt, und identische Aufnahmen innerhalb desselben Zimmertyps werden unter einem Bild gruppiert. Die Antwort enthält für jedes Bild die Anzahl der Kopien und den Anbieter-Zimmercode, aus dem sie stammen.

Lieferung

Die Bilder arbeiten mit denselben HM IDs und Zimmer-IDs wie Hotelinhalte und die Daten des Room-Mappings. Der Endpunkt GET /v1/hotels/{hm_id}/rooms?include=images und die Antwortfelder im Beispiel sind ein Entwurf der API v1; das endgültige Schema wird auf der Entwicklerseite veröffentlicht. Für Umfang und Preis können Sie ein Angebot anfordern.

Was ist Hotel-Mapping? Der ausführliche Ratgeber

API-Beispiel

Anfrage

Die Zimmer eines Hotels mit ihren Bildern abfragen
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
  -H "X-API-Key: $HM_API_KEY"

Antwort

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
        }
      ]
    }
  ]
}

Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.

Häufig gestellte Fragen

Ist für Zimmerbilder ein Room-Mapping nötig?

Ja. Die Fotos werden den Standard-Zimmer-IDs zugeordnet, die das Room-Mapping erzeugt. Solange Zimmertypen nicht standardisiert sind, lassen sich Fotos, die verschiedene Anbieter für dasselbe Zimmer senden, nicht zusammenführen.

Was ist der Unterschied zwischen Zimmerbildern und Hotelbildern?

Hotelbilder sind die allgemeine Galerie des Hotels: Außenansicht, Lobby, Pool, Strand, Restaurant, Spa und Gemeinschaftsbereiche. Zimmerbilder sind Fotos, die jedem Standard-Zimmertyp einzeln zugeordnet werden. Es sind zwei getrennte Services.

Was passiert, wenn ein Anbieter ein Zimmerfoto nicht mit einem Zimmercode sendet?

Ein Zimmerbild wird anhand des Zimmercodes, mit dem der Anbieter das Foto gesendet hat, einem Zimmertyp zugeordnet. Fotos ohne Zimmercode werden keinem Zimmertyp zugeordnet; Fotos auf Hotelebene verarbeitet der Service Hotelbilder.

Liefern Zimmerbilder auch Preis- oder Verfügbarkeitsdaten?

Nein. Zimmerbilder gehören zu den statischen Zimmerdaten. Preis und Verfügbarkeit kommen vom Anbieter in Ihr System; wir liefern nur, zu welchem Zimmer ein Angebot gehört, und die Bilder dieses Zimmers.

Angebot anfordern

Individuelles Angebot erhalten

Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.

  1. 1 Lösungen wählen
  2. 2 Anbieter wählen
  3. 3 Kontaktdaten hinterlassen