WME Places Name Normalizer — Manual de Usuario v9.3.0

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.

---

🆕 Novedades en v9.3.0

🏫 Visualizador de Zonas Escolares

Nueva funcionalidad que detecta automáticamente si las instituciones educativas tienen zona escolar asociada:

• Detección Automática: Busca permanent hazards tipo 9 (zonas escolares) en un radio de 100 metros desde el centro de cada institución educativa.
• Indicadores Visuales:
  • 🟩 Verde brillante: La escuela SÍ tiene zona escolar cercana
  • 🟥 Rojo: La escuela NO tiene zona escolar (requiere atención)
• Cuadros de 100x100m: Las escuelas tipo punto se visualizan como cuadros grandes para mejor visibilidad en el mapa.
• Cálculo Preciso: Usa conversión correcta de coordenadas (EPSG:4326 → EPSG:3857) para medir distancias en metros.

Cómo Funciona la Detección

🏫 Centro de la escuela ←→ 🚸 Centro de la zona escolar
            ↓
    ¿Distancia ≤ 100m?
    ✅ SÍ → Marcar en VERDE
    ❌ NO → Marcar en ROJO

Nota para Champs: Las zonas escolares deben dibujarse como un área alrededor de la escuela (no como una marca lineal sobre una sola vía) para que la detección funcione correctamente y proteja TODAS las calles cercanas.

🔇 Modo Debug Silencioso

Todos los logs de desarrollo ahora están ocultos por defecto. Para activarlos:

window.__PLN_DECISION_DEBUG_ON = true

---

Funcionalidades Clave

• Normalización Inteligente: Sugiere nombres corregidos según reglas de estilo, ortografía y listas configurables. Maneja capitalización y espacios alrededor de guiones (-) y apóstrofes (').
• Regla de Artículos y Palabras Comunes: Las commonWords (p. ej. de, el, la, y, a, en, etc.) van en minúscula en los nombres, salvo si son la primera palabra o si aparecen justo después de - o (.
• Reemplazos Inteligentes: Evita duplicados si el contexto ya existe. Reglas como Terpel → Terpel - no generan bucles; patrones como D1 → D1 - insertan el guion solo cuando corresponde.
• Swap Words Mejorado: Puedes mover palabras al inicio o al final con una interfaz completa para editar, borrar y reordenar reglas.
• Feedback Visual Inmediato: Las filas aplicadas, borradas o excluidas se tachan y desaparecen, y el contador se actualiza al instante.
• Botón Mostrar/Ocular Procesados: Permite concentrarte en los lugares pendientes sin ruido visual.
• Corrección de Siglas Punteadas: Ejemplo: S.A.S → SAS, I.N.T. → INT.
• Detección de Duplicados Cercanos: Identifica y alerta sobre lugares con el mismo nombre a ≤ 50 m.
• Recomendaciones de Categoría Dinámicas: Sugerencias cargadas desde Google Sheets.
• Panel de Estadísticas: Conteo diario, semanal, mensual y total de normalizaciones en un panel flotante.
• Filtro de Exclusión por Editor y Tiempo: Permite omitir lugares editados por ti, con rango de tiempo.
• Gestión de Lugares Excluidos: Puedes excluir lugares completos por ID para que no aparezcan en futuras búsquedas. Incluye importación/exportación.
• Cálculo y Visualización de Área: Para polígonos, muestra el área en m² en la tabla. Si el área es < 400 m², se resalta con aviso; el valor puede titilar para llamar la atención.
• Alertas Permanentes: El script muestra alertas visuales persistentes para situaciones críticas como horarios solapados o ediciones pendientes.
• Interfaz Flexible:
  • Minimizar y restaurar el panel flotante y el panel de resultados para liberar espacio de mapa.
  • Controles se bloquean durante el escaneo.
  • Sugerencias de tilde resaltadas.
  • Campos de texto más grandes para editar nombres con comodidad.
  • El botón de enlace (🔗) solo selecciona el lugar en el panel lateral sin mover el mapa.
• Gestión de Datos Centralizada: Palabras especiales, reemplazos, swap y estadísticas en un solo lugar, con importación/exportación XML.
• Direcciones: Permite asignar ciudad a lugares que no la tienen desde el panel, intentando aplicar la dirección en la UI de forma automática.

---

Funcionalidades Exclusivas (Nivel 4+)

Integración EasyShortCuts 🚀

Para editores de rango Region Manager (Nivel 4) o superior, NrmliZer integra las herramientas de EasyShortCuts:

• Botón Flotante: Icono circular ubicado en la parte inferior de la pantalla para acceso rápido a las funciones del módulo.
• Alertas Permanentes: Facilita la colocación de alertas permanentes en el mapa.
• Ángulos de Vías: Herramienta para visualizar y corregir los ángulos de las vías donde se deben ubicar las alertas.
• 🏫 Visualizador de Zonas Escolares: Botón para activar/desactivar la visualización de zonas escolares en instituciones educativas.

Filtro de Update Requests (URs) 🔔

• Checkbox "🔔 Solo lugares con URs pendientes": Ubicado en la pestaña Gene.
• Función: Filtra la lista de resultados para mostrar únicamente aquellos lugares que tienen solicitudes de actualización (Update Requests) pendientes.
• Objetivo: Permite a los editores de alto nivel priorizar la revisión de lugares con reportes de usuarios o problemas pendientes.

---

Pestañas del Script

Gene (General) ⚙️

• Máximo de lugares a revisar.
• Start Scan… inicia el análisis de lugares visibles. Durante el escaneo los controles se bloquean.
• Recomendar categorías activa las sugerencias en resultados.
• Excluir lugares cuya última edición sea del Editor + rango de tiempo.
• Habilitar panel de estadísticas para mostrar/ocultar el panel 📊.
• Minimizar/Restaurar panel desde la cabecera para ganar espacio.
• (Nivel 4+) Filtro de URs: Checkbox para ver solo lugares con URs pendientes.

Espe (Especiales) 🏷️

Gestión de listas de exclusión:

• Palabras Especiales: lista de términos que no deben modificarse. Permite añadir/editar/eliminar, importar/exportar (XML). Se filtran palabras comunes, ya excluidas o presentes en el diccionario.
• Lugares Excluidos: lista de IDs de lugares que el normalizador omitirá en futuras búsquedas. Muestra el nombre cuando está disponible. Permite eliminar un ID y importar/exportar la lista.

Dicc (Diccionario) 📘

• Se carga automáticamente desde Google Sheets con una base de datos de más de 62,000 palabras.
• Puedes añadir/editar/eliminar entradas locales.

Reemp (Reemplazos) 🔂

1) Reemplazo de palabras - Reglas tipo Av. → Avenida.

• Evita duplicar contexto existente y maneja casos como Terpel → Terpel - sin bucles. 2) Swap avanzado: - Mueve una palabra al principio o al final según la regla.
  
• Incluye UI para gestionar reglas.
  
• Respeta capitalización correcta de artículos tras el swap según la regla de commonWords.

---

Panel de Resultados

• N°: Estado (✅ aplicado, 🗑️ eliminado, 🚫 excluido) y número de línea.
• Tipo/Ciudad:
  • Icono de tipo (⭔ área, ⊙ punto).
    
  • Área en m² bajo el icono para polígonos. Alerta si < 400 m². Puede titilar para destacar.
    
  • Icono de dirección: Indica el estado de la ciudad.
  • Lugares normales: ✅ tiene ciudad, 🚩 falta ciudad (clic para asignar).
  • Ríos/Arroyos: ✅ sin ciudad (correcto), ❗ tiene ciudad (incorrecto, clic para borrar).
• ⚠️ (Alerta): Marca posibles duplicados ≤ 50 m, horarios solapados (⏰) y ediciones pendientes (📨).
• Nombre sugerido: Editable antes de aplicar.
• Sugerencias de reemplazo: Cajas de un clic, incluidas tildes destacadas.
• Categoría recomendada: Clic para aplicar y marcar la fila.
• Mostrar/Ocultar procesados: Botón en la cabecera para alternar filas ya resueltas.
• Minimizar/Restaurar: Botón en la cabecera del panel para alternar vista.

Acciones

• ✔ Aplicar: Se activa al cambiar nombre o categoría. Aplica, registra, marca la fila y actualiza contador.
• 🗑️ Eliminar: Elimina el lugar tras confirmación.
• 🏷️ Añadir a Especiales: Añade palabras del nombre a "Palabras Especiales".
• 📵 Excluir Lugar: Agrega el ID a "Lugares Excluidos" tras confirmación.
• 🚩 ó ❗ Ciudad (Acción Inteligente):
  • En lugares normales: Abre modal para asignar ciudad.
  • En Ríos/Arroyos: Pide confirmación para eliminar la ciudad (corrección).

---

Panel de Estadísticas 📊

• Se puede expandir/contraer con un clic.
• Muestra Hoy, Esta Semana, Este Mes, Total.
• Los contadores se reinician por período y se guardan en el navegador.

---

Reglas de Nombres: Capitalización, Guiones y Siglas

• Artículos y palabras comunes: en minúscula por defecto.
  Se capitalizan solo si son la primera palabra o si van después de - o (.
  Ejemplos:
  • La Toscana → La Toscana
    
  • parque la flora → Parque la flora
    
  • Mercado - la 80 → Mercado - La 80
    
  • Centro Comercial (la colina) → Centro Comercial (La colina)
• Guiones: sin duplicar -- y sin - final suelto.
  
• Siglas punteadas: "S.A.S" → "SAS", "I.N.T." → "INT".

---

Checkbox "Excluir al Aplicar" (☑️)

Este checkbox agiliza el flujo de trabajo al combinar dos acciones en una.

Función: Si marcas esta casilla y luego presionas el botón "Aplicar" (✔), el script primero añadirá el lugar a tu lista de excluidos y después aplicará cualquier cambio de nombre o categoría que hayas realizado.

Nombre Guardado: Al usar esta opción, el nombre que se guardará en la lista de excluidos será el del campo "Nombre Sugerido".

Uso: Es ideal para corregir y descartar un lugar en un solo paso, sin necesidad de usar el botón de exclusión (📵) por separado.

---

Alerta de Horarios Solapados (⏰)

Este ícono te alerta sobre posibles errores en la configuración de los horarios de apertura de un lugar.

Qué significa: El ícono rojo del reloj (⏰) aparece en la columna de alertas (⚠️) cuando el script detecta que los rangos de horas de un mismo día se superponen.

Ejemplo: Un lugar con horario "Lunes 09:00-14:00" y también "Lunes 13:00-18:00" activará esta alerta, ya que el horario entre las 13:00 y las 14:00 está duplicado.

Acción: Te recomienda revisar y corregir los horarios de apertura del lugar en el panel de edición de Waze para asegurar que sean correctos y no confusos.

---

Alerta de Ediciones Pendientes (📨)

Este ícono te informa que otro editor ya ha propuesto cambios para este lugar, los cuales están esperando aprobación.

Qué significa: El ícono naranja del lápiz (📨) aparece en la columna de alertas (⚠️) para indicar que el lugar tiene una Edición Pendiente (también conocida como Place Update Request o PUR).

Acción: Antes de realizar tus propios cambios, es recomendable revisar la edición pendiente para evitar duplicar el trabajo o generar conflictos. Puedes ver las ediciones pendientes en la pestaña de "Sugerencias" del panel lateral de WME.

---

Gestión de Datos y Exportación

• XML: Exporta/Importa Palabras Especiales, Reemplazos, Swap, Estadísticas y Lugares Procesados.
• Las estadísticas se guardan como totales por período para mantener archivos pequeños.

---

Cómo usarlo

1. Instalar Tampermonkey y el script.
   
2. Abrir WME con un zoom adecuado.
   
3. Configurar en Gene: máximo de lugares, recomendaciones, filtros y panel de estadísticas.
   
4. Gestionar en Espe tus Palabras Especiales y Lugares Excluidos.
   
5. Escanear con Start Scan…. Los controles se bloquean durante el análisis.
   
6. Revisar en el panel: edita nombres, aplica sugerencias, cambia categorías, asigna ciudad si falta, y excluye lugares por ID si corresponde.
7. (Nivel 4+) Activar visualizador de zonas escolares para identificar instituciones sin zona escolar.
8. Guardar con el botón principal de WME para confirmar cambios.