Hotel-Mapping-Lösungen
Jede Unterkunft erhält eine dauerhafte HM ID; Anbietercodes und Querverweis-IDs in einem Datensatz.
Room-Mapping zerlegt die unterschiedlichen Bezeichnungen, die Anbieter für dasselbe Zimmer senden, in Labels für Zimmertyp, Klasse, Aussicht, Bett, Ausstattung und Kapazität und bündelt dasselbe Zimmer in einer Zimmerkennung, die an die HM ID des Hotels gebunden ist (z. B. HM-1048213-R03). So lassen sich die Preise verschiedener Anbieter für dasselbe Zimmer direkt nebeneinander vergleichen.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} "DBL SV BLC", "DZ Meerblick Balkon" und "Deniz Manzaralı Balkonlu Çift Kişilik Oda" werden derselben Zimmerkennung zugeordnet; die Preise lassen sich in einer Zeile vergleichen.
Zimmerkürzel und Schreibweisen in TR, EN, DE und RU liegen in einem Regelwörterbuch vor; wo das Wörterbuch nicht ausreicht, greift das Labeling-Modell.
Jeder Zimmername wird in sechs Labels zerlegt. Filtern und Sortieren nach Aussicht, Bettart oder Kapazität erfordert keine separate Auswertung mehr.
Zimmer mit Landblick und Zimmer mit Meerblick haben unterschiedliche Labels; sie bleiben daher in getrennten Zimmerkennungen und werden nicht in derselben Zeile angezeigt.
Mehrere Zimmernamen lassen sich in einer einzigen Anfrage sofort zuordnen; für den gesamten Bestand gibt es Batch-Verarbeitung und Dateiauslieferung.
Bezeichnungen von drei Anbietern für dasselbe Zimmer
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1) Ein Zimmerdatensatz mit Labels
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} Beispieldaten; Hotel, Zimmernamen und Codes gehören zu keiner realen Unterkunft.
Der Zimmername wird in Wörter und Kürzel zerlegt. Groß- und Kleinschreibung, Satzzeichen, Kapazitätsangaben in Klammern ("2+1") und Sprachunterschiede werden normalisiert.
Jeder Teil wird mit dem Kürzelwörterbuch in TR, EN, DE und RU abgeglichen: "SV", "Meerblick" und "Deniz Manzaralı" ergeben dasselbe Aussichts-Label.
Teile, die nicht im Wörterbuch stehen oder mehrdeutig sind, ordnet ein Labeling-Modell Typ, Klasse, Aussicht, Bett, Ausstattung oder Kapazität zu.
Zimmer, die an dieselbe HM ID gebunden sind, werden anhand ihrer Labels verglichen. Namen mit übereinstimmenden Labels werden derselben Zimmerkennung zugeordnet; widersprüchliche Datensätze gehen in die manuelle Prüfung.
Das Ergebnis kommt in der API-Antwort sofort zurück, bei Batch-Aufträgen als Datei. Jeder Anbieter-Zimmercode wird zusammen mit der zugeordneten Zimmerkennung gespeichert.
Jeder Anbieter schreibt Zimmernamen nach den Regeln seines eigenen Systems. Der eine verwendet Kürzel (“DBL SV BLC”), ein anderer die Katalogsprache deutscher Reiseveranstalter (“DZ Meerblick”), ein dritter übernimmt den türkischen Namen des Hotels unverändert. Hat ein Hotel 10 Zimmertypen und 5 Anbieter, steigt die Zahl der zuzuordnenden Namen auf 50. Manuelles Mapping ist langsam, und Unterschiede bei Aussicht oder Kapazität werden leicht übersehen.
Room-Mapping zerlegt jeden Namen in dieselben sechs Labels und führt den Vergleich über diese Labels statt über die Namen. Ausführliche Erläuterungen finden Sie im Leitfaden Was ist Room-Mapping, den allgemeinen Rahmen im Leitfaden zum Hotel-Mapping.
| Label | Bedeutung | Beispielwerte |
|---|---|---|
| Typ | Zimmerkategorie | Zimmer, Suite, Junior Suite, Studio, Familienzimmer, Villa, Bungalow, Apartment |
| Klasse | Komfortniveau | Economy, Standard, Superior, Deluxe |
| Aussicht | Blick aus dem Fenster | Meer, seitlicher Meerblick, Land, Garten, Pool |
| Bett | Bettenanordnung | Einzelbett (single), Doppelbett (double), zwei getrennte Betten (twin), King, Queen |
| Ausstattung | Zusätzliche Ausstattung | Balkon, Terrasse, Whirlpool, Zimmer mit Poolzugang, Verbindungszimmer |
| Kapazität | Maximale Personenzahl | SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2 |
Das Regelwörterbuch ordnet die Schreibweisen desselben Konzepts in vier Sprachen einem einzigen Label zu. Die folgenden Zeilen sind Beispiele; die vollständige Liste finden Sie im Leitfaden Zimmertyp-Abkürzungen.
| Konzept | EN | DE | TR | RU |
|---|---|---|---|---|
| Einzelbelegung (Kapazität 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| Doppelbelegung (Kapazität 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| Zwei getrennte Betten (Bett: twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| Familienzimmer | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| Meerblick | SV | Meerblick | Deniz manzaralı | вид на море |
| Balkon | BLC | Balkon | Balkonlu | балкон |
| Suite | STE | Suite | Süit | люкс |
DBL bezeichnet bei den meisten Anbietern ein Zimmer für zwei Personen, nennt aber nicht immer die Bettart. Deshalb wird “DBL” zunächst als Kapazität gelesen (mindestens 2 Personen). Enthält der Name weder TWN noch “twin”, lautet das Bett-Label double; bei einem eindeutigeren Hinweis wie “king” wird dieser verwendet. Das Typ-Label dagegen ist die Zimmerkategorie: “DBL Sea View” ist ein Zimmer (room), “Junior Suite” eine Junior Suite.
Room-Mapping arbeitet nur innerhalb der Zimmer desselben Hotels; deshalb wird zuerst mit dem Hotel-Mapping die HM ID des Hotels bestimmt. Für einen korrekten Preisvergleich ist zusammen mit dem Zimmer auch das Verpflegungs-Mapping erforderlich. Begriffserklärungen finden Sie auf den Glossarseiten Room-Mapping und Anbietercode.
Anfrage
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"rooms": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
]
}' Antwort
{
"hm_id": "HM-1048213",
"groups": [
{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
]
},
{
"room_id": "HM-1048213-R07",
"type": "family_room",
"class": "standard",
"view": "land",
"bed": null,
"features": [],
"max_occupancy": 4,
"matched": [
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
]
}
]
} Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.
Ja. Zimmernamen werden nur mit den Zimmern desselben Hotels verglichen. Deshalb wird zuerst die HM ID des Hotels bestimmt und anschließend werden die Zimmernamen der Anbieter für dieses Hotel gruppiert.
Der neue Name wird neu mit Labels versehen. Bleiben die Labels gleich, bleibt die Zuordnung zur selben Zimmerkennung bestehen. Ändern sie sich, gelangt der Datensatz in die Prüfwarteschlange und wird bei Bedarf an eine andere Zimmerkennung gebunden.
Es ist geplant, die Schwellenlogik des Hotel-Mappings auch auf Zimmer anzuwenden: ab 0,97 wird automatisch zugeordnet, zwischen 0,80 und 0,97 geht der Fall an einen Experten, unter 0,80 wird ein neuer Zimmerdatensatz angelegt. Expertenentscheidungen fließen in Wörterbuch und Modell zurück.
Das Regelwörterbuch deckt zum Start Abkürzungen in Türkisch, Englisch, Deutsch und Russisch ab. Die Abdeckung für Arabisch und weitere Sprachen steht noch nicht fest.
Nein. Room-Mapping standardisiert ausschließlich statische Zimmerdaten. Preise und Verfügbarkeit kommen vom Anbieter in Ihr System; wir sagen lediglich, zu welchem Zimmer sie gehören.
Angebot anfordern
Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.