Soluciones de mapeo de destinos

El mapeo de destinos vincula a una única jerarquía las ubicaciones que los proveedores envían con distinto nivel y distinto código: país → provincia → distrito → zona turística (Turquía → Antalya → Serik → Belek). Cada nodo tiene una identidad permanente (p. ej., TR-07-SERIK-BELEK), los códigos de destino de proveedor vinculados y los códigos IATA de los aeropuertos más cercanos.

Qué ganará

  • Buscar "Belek" devuelve todos los hoteles de Belek

    Aunque un proveedor envíe el hotel bajo Belek, otro bajo Serik y un tercero solo bajo Antalya, el hotel aparece en la zona turística correcta.

  • Jerarquía acorde con la estructura administrativa local

    La jerarquía combina la estructura administrativa de provincias y distritos del país con las zonas turísticas que se usan en el turismo. Por ejemplo, quedan registradas relaciones como que Kadriye pertenece a la zona de Belek o que Side está en el distrito de Manavgat.

  • Códigos de proveedor en un solo nodo

    El código de destino de cada proveedor se vincula al nodo de la jerarquía junto con la información del nivel al que corresponde.

  • Vínculo con el aeropuerto

    Cada zona turística se asocia con los códigos IATA de los aeropuertos más cercanos; las búsquedas de paquetes vuelo + hotel pueden usar los mismos datos.

Antes y después

Información de destino de tres proveedores para el mismo 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

Ubicación en una única jerarquía

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

Datos de ejemplo; el hotel y los códigos de proveedor son ficticios. Los nombres de las zonas y de los aeropuertos son reales.

Cómo funciona

  1. 1

    Recopilación de códigos

    Se toman la lista de destinos de cada proveedor y los campos de ubicación de los registros de hotel; se conserva el formato original.

  2. 2

    Detección del nivel

    Se determina a cuál de los niveles (país, provincia, distrito o zona turística) corresponde cada código de proveedor. "Antalya Region" es de nivel provincia y "Belek" es de nivel zona turística.

  3. 3

    Vinculación a la jerarquía

    El código se vincula al nodo de la jerarquía mediante la similitud de nombre, las grafías multilingües y la información del nivel superior. Los vínculos dudosos pasan a revisión de un especialista.

  4. 4

    Determinación definitiva de la ubicación del hotel

    Aunque el proveedor envíe solo la provincia o el distrito, la zona turística, que es el nivel más bajo, se determina con las coordenadas del hotel elegidas entre los registros de los proveedores (validación de coordenadas prevista).

  5. 5

    Entrega

    La jerarquía y las equivalencias de códigos se entregan por API y mediante dump diario. En los registros de hotel se devuelven juntos el ID de destino y la ruta completa.

¿Por qué no coinciden los destinos?

Los proveedores envían la ubicación en niveles distintos. Uno lista un hotel de Belek bajo “Belek”, otro bajo “Serik” y otro solo bajo “Antalya”. Algunos usan directamente el código del aeropuerto como destino. Sin mapeo, una búsqueda de “Belek” no devuelve parte de los hoteles, los filtros por zona funcionan de forma incompleta y el mismo hotel aparece en zonas distintas.

El mapeo de destinos vincula todos estos códigos a una única jerarquía y asigna a cada hotel un único ID de destino. Para el marco general, consulte la guía de mapeo hotelero.

Jerarquía

Nivel Ejemplo ID Nota
País Turquía TR Código de país ISO 3166-1
Provincia Antalya TR-07 Código de provincia ISO 3166-2 (número de matrícula)
Distrito Serik TR-07-SERIK Distrito administrativo
Zona turística Belek TR-07-SERIK-BELEK Nombre de región usado en el turismo

Casos difíciles frecuentes

Situación Ejemplo Cómo se resuelve
El nombre de la zona turística difiere del distrito Side está en el distrito de Manavgat La zona turística se vincula bajo el distrito correcto
Localidad secundaria dentro de una zona Kadriye pertenece a la zona de Belek El código “Kadriye” del proveedor se vincula al nodo de Belek
Distrito y zona turística con el mismo nombre Kemer; incluye Beldibi, Göynük y Tekirova Kemer se mantiene como distrito y como zona, y se separan las subzonas
Varios aeropuertos para una zona Alanya: AYT y GZP La zona se asocia con ambos códigos IATA
Código solo a nivel de provincia “Antalya Region” El nivel inferior se determina con las coordenadas del hotel

El ID de destino forma parte del registro del hotel; por eso funciona junto con el mapeo hotelero. Para encontrar un HM ID a partir del nombre y las coordenadas, la API de coincidencia usa la misma jerarquía. En qué países se ha completado la jerarquía hasta el nivel de distrito y zona turística se publica en la página de cobertura. Para los términos, consulte las páginas del glosario HM ID, código de proveedor y geocodificación.

¿Qué es el mapeo hotelero? Guía completa

Ejemplo de API

Solicitud

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

Respuesta

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

Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1.

Preguntas frecuentes

¿Qué diferencia hay entre zona turística y distrito?

El distrito es una unidad administrativa; la zona turística es el nombre de región que se usa en el turismo. Belek es una zona turística del distrito de Serik; Side, en cambio, está en el distrito de Manavgat. El huésped busca "Belek" o "Side", mientras que el proveedor suele enviar el distrito o la provincia.

Si el proveedor envía solo la provincia, ¿en qué zona queda el hotel?

Primero el hotel se vincula a un HM ID mediante el mapeo hotelero. A continuación, con las coordenadas elegidas entre los registros de los proveedores, se determina en qué distrito y zona turística está; la validación de coordenadas está prevista. El código de provincia del proveedor también se guarda por separado en el registro.

¿Por qué se vinculan los códigos IATA al destino?

Las búsquedas de paquetes vuelo + hotel empiezan por el aeropuerto de llegada. A una zona turística pueden darle servicio varios aeropuertos; por ejemplo, para Alanya pueden usarse tanto AYT como GZP. Gracias a este vínculo, la búsqueda puede llegar desde el aeropuerto a los hoteles de esa zona.

¿En qué países está listo el detalle de distrito y zona turística?

Está previsto completar primero el nivel de distrito y zona turística para Turquía (Antalya, Muğla, Estambul), los EAU y Egipto. En qué países está completo este detalle se publica y actualiza en la página de cobertura.

Solicitar presupuesto

Reciba su presupuesto a medida

Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.

  1. 1 Seleccione las soluciones
  2. 2 Seleccione los proveedores
  3. 3 Deje sus datos de contacto