Room-Mapping-Lösungen
Zerlegt Zimmernamen in Typ, Klasse, Aussicht, Bett und Kapazität; bündelt gleiche Zimmer in einer Zimmer-ID.
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.
{
"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 }]
}
]
}
]
} 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.
Fotos, die drei Anbieter für dasselbe Zimmer senden, werden unter der einen Zimmer-ID gesammelt, die das Room-Mapping erzeugt.
Kopien desselben Zimmerfotos, die von verschiedenen Anbietern und in verschiedenen Größen kommen, werden unter einem Bild gruppiert.
Die Bilder kommen in derselben Antwort wie Zimmertyp, Ausblick, Bett und Kapazität zurück; ein separater Matching-Schritt ist nicht nötig.
Zimmerfotos von drei Anbietern
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
{
"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.
Anbieter-Zimmercodes werden über das Room-Mapping mit Standard-Zimmer-IDs verknüpft, die an die HM ID des Hotels gebunden sind.
Fotos, die ein Anbieter unter einem Zimmercode sendet, werden unter der Standard-Zimmer-ID gesammelt, mit der dieser Code verknüpft ist.
Für jedes Bild wird ein inhaltsbasierter Fingerabdruck erstellt; Kopien desselben Zimmerfotos von verschiedenen Anbietern werden zu einem Bild gruppiert.
Bilder, Duplikatgruppen und Anbieter-Zimmercodes kommen zusammen mit den Zimmerdaten in der API-Antwort zurück.
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 | 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.
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.
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.
Anfrage
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=images" \
-H "X-API-Key: $HM_API_KEY" Antwort
{
"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.
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.
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.
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.
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
Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.