Soluciones de mapeo hotelero
Un HM ID permanente por establecimiento; códigos de proveedor e IDs cruzados en un único registro.
El mapeo de habitaciones descompone los distintos nombres que los proveedores envían para una misma habitación en etiquetas de tipo, clase, vista, cama, características y capacidad, y agrupa la misma habitación en un único ID de habitación vinculado al HM ID del hotel (p. ej., HM-1048213-R03). Así, los precios de distintos proveedores para la misma habitación pueden compararse lado a lado.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} "DBL SV BLC", "DZ Meerblick Balkon" y "Deniz Manzaralı Balkonlu Çift Kişilik Oda" se vinculan al mismo ID de habitación; los precios se comparan en una sola fila.
Las abreviaturas y variantes de escritura de habitaciones en TR, EN, DE y RU se guardan en un diccionario de reglas; donde el diccionario no alcanza, interviene el modelo de etiquetado.
Cada nombre de habitación se descompone en seis etiquetas. Filtrar y ordenar por vista, tipo de cama o capacidad no requiere un análisis aparte.
Las habitaciones con vista a tierra y con vista al mar tienen etiquetas distintas; por eso permanecen en IDs de habitación separados y no se muestran en la misma fila.
En una sola petición se mapean al instante varios nombres de habitación; también se ofrece procesamiento por lotes y entrega por archivo para todo el inventario.
Nombres de tres proveedores para la misma habitación
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1) Un único registro de habitación desglosado en etiquetas
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"name": "Standard Double Room, Sea View, Balcony",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"supplier_rooms": {
"A": "DBLSV-B",
"B": "DZMB",
"C": "STD-DNZ"
}
} Datos de ejemplo; el hotel, los nombres de habitación y los códigos no corresponden a un establecimiento real.
El nombre de la habitación se divide en palabras y abreviaturas. Se normalizan mayúsculas y minúsculas, puntuación, capacidad entre paréntesis ("2+1") y diferencias de idioma.
Cada fragmento se asocia con el diccionario de abreviaturas en TR, EN, DE y RU: "SV", "Meerblick" y "Deniz Manzaralı" caen en la misma etiqueta de vista.
Un modelo de etiquetado asigna a tipo, clase, vista, cama, característica o capacidad los fragmentos que no están en el diccionario o que tienen más de un significado.
Las habitaciones vinculadas al mismo HM ID se comparan según sus etiquetas. Los nombres cuyas etiquetas coinciden se vinculan al mismo ID de habitación; los registros contradictorios pasan a revisión humana.
El resultado se devuelve al instante en la respuesta de la API y, en los trabajos por lotes, como archivo. Cada código de habitación de proveedor se guarda junto con el ID de habitación al que se vincula.
Cada proveedor escribe el nombre de la habitación según las reglas de su propio sistema. Uno usa abreviaturas (“DBL SV BLC”), otro el lenguaje de catálogo de los touroperadores alemanes (“DZ Meerblick”) y otro envía tal cual el nombre en turco que figura en el hotel. Si un hotel tiene 10 tipos de habitación y 5 proveedores, el número de nombres por mapear sube a 50. El mapeo manual es lento y las diferencias de vista o de capacidad se pasan por alto con facilidad.
El mapeo de habitaciones descompone cada nombre en las mismas seis etiquetas y realiza la comparación sobre esas etiquetas en lugar de sobre los nombres. Para una explicación detallada del tema, consulte la guía qué es el mapeo de habitaciones y, para el marco general, la guía de mapeo hotelero.
| Etiqueta | Qué describe | Valores de ejemplo |
|---|---|---|
| Tipo | Categoría de la habitación | Habitación, suite, junior suite, estudio, habitación familiar, villa, bungalow, apartamento |
| Clase | Nivel de confort | Económica, estándar, superior, deluxe |
| Vista | Lo que se ve desde la ventana | Mar, lateral al mar, tierra, jardín, piscina |
| Cama | Distribución de las camas | Individual (single), doble (double), dos camas separadas (twin), king, queen |
| Característica | Equipamiento adicional | Balcón, terraza, jacuzzi, acceso directo a la piscina, habitación comunicada |
| Capacidad | Número máximo de personas | SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2 |
El diccionario de reglas vincula a una sola etiqueta las formas de escribir el mismo concepto en cuatro idiomas. Las filas siguientes son ejemplos; la lista completa está en la guía de abreviaturas de tipos de habitación.
| Concepto | EN | DE | TR | RU |
|---|---|---|---|---|
| Uso individual (capacidad 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| Uso doble (capacidad 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| Dos camas separadas (cama: twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| Habitación familiar | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| Vista al mar | SV | Meerblick | Deniz manzaralı | вид на море |
| Balcón | BLC | Balkon | Balkonlu | балкон |
| Suite | STE | Suite | Süit | люкс |
En la mayoría de los proveedores, DBL indica una habitación para dos personas, pero no siempre especifica el tipo de cama. Por eso “DBL” se lee primero como capacidad (al menos 2 personas). Si el nombre no incluye TWN ni “twin”, la etiqueta de cama es double; si hay una pista más clara, como “king”, se usa esa. La etiqueta de tipo, en cambio, es la categoría de la habitación: “DBL Sea View” es una habitación (room) y “Junior Suite” es una junior suite.
El mapeo de habitaciones solo funciona entre habitaciones del mismo hotel; por eso el HM ID del hotel se determina primero con el mapeo hotelero. Para que la comparación de precios sea correcta, junto con la habitación también se necesita el mapeo de regímenes alimenticios. Para los términos, consulte las páginas del glosario mapeo de habitaciones y código de proveedor.
Solicitud
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"rooms": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
]
}' Respuesta
{
"hm_id": "HM-1048213",
"groups": [
{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": [
{ "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
]
},
{
"room_id": "HM-1048213-R07",
"type": "family_room",
"class": "standard",
"view": "land",
"bed": null,
"features": [],
"max_occupancy": 4,
"matched": [
{ "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
]
}
]
} Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1.
Sí. Los nombres de habitación solo se comparan con las habitaciones del mismo hotel. Por eso primero se determina el HM ID del hotel y, a continuación, se agrupan los nombres de habitación de proveedor que pertenecen a ese hotel.
El nuevo nombre se vuelve a etiquetar. Si las etiquetas no cambian, sigue vinculado al mismo ID de habitación. Si cambian, el registro pasa a la cola de revisión y, si es necesario, se vincula a otro ID de habitación.
Está previsto aplicar también a las habitaciones la lógica de umbrales del mapeo hotelero: 0,97 o más se vincula automáticamente, entre 0,80 y 0,97 pasa a un especialista y por debajo de 0,80 se abre un nuevo registro de habitación. Las decisiones de los especialistas retroalimentan el diccionario y el modelo.
En el lanzamiento, el diccionario de reglas cubre las abreviaturas en turco, inglés, alemán y ruso. La cobertura para árabe y otros idiomas aún no está decidida.
No. El mapeo de habitaciones solo estandariza los datos estáticos de habitación. El precio y la disponibilidad llegan a su sistema desde el proveedor; nosotros solo indicamos a qué habitación pertenecen.
Solicitar presupuesto
Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.