Hotel-Mapping-Lösungen
Jede Unterkunft erhält eine dauerhafte HM ID; Anbietercodes und Querverweis-IDs in einem Datensatz.
Die Find Match API nimmt einen einzelnen Hoteldatensatz (Name, Adresse, Koordinaten, falls vorhanden Telefon und Webadresse) entgegen und findet das Gegenstück in der hotelmapping.org-Datenbank. Die Antwort enthält die passende HM ID, einen Konfidenz-Score von 0 bis 1 und die auf diesem Score beruhende Entscheidung. Sie funktioniert auch für Datensätze ohne Anbietercode.
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Für Ihre Vertragshotels, Extranet-Datensätze oder einen Hotelnamen als Freitext genügen Name und Standortangaben.
Jede Antwort enthält Konfidenz-Score und Entscheidungsfeld. Mit eigenen Geschäftsregeln können Sie zusätzlich eingrenzen, welche Datensätze Sie automatisch übernehmen.
Abkürzungen, fehlende Zusätze sowie Namen in kyrillischer und arabischer Schrift durchlaufen die Normalisierung. Unterschiede wie "Rsrt." und "Resort" werden bei der Namensähnlichkeit auf Zeichen- und Wortebene verglichen.
Die wahrscheinlichsten Kandidaten kommen mit Entfernung und Score zurück; das erleichtert die Entscheidung bei Datensätzen, die geprüft werden müssen.
Datensatz ohne Anbietercode aus dem eigenen System des Reisebüros
internal_id,name,city,lat,lng,phone
K-0192,Отель Лара Палм,Анталья,36.8567,30.7969,0242 000 00 00 Ergebnis der Find Match API
{
"reference": "K-0192",
"normalized_name": "lara palm",
"decision": "auto_match",
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"confidence": 0.973,
"signals": {
"name_similarity": 0.95,
"distance_m": 63,
"phone_match": true
}
} Beispieldaten; Hotelname, Telefonnummer und Codes gehören zu keiner realen Unterkunft. Der russische Name wird transliteriert und nach Abtrennung des Zusatzes "Hotel" verglichen.
An den Endpunkt POST /v1/match werden Hotelname und Standortangaben gesendet. Je mehr Koordinaten, Adresse, Telefon und Webadresse hinzukommen, desto stärker wird das Matching.
Zusätze wie "Hotel", "Resort & Spa" oder "Otel" werden vom Namen getrennt; russische und arabische Namen werden transliteriert; die Telefonnummer wird ins internationale Format gebracht, die Webadresse auf die Domain reduziert.
Der Datensatz wird nur mit Hotels in der Nähe verglichen: geografische Zelle von etwa 500 Metern, Namensähnlichkeit, gleiche Telefonnummer oder Domain.
Namensähnlichkeit, mehrsprachige Embedding-Ähnlichkeit, Entfernung, Telefon- und Webübereinstimmung, Sterne und Postleitzahl ergeben zusammen einen Wahrscheinlichkeits-Score zwischen 0 und 1.
Bei einem Score ab 0,97 wird auto_match zurückgegeben, zwischen 0,80 und 0,97 review, unter 0,80 no_match; bei no_match ist hm_id null. Die Antwort enthält zudem die wahrscheinlichsten Kandidaten.
Das Produkt Hotel-Mapping bindet Anbieterdateien gesammelt an HM IDs. Die Find Match API dient dagegen dazu, einen einzelnen Datensatz sofort abzufragen. Typische Einsatzbereiche:
Die allgemeine Logik des Mappings erläutern wir im Leitfaden zum Hotel-Mapping.
| Konfidenz-Score | decision |
Was ist zu tun? |
|---|---|---|
| ab 0,97 | auto_match |
Sie können die HM ID direkt verwenden |
| 0,80–0,97 | review |
Kandidaten prüfen; auf Unterschiede bei Name, Entfernung und Telefon achten |
| unter 0,80 | no_match |
hm_id ist null. Die Unterkunft ist möglicherweise noch nicht in der Datenbank; Name und Standort prüfen |
Die Schwellenwerte werden anhand des manuell annotierten Testsets eingestellt und können sich zwischen Versionen ändern. Aus welchen Signalen sich der Score zusammensetzt, erklären wir unter dem Begriff Match-Score.
reference. Ihre eigene Datensatzkennung kommt in der Antwort unverändert zurück; so lassen sich die Ergebnisse leichter mit Ihrer eigenen Tabelle verknüpfen.Anstatt Tausende Datensätze einzeln abzufragen, übergeben Sie Ihre Datei an den Hotel-Mapping-Ablauf; das Ergebnis kommt über den täglichen Voll- und Delta-Dump zurück. Die Find Match API legt für Datensätze unter 0,80 keine neue Kennung an; im Batch-Import dagegen wird für diese Datensätze eine neue HM ID angelegt (Entscheidung new_id). Mit der gefundenen HM ID erreichen Sie auch Daten zu Destinationen und Hotelinhalten.
Die Antwortfelder entsprechen der API v1; das endgültige Schema wird auf der Entwicklerseite veröffentlicht.
Anfrage
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "res-55821",
"name": "Sunset Bay Rsrt. & Spa - Adults",
"city": "Belek",
"country": "TR",
"lat": 36.8539,
"lng": 31.0556
}' Antwort
{
"reference": "res-55821",
"decision": "auto_match",
"hm_id": "HM-1048213",
"name": "Sunset Bay Resort & Spa",
"confidence": 0.984,
"candidates": [
{ "hm_id": "HM-1048213", "confidence": 0.984, "distance_m": 42 },
{ "hm_id": "HM-1048390", "confidence": 0.412, "distance_m": 310 }
]
} Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.
Die Abfrage per Anbietercode (GET /v1/suppliers/{supplier}/codes/{code}) liefert direkt die HM ID eines bereits zugeordneten Codes. Die Find Match API dagegen sucht einen Datensatz ohne Code oder mit im System unbekanntem Code anhand von Name, Adresse und Koordinaten und berechnet einen neuen Score.
Erforderlich sind Hotelname und Standortangaben (Koordinaten oder Land, Stadt und Adresse). Telefon, Webadresse und Postleitzahl sind optional, verbessern aber den Score.
Vergleichen Sie die Kandidaten in der Antwort anhand von Name, Entfernung und Score. Der Weg, Datensätze, bei denen Sie nicht entscheiden können, an die Expertenprüfung zu senden (Portal oder API), steht noch nicht fest. Expertenentscheidungen fließen als Trainingsdaten in das Modell ein.
Ja. Namen in kyrillischer und arabischer Schrift werden bei der Normalisierung transliteriert; auch die mehrsprachige Embedding-Ähnlichkeit fließt in den Score ein. Sie müssen den Namen nicht selbst übersetzen.
Mit einem Sandbox-Konto können Sie sie anhand von Beispieldaten testen.
Angebot anfordern
Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.