Solutions de mapping des destinations

Le mapping des destinations rattache à une hiérarchie unique les localisations que les fournisseurs envoient à des niveaux et avec des codes différents : pays → province → district → zone de villégiature (Turquie → Antalya → Serik → Belek). Chaque nœud possède un identifiant permanent (par ex. TR-07-SERIK-BELEK), les codes de destination fournisseurs rattachés et les codes IATA des aéroports les plus proches.

Ce que vous y gagnez

  • Une recherche « Belek » renvoie tous les hôtels de Belek

    Même si un fournisseur envoie l'hôtel sous Belek, un autre sous Serik et un troisième seulement sous Antalya, l'hôtel apparaît dans la bonne zone de villégiature.

  • Hiérarchie alignée sur l'organisation administrative locale

    La hiérarchie associe l'organisation administrative du pays en provinces et districts aux zones de villégiature utilisées dans le tourisme. Par exemple, les relations comme Kadriye dans la zone de Belek ou Side dans le district de Manavgat sont enregistrées.

  • Codes fournisseurs sur un seul nœud

    Le code de destination de chaque fournisseur est rattaché au nœud de la hiérarchie, avec l'information du niveau auquel il correspond.

  • Lien avec les aéroports

    Chaque zone de villégiature est associée aux codes IATA des aéroports les plus proches ; les recherches de packages vol + hôtel peuvent utiliser les mêmes données.

Avant et après

Informations de destination de trois fournisseurs pour un même hôtel

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

Localisation dans une hiérarchie unique

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" }
  }
}

Données d'exemple ; l'hôtel et les codes fournisseurs sont fictifs. Les noms de zones et d'aéroports sont réels.

Comment ça marche

  1. 1

    Collecte des codes

    La liste des destinations de chaque fournisseur et les champs de localisation des fiches hôtels sont récupérés ; l'état brut est conservé.

  2. 2

    Détection du niveau

    On détermine à quel niveau (pays, province, district ou zone de villégiature) correspond chaque code fournisseur. « Antalya Region » est au niveau province, « Belek » au niveau zone de villégiature.

  3. 3

    Rattachement à la hiérarchie

    Le code est rattaché au nœud de la hiérarchie grâce à la similarité des noms, aux graphies multilingues et à l'information du niveau supérieur. Les rattachements incertains passent en contrôle par un expert.

  4. 4

    Détermination précise de la localisation de l'hôtel

    Même si le fournisseur n'envoie que la province ou le district, le niveau le plus bas, la zone de villégiature, est déterminé grâce aux coordonnées de l'hôtel retenues parmi les fiches fournisseurs (vérification des coordonnées prévue).

  5. 5

    Livraison

    La hiérarchie et les correspondances de codes sont livrées par l'API et par dump quotidien. Dans les fiches hôtels, l'identifiant de destination et le chemin complet sont renvoyés ensemble.

Pourquoi les destinations ne correspondent-elles pas ?

Les fournisseurs envoient la localisation à des niveaux différents. L’un liste un hôtel de Belek sous « Belek », un autre sous « Serik », un troisième seulement sous « Antalya ». Certains utilisent directement le code de l’aéroport comme destination. Sans mapping, une recherche « Belek » ne renvoie qu’une partie des hôtels, les filtres de zone fonctionnent de façon incomplète et le même hôtel apparaît dans des zones différentes.

Le mapping des destinations rattache tous ces codes à une hiérarchie unique et attribue à chaque hôtel un seul identifiant de destination. Pour le cadre général, consultez le guide du mapping hôtelier.

Hiérarchie

Niveau Exemple Identifiant Remarque
Pays Turquie TR Code pays ISO 3166-1
Province Antalya TR-07 Code de province ISO 3166-2 (numéro d’immatriculation)
District Serik TR-07-SERIK District administratif
Zone de villégiature Belek TR-07-SERIK-BELEK Nom de région utilisé dans le tourisme

Cas difficiles fréquents

Situation Exemple Comment c’est résolu
Le nom de la zone diffère de celui du district Side se trouve dans le district de Manavgat La zone de villégiature est rattachée au bon district
Sous-localité au sein d’une zone Kadriye fait partie de la zone de Belek Le code « Kadriye » du fournisseur est rattaché au nœud Belek
District et zone portent le même nom Kemer ; comprend Beldibi, Göynük, Tekirova Kemer est conservé à la fois comme district et comme zone, les sous-zones sont séparées
Plusieurs aéroports pour une zone Alanya : AYT et GZP La zone est associée aux deux codes IATA
Code uniquement au niveau province « Antalya Region » Le niveau inférieur est déterminé par les coordonnées de l’hôtel

L’identifiant de destination fait partie de la fiche hôtel ; il fonctionne donc avec le mapping hôtelier. Pour trouver un HM ID à partir d’un nom et de coordonnées, l’API de mapping utilise la même hiérarchie. Les pays pour lesquels la hiérarchie est achevée jusqu’au niveau district et zone de villégiature sont publiés sur la page de couverture. Pour les termes, consultez les pages du glossaire HM ID, code fournisseur et géocodage.

Qu'est-ce que le mapping hôtelier ? Le guide complet

Exemple d'API

Requête

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

Réponse

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" }
  ]
}

Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.

Questions fréquentes

Quelle est la différence entre une zone de villégiature et un district ?

Le district est une unité administrative ; la zone de villégiature est un nom de région utilisé dans le tourisme. Belek est une zone de villégiature du district de Serik ; Side, elle, se trouve dans le district de Manavgat. Le voyageur cherche « Belek » ou « Side », alors que le fournisseur envoie souvent le district ou la province.

Dans quelle zone tombe l'hôtel si le fournisseur n'envoie que la province ?

L'hôtel est d'abord rattaché à un HM ID par le mapping hôtelier. Ensuite, les coordonnées retenues parmi les fiches fournisseurs permettent de déterminer dans quel district et quelle zone de villégiature il se trouve ; la vérification des coordonnées est prévue. Le code province du fournisseur est également conservé séparément dans la fiche.

Pourquoi les codes IATA sont-ils rattachés à la destination ?

Les recherches de packages vol + hôtel commencent par l'aéroport d'arrivée. Plusieurs aéroports peuvent desservir une même zone de villégiature ; par exemple, AYT et GZP peuvent tous deux être utilisés pour Alanya. Grâce à ce lien, la recherche peut aller de l'aéroport aux hôtels de la zone.

Dans quels pays le détail district et zone de villégiature est-il prêt ?

Les niveaux district et zone de villégiature doivent être achevés en premier pour la Turquie (Antalya, Muğla, Istanbul), les Émirats arabes unis et l'Égypte. Les pays pour lesquels ce détail est achevé sont indiqués et tenus à jour sur la page de couverture.

Demander un devis

Obtenez votre devis sur mesure

Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.

  1. 1 Sélectionnez les solutions
  2. 2 Sélectionnez les fournisseurs
  3. 3 Laissez vos coordonnées