Solutions de mapping hôtelier
Un HM ID permanent pour chaque établissement ; codes fournisseurs et ID croisés dans une seule fiche.
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.
{
"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" }
}
} 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.
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.
Le code de destination de chaque fournisseur est rattaché au nœud de la hiérarchie, avec l'information du niveau auquel il correspond.
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.
Informations de destination de trois fournisseurs pour un même hôtel
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
{
"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.
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é.
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.
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.
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).
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.
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.
| 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 |
| 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.
Requête
curl https://api.hotelmapping.org/v1/destinations/TR-07-SERIK-BELEK \
-H "X-API-Key: $HM_API_KEY" Réponse
{
"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.
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.
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.
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.
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
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.