# Soluciones de mapeo de destinos

> URL: https://hotelmapping.org/es/productos/soluciones-mapeo-destinos/ · Idioma: Español

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

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

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

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

## Ejemplo de API

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

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

## ¿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](https://hotelmapping.org/es/guia/que-es-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](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/). Para encontrar un HM ID a partir del nombre y las coordenadas, la [API de coincidencia](https://hotelmapping.org/es/productos/soluciones-find-match-api/) 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](https://hotelmapping.org/es/cobertura/). Para los términos, consulte las páginas del glosario [HM ID](https://hotelmapping.org/es/glosario/hm-id/), [código de proveedor](https://hotelmapping.org/es/glosario/codigo-de-proveedor/) y [geocodificación](https://hotelmapping.org/es/glosario/geocodificacion/).

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

## Productos relacionados

- [Soluciones de mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/)
- [Soluciones de Find Match API](https://hotelmapping.org/es/productos/soluciones-find-match-api/)
- [Soluciones de descripciones de hoteles](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/)

## Artículos relacionados

- [¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/)
- [¿Qué es la integración XML hotelera? Diferencia entre datos estáticos y dinámicos](https://hotelmapping.org/es/guia/que-es-integracion-xml-hoteles/)
- [Coste de los hoteles duplicados para la agencia: conversión, cancelaciones y quejas de clientes](https://hotelmapping.org/es/guia/coste-hoteles-duplicados/)
