# Destinations-Mapping-Lösungen

> URL: https://hotelmapping.org/de/produkte/destinations-mapping-loesungen/ · Sprache: Deutsch

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**

```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)**

```json
{
  "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. **Codes sammeln:** Die Destinationslisten jedes Anbieters und die Standortfelder in den Hoteldatensätzen werden übernommen; der Rohzustand wird gespeichert.
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. **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. **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. **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.

## API-Beispiel

**GET /v1/destinations/{id}**

```bash
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "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._

## 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](https://hotelmapping.org/de/ratgeber/was-ist-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](https://hotelmapping.org/de/produkte/hotel-mapping-loesungen/). Um aus Name und Koordinate eine HM ID zu finden, nutzt die [Find Match API](https://hotelmapping.org/de/produkte/find-match-api-loesungen/) dieselbe Hierarchie. In welchen Ländern die Hierarchie bis zur Ebene Bezirk und Resortgebiet fertiggestellt ist, wird auf der [Abdeckungsseite](https://hotelmapping.org/de/abdeckung/) veröffentlicht. Begriffserklärungen finden Sie auf den Glossarseiten [HM ID](https://hotelmapping.org/de/glossar/hm-id/), [Anbietercode](https://hotelmapping.org/de/glossar/anbietercode/) und [Geokodierung](https://hotelmapping.org/de/glossar/geokodierung/).

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

## Verwandte Produkte

- [Hotel-Mapping-Lösungen](https://hotelmapping.org/de/produkte/hotel-mapping-loesungen/)
- [Find-Match-API-Lösungen](https://hotelmapping.org/de/produkte/find-match-api-loesungen/)
- [Hotelbeschreibungen-Lösungen](https://hotelmapping.org/de/produkte/hotelbeschreibungen-loesungen/)

## Verwandte Artikel

- [Was ist Hotel-Mapping? So funktioniert es: der umfassende Leitfaden](https://hotelmapping.org/de/ratgeber/was-ist-hotel-mapping/)
- [Was ist eine Hotel-XML-Integration? Statische vs. dynamische Daten](https://hotelmapping.org/de/ratgeber/was-ist-eine-hotel-xml-integration/)
- [Kosten von Hotel-Dubletten für Reisebüros: Konversion, Stornos und Kundenbeschwerden](https://hotelmapping.org/de/ratgeber/kosten-von-hotel-dubletten-fuer-reisebueros/)
