Hotel-Mapping-Lösungen
Jede Unterkunft erhält eine dauerhafte HM ID; Anbietercodes und Querverweis-IDs in einem Datensatz.
Verpflegungs-Mapping übersetzt die unterschiedlichen Schreibweisen, die Anbieter für dasselbe Verpflegungskonzept senden ("ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil", "Ультра всё включено"), in einen einzigen Standardcode: RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI oder SAI. So wird ein All-Inclusive-Angebot nicht mit einem Ultra-All-Inclusive-Angebot verglichen, als wäre es dasselbe Produkt.
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} AI- und UAI-Angebote bleiben in getrennten Codes. In der Liste ist klar erkennbar, wenn das günstiger wirkende Angebot in Wahrheit ein niedrigeres Konzept bietet.
RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI und SAI. Alle Anbieterschreibweisen werden an diese kurze Liste gebunden; Filter und Berichte arbeiten mit einer einzigen Liste.
Schreibweisen, Tippfehler und Abkürzungen in Türkisch, Englisch, Deutsch und Russisch liegen im Wörterbuch vor: "Herşey Dahil", "Halbpension", "Полупансион".
Eine Schreibweise, die nicht im Wörterbuch steht, wird per Ähnlichkeits-Score einem Code zugeordnet und nach Expertenfreigabe ins Wörterbuch aufgenommen. Eine einmal freigegebene Schreibweise wird nie wieder abgefragt.
Konzepte, die vor allem in Resorts in der Türkei und im Mittelmeerraum verbreitet sind, etwa Ultra All Inclusive, Soft All Inclusive oder Halbpension mit Getränken, werden durch eigene Codes abgedeckt.
Verpflegungsschreibweisen von drei Anbietern für dasselbe Hotel
supplier,hotel_code,rate_code,board
A,HTL-88213,R1,ALL INCLUSIVE ULTRA
B,40917,UAI,Ultra Herşey Dahil
C,TR-ANT-551,UAI-1,Ультра всё включено
A,HTL-88213,R2,Half Board Plus
B,40917,HBP,Yarım Pansiyon + İçecek
C,TR-ANT-551,SAI,Soft All Inc. Standard-Verpflegungscodes
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} Beispieldaten; Hotel und Codes gehören zu keiner realen Unterkunft.
Die eingehende Schreibweise wird in Kleinbuchstaben umgewandelt; Satzzeichen, überzählige Leerzeichen und Abkürzungen wie "Inc." oder "Incl." werden aufgelöst. "Herşey" und "Her Şey" werden vereinheitlicht.
Die normalisierte Schreibweise wird im Synonymwörterbuch jeder Sprache gesucht. Wird sie gefunden, ist sie direkt an den Standardcode gebunden.
Für Schreibweisen, die nicht im Wörterbuch stehen, wird der nächstliegende Code per Ähnlichkeits-Score vorgeschlagen. Score und Methode (Wörterbuch oder Ähnlichkeit) kommen gemeinsam in der Antwort zurück.
Unsichere Vorschläge gehen in die Prüfwarteschlange. Die freigegebene Schreibweise wird ins Wörterbuch aufgenommen und bei der nächsten Anfrage direkt zugeordnet.
Der Standardcode kommt sofort in der API-Antwort zurück. Auch die vom Anbieter gesendete Originalschreibweise wird gespeichert, sodass bei Bedarf eine rückwirkende Prüfung möglich ist.
Die Verpflegungsart ist eines der Felder, die den Hotelpreis am stärksten verändern. Dennoch senden Anbieter sie meist als Freitext und in ihrer jeweiligen Sprache. Das Problem tritt am deutlichsten in Resortmärkten wie der Türkei und dem Mittelmeerraum auf, wo All-Inclusive-Konzepte verbreitet sind, und zeigt sich in vier Formen:
| Code | Bedeutung | Bei Anbietern vorkommende Schreibweisen |
|---|---|---|
| RO | Nur Zimmer | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Zimmer mit Frühstück | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Halbpension | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Halbpension mit Getränken | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Vollpension | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Vollpension mit Getränken | Full Board Plus, Tam Pansiyon Plus |
| AI | All Inclusive | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Erweitertes All Inclusive | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra All Inclusive | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Eingeschränktes All Inclusive | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |
Eine ausführliche Erläuterung der Codes finden Sie im Leitfaden zu Verpflegungsarten, den Unterschied zwischen AI und UAI im Beitrag All Inclusive und Ultra All Inclusive im Vergleich. Zum Begriff siehe die Glossarseite Verpflegungsart.
Bei vielen Mapping-Anbietern wird die Verpflegungsart nicht als eigenes Produkt angeboten. Bei hotelmapping.org ist Verpflegungs-Mapping dagegen ein eigenständiges Produkt mit eigenem Wörterbuch und eigener Prüfwarteschlange; beim Anfordern eines Angebots können Sie es als separates Modul auswählen.
Verpflegungs-Mapping übersetzt die Schreibweise in den Standardcode. Welche Getränke im Ultra-Konzept eines Hotels zu welchen Zeiten angeboten werden, definiert das Hotel selbst; das ist Gegenstand der Hotelbeschreibung, nicht des Verpflegungscodes. Zu Hotelbeschreibungen siehe das Produkt Hotelinhalte. Für einen korrekten Preisvergleich arbeitet der Verpflegungscode zusammen mit Hotel-Mapping und Room-Mapping. Den allgemeinen Rahmen finden Sie im Leitfaden zum Hotel-Mapping; eine einzelne Schreibweise können Sie im Verpflegungscode-Übersetzer ausprobieren.
Anfrage
curl -X POST https://api.hotelmapping.org/v1/boards/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"values": ["Soft All Inc.", "Ultra Herşey Dahil Plus"]
}' Antwort
{
"results": [
{
"input": "Soft All Inc.",
"code": "SAI",
"score": 0.99,
"decision": "auto_match",
"method": "dictionary"
},
{
"input": "Ultra Herşey Dahil Plus",
"code": "UAI",
"score": 0.88,
"decision": "review",
"method": "similarity"
}
]
} Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.
AI (All Inclusive) umfasst in der Regel Mahlzeiten und lokale Getränke. UAI (Ultra All Inclusive) ergänzt dies meist um Zusatzleistungen wie importierte Getränke oder À-la-carte-Restaurants. Der Umfang unterscheidet sich von Hotel zu Hotel; wir übersetzen das Konzept in den Standardcode, den Inhalt des Konzepts bestimmt das Hotel.
Soft AI wird dem eigenen Code SAI zugeordnet. Es ist meist eine eingeschränktere Form von All Inclusive; alkoholische Getränke werden z. B. gar nicht oder nur zu bestimmten Zeiten angeboten. Wird es als AI oder FB+ gespeichert, verfälscht das den Preisvergleich.
Half Board Plus (HB+) ergänzt die Halbpension um Getränke; meist sind beim Abendessen lokale Getränke inklusive, der Umfang unterscheidet sich von Hotel zu Hotel. Sendet ein Anbieter dies nur als HB, geht die Getränkeinformation verloren; der Standardcode bewahrt diesen Unterschied.
Bei vielen Mapping-Anbietern wird die Verpflegungsart nicht als eigenes Produkt angeboten. Bei hotelmapping.org ist Verpflegungs-Mapping dagegen ein eigenes Produkt und arbeitet zusammen mit Hotel- und Room-Mapping.
Ja. Im kostenlosen Verpflegungscode-Übersetzer können Sie eine Schreibweise wie "Ultra Herşey Dahil Plus" eingeben und sehen, welchem Standardcode sie zugeordnet wird.
Angebot anfordern
Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.