Normaliza nombres de lugares y gestiona categorías dinámicamente en WME.
# WME Places Name Normalizer — Manual de Usuario
Este script facilita la revisión y normalización de nombres de lugares en Waze Map Editor (WME), aplicando reglas de estilo, sugerencias personalizadas y detectando inconsistencias desde un panel flotante.
---
## Funcionalidades Clave
- **Normalización Inteligente:** Sugiere nombres corregidos según reglas de estilo, ortografía y listas configurables. Maneja de forma avanzada la capitalización y los espacios alrededor de guiones (`-`) y apóstrofes (`'`).
- **Capitalización de Nombres Propios:** Asegura que los artículos y preposiciones (ej. `El`, `La`, `De`, `Del`) dentro de nombres propios siempre comiencen con mayúscula, siguiendo una convención específica.
- **Reemplazos Inteligentes:** La función de reemplazos evita duplicar palabras si el contexto ya existe (ej. `Tienda ARA` no se convierte en `Tienda Tiendas ARA`). También maneja de forma segura reglas como `Terpel` → `Terpel -` sin crear bucles.
- **Detección de Duplicados Cercanos:** Identifica y alerta sobre lugares con el mismo nombre que se encuentran a menos de 50 metros de distancia.
- **Recomendaciones de Categoría Dinámicas:** Ofrece sugerencias de categoría para los lugares, cargadas desde una hoja de Google Sheets.
- **Panel de Estadísticas:** Un panel flotante muestra tu progreso de normalizaciones diarias, semanales, mensuales y totales.
- **Filtro Avanzado de Exclusión:** Permite ocultar del análisis los lugares editados por ti, con un filtro por rango de tiempo.
- **Gestión de Lugares Excluidos:** Ahora puedes excluir lugares completos por su ID, para que no aparezcan en futuras búsquedas.
- **Cálculo y Visualización de Área:** Para los lugares de tipo polígono, muestra su área en metros cuadrados (m²) directamente sobre el icono de tipo en la tabla de resultados. Los lugares con área menor a 400m² se resaltan en rojo con un aviso especial.
- **Interfaz Reactiva y Clara:**
- Los controles se bloquean durante el escaneo para evitar errores.
- Las sugerencias de tilde aparecen resaltadas en color rosado.
- Los lugares corregidos, eliminados o excluidos se marcan visualmente en la tabla (tachado y atenuado) en lugar de desaparecer inmediatamente, y el contador de inconsistencias se actualiza dinámicamente.
- Los mensajes de confirmación son más "bonitos" y descriptivos.
- El botón de enlace (`🔗`) en la tabla ahora solo selecciona el lugar en el panel lateral de WME, sin mover el mapa.
- **Gestión de Datos Centralizada:** Permite gestionar palabras especiales, reemplazos, palabras al inicio (swap) y estadísticas en un solo lugar, con opciones de importación y exportación a través de un archivo XML.
---
## Pestañas del Script
### `Gene` (General) ⚙️
Pestaña principal para configuración y escaneo:
- **Máximo de lugares a revisar:** Define cuántos lugares procesar en cada análisis.
- **Start Scan…:** Inicia el análisis de los lugares visibles en el mapa. **Durante el escaneo, todos los controles de esta pestaña se bloquearán** para garantizar la integridad del análisis.
- **Recomendar categorías:** Activa o desactiva las sugerencias de categoría en el panel de resultados.
- **Excluir lugares cuya última edición sea del Editor:**
- Al marcar esta opción, el script omitirá los lugares que hayas editado recientemente.
- **Excluir solo ediciones de:** Un sub-menú que se activa para definir el rango de tiempo del filtro (`Último día`, `Última Semana`, `Último mes`, etc.).
- **Habilitar panel de estadísticas:** Muestra u oculta el panel flotante con tu conteo de normalizaciones.
---
### `Espe` (Especiales) 🏷️
Pestaña para gestionar listas de exclusión. Ahora incluye un selector:
- **Gestionar: `Palabras Especiales`:**
- Lista de palabras o frases que la normalización **no** debe modificar.
- Permite **añadir, editar, eliminar**, importar y exportar (XML).
- Ideal para marcas (`D'Auto`), siglas (`EPM`, `GOES`), o términos propios que deben conservar su formato exacto (`MallPlaza`).
- **Gestionar: `Lugares Excluidos`:**
- **Nueva funcionalidad:** Permite gestionar una lista de lugares completos (identificados por su ID) que no deben aparecer en las búsquedas del normalizador.
- La lista muestra el **nombre del lugar** para facilitar su identificación, aunque internamente se guarda por ID.
- Permite **eliminar** un lugar de la lista, e **importar/exportar** la lista de IDs a un archivo XML.
---
### `Dicc` (Diccionario) 📘
Conjunto de palabras válidas para mejorar la precisión de las sugerencias ortográficas.
- Se carga **automáticamente** desde Google Sheets al iniciar el editor.
- Puedes **añadir, editar o eliminar** entradas localmente para personalizarlo.
---
### `Reemp` (Reemplazos) 🔂
Dos herramientas principales para automatizar correcciones:
1. **Reemplazo de palabras**
- Define reglas de sustitución (ej. `Av.` → `Avenida`).
- *Lógica mejorada:* Ahora evita crear duplicados. Si tienes una regla `ARA` → `Tiendas ARA`, el script no la aplicará si el nombre ya es `Tienda ARA`. También maneja de forma segura reglas como `Terpel` → `Terpel -` sin crear bucles, y corrige patrones como `D1` a `D1 - Exposiciones`.
2. **Palabras al principio (Swap)**
- Mueve una palabra o frase del final de un nombre al principio.
- *Ejemplo:* "Las Palmas **Urbanización**" → "**Urbanización** Las Palmas".
- La capitalización de palabras como `Los` o `El` en los nombres propios se mantiene correctamente después del swap.
---
## Panel de Resultados
Al finalizar el escaneo, aparece un panel flotante con la lista de inconsistencias.
- **Columna `N°`:** Muestra un icono de estado (✅, 🗑️, 🚫) si la fila ha sido procesada (aplicada, eliminada, excluida), y el número de línea.
- **Columna `Tipo/Ciudad`:**
- Muestra el icono del tipo de lugar (⭔ para área, ⊙ para punto).
- Para los **lugares de área**, se muestra su superficie en **m²** (ej. `329m²`) justo debajo del icono. Si el área es **menor de 400m²**, el número se muestra en **rojo**, y al pasar el ratón por encima (tooltip) indica que debe tener más de 400m² para ser visible en la app.
- A la derecha, muestra el icono de ciudad (🏙️ si tiene ciudad, 🇻🇦 si tiene calle pero no ciudad explícita, 🚫 si no tiene dirección).
- **Columna `⚠️` (Alerta):** Muestra un icono de advertencia si el lugar es un posible duplicado de otro en la lista.
- **Nombre Sugerido:** Puedes editar directamente el nombre en este campo antes de aplicarlo.
- **Sugerencias de reemplazo:** Cajas de sugerencias para corregir palabras individuales con un solo clic. Las sugerencias de tilde aparecen resaltadas en color rosado.
- **Categoría Recomendada:** Ofrece sugerencias de categoría. Al hacer clic en una, se aplica inmediatamente y se marca la fila para indicar el cambio.
### Columna `Acción`
- **Botón `✔` (Aplicar):**
- Inicia **deshabilitado**.
- Se **activa automáticamente** si modificas el nombre o seleccionas una nueva categoría.
- Al hacer clic, aplica los cambios, registra la normalización, marca la fila como procesada y actualiza el contador.
- **Botón `🗑️` (Eliminar):**
- Borra el lugar del mapa. Requiere una confirmación en un popup "bonito".
- Al eliminar, marca la fila como procesada y actualiza el contador.
- **Botón `🏷️` (Añadir a Especiales):** Permite añadir una o más palabras del nombre original a la lista de "Palabras Especiales".
- **Botón `➕` (Excluir Lugar):**
- **Nueva funcionalidad:** Añade el ID del lugar a la lista de "Lugares Excluidos".
- Requiere una confirmación en un popup "bonito".
- Al excluir, marca la fila como procesada y actualiza el contador.
---
## Panel de Estadísticas 📊
Un panel flotante en la parte inferior de la pantalla que rastrea tu actividad.
- Se puede expandir o contraer haciendo clic en él.
- Muestra los contadores de lugares normalizados para:
- **Hoy:** Se reinicia cada día a la medianoche.
- **Esta Semana:** Se reinicia cada lunes.
- **Este Mes:** Se reinicia el primer día de cada mes.
- **Total:** El conteo histórico de todas tus ediciones con el script.
---
## Gestión de Datos y Archivo XML
El script te permite exportar e importar toda tu configuración en un único archivo XML.
- **Contenido del XML:** El archivo guarda **TODO**: Palabras Especiales, Reemplazos, Palabras al Inicio (swap) y tus **Estadísticas**. También permite importar/exportar la nueva lista de **Lugares Excluidos**.
- **Formato de Estadísticas:** Para mantener el archivo pequeño y eficiente, las estadísticas se guardan como totales (total, mensual, semanal, etc.) en lugar de guardar cada evento individual.
---
## Cómo usarlo
1. **Instalar:** Asegúrate de tener Tampermonkey (o similar) e importa el script.
2. **Abrir WME:** Asegúrate de tener un nivel de zoom adecuado para ver los lugares que quieres analizar.
3. **Configurar:**
- En la pestaña `Gene`, ajusta el "Máximo de places a revisar".
- Activa o desactiva las recomendaciones, filtros y el panel de estadísticas según tu preferencia.
- Gestiona tus listas de "Palabras Especiales" y "Lugares Excluidos" en la pestaña `Espe`.
4. **Escanear:** Haz clic en **Start Scan…** y espera a que el análisis termine. Los controles se bloquearán.
5. **Revisar:** En el panel flotante, edita los nombres, aplica sugerencias y cambia categorías. Utiliza los nuevos botones para **excluir lugares** si no deseas que aparezcan más.
6. **Guardar:** Usa el botón de **Guardar** principal de WME para confirmar todos los cambios realizados.
---
## Recursos
- **XML de ejemplo para especiales y reemplazos:** [https://www.simplificatecpro.com/Waze_Scripts/excluded_words.xml]
