Hotel-Mapping-Lösungen
Jede Unterkunft erhält eine dauerhafte HM ID; Anbietercodes und Querverweis-IDs in einem Datensatz.
Destinations-Mapping bindet Standorte, die Anbieter auf unterschiedlichen Ebenen und mit unterschiedlichen Codes senden, an eine einzige Hierarchie: Land → Provinz → Bezirk → Resortgebiet (Türkei → Antalya → Serik → Belek). Jeder Knoten hat eine dauerhafte Kennung (z. B. TR-07-SERIK-BELEK), zugeordnete Anbieter-Destinationscodes und die IATA-Codes der nächstgelegenen Flughäfen.
{
"hm_id": "HM-1048213",
"destination_id": "TR-07-SERIK-BELEK",
"path": [
{ "level": "country", "id": "TR", "name": "Türkiye" },
{ "level": "province", "id": "TR-07", "name": "Antalya" },
{ "level": "district", "id": "TR-07-SERIK", "name": "Serik" },
{ "level": "resort", "id": "TR-07-SERIK-BELEK", "name": "Belek" }
],
"airports": ["AYT"],
"supplier_destinations": {
"A": { "code": "AYT-BLK", "level": "resort" },
"B": { "code": "1452", "level": "district" },
"C": { "code": "ANT", "level": "province" }
}
} Ob ein Anbieter ein Hotel unter Belek, ein anderer unter Serik und ein dritter nur unter Antalya sendet: Das Hotel erscheint im richtigen Resortgebiet.
Die Hierarchie verbindet die Verwaltungsstruktur aus Provinzen und Bezirken mit den im Tourismus üblichen Resortgebieten. Beispielsweise ist hinterlegt, dass Kadriye im Gebiet Belek und Side im Bezirk Manavgat liegt.
Der Destinationscode jedes Anbieters wird zusammen mit der Information, welcher Ebene er entspricht, an den Knoten in der Hierarchie gebunden.
Jedes Resortgebiet wird mit den IATA-Codes der nächstgelegenen Flughäfen verknüpft; Flug-plus-Hotel-Paketsuchen können dieselben Daten nutzen.
Destinationsangaben von drei Anbietern für dasselbe Hotel
supplier,hotel_code,dest_code,dest_name,country,airport
A,HTL-88213,AYT-BLK,Belek,TR,AYT
B,40917,1452,Serik,Turkey,
C,TR-ANT-551,ANT,Antalya Region,TR,AYT Standort in einer einzigen Hierarchie
{
"hm_id": "HM-1048213",
"destination_id": "TR-07-SERIK-BELEK",
"path": [
{ "level": "country", "id": "TR", "name": "Türkiye" },
{ "level": "province", "id": "TR-07", "name": "Antalya" },
{ "level": "district", "id": "TR-07-SERIK", "name": "Serik" },
{ "level": "resort", "id": "TR-07-SERIK-BELEK", "name": "Belek" }
],
"airports": ["AYT"],
"supplier_destinations": {
"A": { "code": "AYT-BLK", "level": "resort" },
"B": { "code": "1452", "level": "district" },
"C": { "code": "ANT", "level": "province" }
}
} Beispieldaten; Hotel- und Anbietercodes sind fiktiv. Die Namen von Gebieten und Flughäfen sind real.
Die Destinationslisten jedes Anbieters und die Standortfelder in den Hoteldatensätzen werden übernommen; der Rohzustand wird gespeichert.
Es wird bestimmt, ob jeder Anbietercode einem Land, einer Provinz, einem Bezirk oder einem Resortgebiet entspricht. "Antalya Region" liegt auf Provinzebene, "Belek" auf Resortebene.
Der Code wird anhand von Namensähnlichkeit, mehrsprachigen Schreibweisen und Informationen der übergeordneten Ebene an den Knoten in der Hierarchie gebunden. Unsichere Zuordnungen gehen in die Expertenprüfung.
Auch wenn ein Anbieter nur Provinz oder Bezirk sendet, wird anhand der aus den Anbieterdatensätzen gewählten Koordinate des Hotels die unterste Ebene, das Resortgebiet, bestimmt (Koordinatenprüfung geplant).
Hierarchie und Code-Zuordnungen werden per API und täglichem Dump geliefert. In den Hoteldatensätzen kommen Destinations-ID und vollständiger Pfad gemeinsam zurück.
Anbieter senden den Standort auf unterschiedlichen Ebenen. Der eine listet ein Hotel in Belek unter “Belek”, ein anderer unter “Serik”, ein dritter nur unter “Antalya”. Manche verwenden als Destination direkt den Flughafencode. Ohne Mapping liefert die Suche nach “Belek” nur einen Teil der Hotels, Gebietsfilter funktionieren unvollständig, und dasselbe Hotel erscheint in verschiedenen Gebieten.
Destinations-Mapping bindet alle diese Codes an eine einzige Hierarchie und weist jedem Hotel eine einzige Destinations-ID zu. Den allgemeinen Rahmen finden Sie im Leitfaden zum Hotel-Mapping.
| Ebene | Beispiel | Kennung | Hinweis |
|---|---|---|---|
| Land | Türkei | TR | ISO-3166-1-Ländercode |
| Provinz | Antalya | TR-07 | ISO-3166-2-Provinzcode (Kfz-Kennzeichennummer) |
| Bezirk | Serik | TR-07-SERIK | Verwaltungsbezirk |
| Resortgebiet | Belek | TR-07-SERIK-BELEK | Im Tourismus gebräuchlicher Gebietsname |
| Fall | Beispiel | Wie wird er gelöst? |
|---|---|---|
| Resortname weicht vom Bezirksnamen ab | Side liegt im Bezirk Manavgat | Das Resortgebiet wird unter den richtigen Bezirk gebunden |
| Ortsteil innerhalb eines Gebiets | Kadriye liegt im Gebiet Belek | Der Anbietercode “Kadriye” wird an den Knoten Belek gebunden |
| Bezirk und Resort tragen denselben Namen | Kemer; darin Beldibi, Göynük, Tekirova | Kemer wird sowohl als Bezirk als auch als Gebiet geführt, die Unterbereiche werden getrennt |
| Mehrere Flughäfen für ein Gebiet | Alanya: AYT und GZP | Das Gebiet wird mit beiden IATA-Codes verknüpft |
| Code nur auf Provinzebene | “Antalya Region” | Die untere Ebene wird über die Koordinate des Hotels bestimmt |
Die Destinations-ID ist Teil des Hoteldatensatzes; sie arbeitet daher zusammen mit dem Hotel-Mapping. Um aus Name und Koordinate eine HM ID zu finden, nutzt die Find Match API dieselbe Hierarchie. In welchen Ländern die Hierarchie bis zur Ebene Bezirk und Resortgebiet fertiggestellt ist, wird auf der Abdeckungsseite veröffentlicht. Begriffserklärungen finden Sie auf den Glossarseiten HM ID, Anbietercode und Geokodierung.
Anfrage
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
-H "X-API-Key: $HM_API_KEY" Antwort
{
"id": "TR-07-SERIK-BELEK",
"name": "Belek",
"level": "resort",
"parent": "TR-07-SERIK",
"path": ["TR", "TR-07", "TR-07-SERIK", "TR-07-SERIK-BELEK"],
"names": { "tr": "Belek", "en": "Belek", "ru": "Белек" },
"airports": ["AYT"],
"supplier_codes": [
{ "supplier": "A", "code": "AYT-BLK", "level": "resort" },
{ "supplier": "D", "code": "BELEK-01", "level": "resort" }
]
} Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.
Ein Bezirk ist eine Verwaltungseinheit; ein Resortgebiet ist ein im Tourismus gebräuchlicher Gebietsname. Belek ist ein Resortgebiet im Bezirk Serik; Side liegt im Bezirk Manavgat. Gäste suchen nach "Belek" oder "Side", Anbieter senden dagegen meist Bezirk oder Provinz.
Das Hotel wird zunächst per Hotel-Mapping an eine HM ID gebunden. Anschließend wird anhand der aus den Anbieterdatensätzen gewählten Koordinate bestimmt, in welchem Bezirk und Resortgebiet es liegt; die Koordinatenprüfung ist geplant. Der Provinzcode des Anbieters wird zusätzlich im Datensatz gespeichert.
Flug-plus-Hotel-Paketsuchen beginnen mit dem Zielflughafen. Ein Resortgebiet kann von mehreren Flughäfen bedient werden; für Alanya etwa kommen sowohl AYT als auch GZP infrage. Über diese Verknüpfung kann die Suche vom Flughafen aus die Hotels in diesem Gebiet erreichen.
Die Ebene Bezirk und Resortgebiet soll zuerst für die Türkei (Antalya, Muğla, Istanbul), die VAE und Ägypten fertiggestellt werden. In welchen Ländern diese Detailtiefe abgeschlossen ist, wird laufend auf der Abdeckungsseite veröffentlicht.
Angebot anfordern
Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.