# Zimmerbilder-Lösungen

> URL: https://hotelmapping.org/de/produkte/zimmerbilder-loesungen/ · Sprache: Deutsch

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

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

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

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

## So funktioniert es

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. **Sammeln:** Fotos, die ein Anbieter unter einem Zimmercode sendet, werden unter der Standard-Zimmer-ID gesammelt, mit der dieser Code verknüpft ist.
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. **Lieferung:** Bilder, Duplikatgruppen und Anbieter-Zimmercodes kommen zusammen mit den Zimmerdaten in der API-Antwort zurück.

## API-Beispiel

**Die Zimmer eines Hotels mit ihren Bildern abfragen**

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

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

## 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](https://hotelmapping.org/de/produkte/room-mapping-loesungen/) 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](https://hotelmapping.org/de/ratgeber/was-ist-room-mapping/), den allgemeinen Rahmen im [Leitfaden zum Hotel-Mapping](https://hotelmapping.org/de/ratgeber/was-ist-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](https://hotelmapping.org/de/produkte/hotel-mapping-loesungen/) | 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](https://hotelmapping.org/de/produkte/hotelbilder-loesungen/). 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](https://hotelmapping.org/de/produkte/hotelbeschreibungen-loesungen/) 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](https://hotelmapping.org/de/entwickler/) veröffentlicht. Für Umfang und Preis können Sie ein [Angebot anfordern](https://hotelmapping.org/de/angebot-anfordern/).

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

## Verwandte Produkte

- [Room-Mapping-Lösungen](https://hotelmapping.org/de/produkte/room-mapping-loesungen/)
- [Hotelbilder-Lösungen](https://hotelmapping.org/de/produkte/hotelbilder-loesungen/)
- [Hotelbeschreibungen-Lösungen](https://hotelmapping.org/de/produkte/hotelbeschreibungen-loesungen/)

## Verwandte Artikel

- [Was ist Room-Mapping? Warum sind Zimmernamen so chaotisch?](https://hotelmapping.org/de/ratgeber/was-ist-room-mapping/)
- [Glossar der Zimmertyp-Abkürzungen: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/de/ratgeber/zimmertyp-abkuerzungen/)
- [Was ist Hotel-Mapping? So funktioniert es: der umfassende Leitfaden](https://hotelmapping.org/de/ratgeber/was-ist-hotel-mapping/)
