# Soluciones de mapeo hotelero

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

El mapeo hotelero unifica en una única identidad permanente (HM ID) los distintos nombres, códigos y direcciones que los proveedores envían para un mismo hotel. A ese ID se vinculan los códigos de proveedor, el Google Place ID y las coordenadas; también se conservan como referencia cruzada los IDs de hotel de su proveedor de mapeo actual o de su propio sistema. Así, cada hotel aparece una sola vez en su listado.

## Qué ganará

- **Cada hotel una sola vez en el listado:** Los registros de distintos proveedores para el mismo hotel se agrupan en una sola ficha; la mejor oferta se ve en un único lugar.
- **Identidad permanente:** Un HM ID nunca se reasigna a otro hotel. Cuando dos hoteles se fusionan, el ID antiguo redirige al nuevo.
- **Sus IDs actuales se conservan:** Guardamos como referencia cruzada los IDs de hotel de su proveedor de mapeo actual o de su propio sistema; no pierde el mapeo realizado hasta hoy.
- **Nuevos proveedores operativos con rapidez:** Un nuevo archivo de proveedor pasa por normalización y puntuación y queda vinculado a los HM ID en poco tiempo.

## Antes y después

Registros en bruto de tres proveedores

**supplier_static.csv**

```csv
supplier,code,name,city,lat,lng
A,HTL-88213,Sunset Bay Resort & Spa,Belek,36.8541,31.0552
B,40917,SUNSET BAY RESORT SPA,Serik,36.8543,31.0549
C,TR-ANT-551,Sunset Bay Rsrt. & Spa - Adults,Antalya,36.8539,31.0556
```

Registro estándar bajo un único HM ID

**GET /v1/hotels/HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "name": "Sunset Bay Resort & Spa",
  "destination_id": "TR-07-SERIK-BELEK",
  "destination": ["TR", "Antalya", "Serik", "Belek"],
  "geo": { "lat": 36.8541, "lng": 31.0552 },
  "supplier_codes": {
    "A": "HTL-88213",
    "B": "40917",
    "C": "TR-ANT-551"
  },
  "external_ids": { "client": "OTL-2231" },
  "status": "active"
}
```

_Datos de ejemplo; el nombre del hotel y los códigos no corresponden a un establecimiento real._

## Cómo funciona

1. **Ingesta de datos:** Recibimos los datos estáticos del proveedor por API, CSV o FTP. Cada registro se guarda tal cual llega y los cambios quedan versionados.
2. **Normalización:** Se separan del nombre del hotel sufijos como "Hotel" o "Resort & Spa"; los nombres en ruso y árabe se transliteran al alfabeto latino; la dirección, el teléfono y la web se llevan a un formato estándar.
3. **Generación de candidatos y puntuación:** Cada registro se compara solo con los hoteles cercanos. La similitud de nombre, los embeddings multilingües, la distancia y la coincidencia de teléfono y web se combinan en una puntuación de probabilidad entre 0 y 1.
4. **Decisión y revisión humana:** Si la puntuación es de 0,97 o más, la coincidencia es automática; los registros entre 0,80 y 0,97 llegan a un especialista en una pantalla de revisión con mapa; por debajo de 0,80 se crea un nuevo HM ID.
5. **Entrega:** El resultado le llega por API REST y mediante dump diario completo y delta (CSV, JSON, Parquet); los webhooks están previstos.

## Ejemplo de API

**Del código de proveedor al HM ID**

```bash
curl https://api.hotelmapping.org/v1/suppliers/B/codes/40917 \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "supplier": "B",
  "code": "40917",
  "hm_id": "HM-1048213",
  "confidence": 0.998,
  "matched_at": "2026-11-02T08:14:00Z"
}
```

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

## ¿Por qué es necesario el mapeo hotelero?

Una agencia trabaja de media con varios proveedores, y cada proveedor envía el mismo hotel con su propio nombre, su propio código y sus propias coordenadas. Sin mapeo, el mismo hotel aparece varias veces en el listado, la comparación de precios se distorsiona y el cliente no sabe qué ficha es la correcta.

hotelmapping.org trabaja con 3,5 millones de hoteles en todo el mundo y unifica esos registros en una única identidad permanente, el **HM ID**. Usted trabaja únicamente con el HM ID; nosotros llevamos el control de qué proveedor usa qué código.

## ¿Qué vinculamos?

| Campo | Descripción |
| --- | --- |
| Códigos de proveedor | El código de hotel de cada proveedor, vinculado al HM ID |
| IDs de hotel externos | IDs de su proveedor de mapeo actual o de su propio sistema; si existen, se guardan como referencia cruzada |
| Google Place ID | Referencia adicional de ubicación e identidad |
| Coordenadas | Latitud y longitud elegidas entre los registros de los proveedores (validación de coordenadas prevista) |
| Destino | Jerarquía país → provincia → distrito → zona turística |

## ¿Cómo se mide la calidad?

La calidad del mapeo se mide en cada versión con un conjunto de prueba etiquetado manualmente. En el sitio solo publicamos cifras verificadas con esta medición; los valores actuales figuran en la [página de cobertura](https://hotelmapping.org/es/cobertura/).

## Preguntas frecuentes

### ¿Cuál es la diferencia entre el HM ID y el código de proveedor?

El código de proveedor solo es válido en el sistema de ese proveedor y cambia de un proveedor a otro. El HM ID, en cambio, es la identidad permanente que asignamos nosotros y que reúne todos los códigos de proveedor del mismo hotel.

### ¿Qué ocurre si hay una coincidencia incorrecta?

Las puntuaciones dudosas no se emparejan automáticamente, sino que pasan a revisión humana. Aun así, si nos notifica un error, el registro se corrige y esa decisión se incorpora al modelo como dato de entrenamiento.

### ¿Qué pasa con el HM ID si un hotel cierra o dos hoteles se fusionan?

Un HM ID nunca se asigna a otro hotel. Cuando un hotel cierra, su estado pasa a "closed". Cuando dos hoteles se fusionan, el estado del ID antiguo pasa a "merged" y el campo merged_into apunta al nuevo ID.

### Si cambiamos de otro proveedor de mapeo, ¿podemos seguir usando nuestros IDs de hotel actuales?

Sí. Guardamos como referencia cruzada los IDs de hotel de su proveedor de mapeo actual o de su propio sistema; estos IDs se devuelven en la respuesta de la API, en el campo external_ids, junto con el HM ID. Así puede pasar al HM ID sin abandonar su mapeo existente.

## Productos relacionados

- [Soluciones de mapeo de habitaciones](https://hotelmapping.org/es/productos/soluciones-mapeo-habitaciones/)
- [Soluciones de mapeo de regímenes alimenticios](https://hotelmapping.org/es/productos/soluciones-mapeo-regimenes-alimenticios/)
- [Soluciones de Find Match API](https://hotelmapping.org/es/productos/soluciones-find-match-api/)

## 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/)
- [Coste de los hoteles duplicados para la agencia: conversión, cancelaciones y quejas de clientes](https://hotelmapping.org/es/guia/coste-hoteles-duplicados/)
- [12 preguntas que hay que hacer al elegir una API de mapeo hotelero](https://hotelmapping.org/es/guia/12-preguntas-elegir-api-mapeo-hotelero/)
