Destinations-Mapping-Lösungen

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.

Ihre Vorteile

  • Die Suche nach "Belek" liefert alle Hotels in Belek

    Ob ein Anbieter ein Hotel unter Belek, ein anderer unter Serik und ein dritter nur unter Antalya sendet: Das Hotel erscheint im richtigen Resortgebiet.

  • Hierarchie passend zur lokalen Verwaltungsstruktur

    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.

  • Anbietercodes in einem Knoten

    Der Destinationscode jedes Anbieters wird zusammen mit der Information, welcher Ebene er entspricht, an den Knoten in der Hierarchie gebunden.

  • Flughafenverknüpfung

    Jedes Resortgebiet wird mit den IATA-Codes der nächstgelegenen Flughäfen verknüpft; Flug-plus-Hotel-Paketsuchen können dieselben Daten nutzen.

Vorher und nachher

Destinationsangaben von drei Anbietern für dasselbe Hotel

supplier_destinations.csv
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

GET /v1/hotels/HM-1048213 (destination)
{
  "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.

So funktioniert es

  1. 1

    Codes sammeln

    Die Destinationslisten jedes Anbieters und die Standortfelder in den Hoteldatensätzen werden übernommen; der Rohzustand wird gespeichert.

  2. 2

    Ebene bestimmen

    Es wird bestimmt, ob jeder Anbietercode einem Land, einer Provinz, einem Bezirk oder einem Resortgebiet entspricht. "Antalya Region" liegt auf Provinzebene, "Belek" auf Resortebene.

  3. 3

    An die Hierarchie binden

    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.

  4. 4

    Hotelstandort präzisieren

    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).

  5. 5

    Auslieferung

    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.

Warum passen Destinationen nicht zusammen?

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.

Hierarchie

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

Häufige Problemfälle

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.

Was ist Hotel-Mapping? Der ausführliche Ratgeber

API-Beispiel

Anfrage

GET /v1/destinations/{id}
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"

Antwort

200 OK
{
  "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.

Häufig gestellte Fragen

Was ist der Unterschied zwischen Resortgebiet und Bezirk?

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.

Welchem Gebiet wird ein Hotel zugeordnet, wenn der Anbieter nur die Provinz sendet?

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.

Warum werden IATA-Codes an die Destination gebunden?

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.

In welchen Ländern ist die Detailtiefe Bezirk und Resortgebiet verfügbar?

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

Individuelles Angebot erhalten

Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.

  1. 1 Lösungen wählen
  2. 2 Anbieter wählen
  3. 3 Kontaktdaten hinterlassen