# WME Places Name Normalizer — Manual de Usuario
Este script permite revisar y normalizar nombres de lugares en Waze Map Editor (WME), aplicando reglas ortográficas, de formato y personalizadas. Ayuda a detectar inconsistencias, sugerir mejoras y aplicar cambios de forma eficiente desde un panel flotante.
---
## ¿Qué hace este script?
- Sugiere nombres corregidos con base en reglas de estilo, ortografía y listas configurables.
- Identifica diferencias entre el nombre actual y el nombre sugerido.
- Permite aplicar correcciones o eliminar lugares desde una interfaz flotante.
- Integra validaciones con diccionario, palabras especiales y reglas de reemplazo.
---
## Pestañas del script
### Gene
Pestaña principal para configuración general y escaneo. Incluye el campo para definir el número máximo de lugares a revisar y el botón “Start Scan...” para iniciar el análisis.
### Espe
Lista de palabras o frases que no deben modificarse por la normalización. Son útiles para conservar nombres específicos o marcas que el sistema no debe tocar. La lista puede editarse manualmente e importarse/exportarse en XML.
### Dicc
Diccionario de palabras válidas en español. Mejora las sugerencias del sistema, valida palabras con tildes correctas y ayuda a evitar falsos positivos. El diccionario también se puede importar en formato XML.
### Reemp
Esta pestaña contiene un **menú desplegable (dropdown)** con dos herramientas configurables:
#### 1. Reemplazo de palabras
Permite definir reglas automáticas para sustituir abreviaturas o formas parciales por su versión completa, antes de construir el "Nombre Sugerido".
Estas reglas se aplican por palabra completa (no por fragmentos) y ayudan a estandarizar nombres de forma consistente.
**Ejemplos comunes:**
| Texto original | Reemplazo |
|----------------|---------------------|
| Av. | Avenida |
| Cl. | Calle |
| C.C. | Centro Comercial |
| Cra | Carrera |
| B/ | Barrio |
Puedes gestionar estas reglas manualmente e importarlas/exportarlas en formato XML compartido con la pestaña Espe.
#### 2. Palabras al principio (Swap)
Permite definir una lista de palabras que deben ser movidas automáticamente al **inicio** del nombre sugerido, si se encuentran en otra posición. Esta función es útil para estandarizar nombres donde cierto descriptor debe encabezar el texto.
**Ejemplos prácticos:**
| Nombre original | Nombre sugerido |
|---------------------------------|--------------------------------|
| Torres del Sol Urbanización | Urbanización Torres del Sol |
| San Pedro Ferretería | Ferretería San Pedro |
| Mirador 45 Apartamentos | Apartamentos Mirador 45 |
**Reglas aplicadas:**
- Solo se mueve una palabra por nombre.
- La palabra se antepone solo si no está ya al inicio.
- Se conserva su forma exacta (mayúsculas, tildes, etc.).
- El movimiento se realiza después de la normalización y los reemplazos.
- No se duplican términos ni se modifica el resto del texto.
Esta lista también es configurable desde la interfaz del script y se guarda localmente.
---
## Cómo usarlo
1. **Instalación**
Instala el script usando Tampermonkey o Greasemonkey.
2. **Acceso**
Abre Waze Map Editor y busca la pestaña "NrmliZer" en la barra lateral izquierda.
3. **Preparación del mapa**
Antes de escanear, asegúrate de que el nivel de zoom permita visualizar los lugares.
Se recomienda trabajar con la escala visible entre **100 y 200 metros**, para asegurar que todos los lugares sean detectados por el script.
4. **Inicio del escaneo**
En la pestaña Gene, ajusta el valor de "Máximo de places a revisar" y haz clic en "Start Scan...".
**Importante:**
Mientras esté activa la flecha circular girando (indicador de proceso en curso), no debes iniciar un nuevo escaneo. Espera a que el proceso finalice completamente.
5. **Revisión de resultados**
Al finalizar el análisis, se abrirá un panel flotante con los lugares detectados.
Para cada lugar, se mostrará el nombre original, el sugerido, la categoría, el editor y otra información adicional.
Puedes:
- Editar el nombre sugerido manualmente.
- Aplicar la sugerencia con el botón de confirmación.
- Eliminar el lugar si no corresponde.
- Añadir palabras nuevas a la lista de especiales directamente desde la fila.
6. **Guardado final**
Cuando termines la revisión, utiliza el botón de guardar de WME para registrar los cambios aplicados.
---
## Recursos
- XML de ejemplo para palabras especiales y reglas de reemplazo:
https://www.simplificatecpro.com/Waze_Scripts/excluded_words.xml
- Diccionario de palabras correctas en español:
https://www.simplificatecpro.com/Waze_Scripts/dictionary_words_sp.xml