WME Places Name Normalizer

Normaliza nombres de lugares y gestiona categorías dinámicamente en WME.

当前为 2025-07-03 提交的版本,查看 最新版本

作者
Mauricio Otálvaro Ospina
评分
0 0 0
版本
7.0.0
创建于
2025-03-19
更新于
2025-07-03
大小
272.3 KB
许可证
MIT
适用于

# 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 formato y sugerencias personalizadas desde un panel flotante.

---

## Funcionalidades Clave

* **Normalización Inteligente:** Sugiere nombres corregidos según reglas de estilo, ortografía y listas configurables.
* **Eliminación de Emoticones:** Elimina automáticamente emoticones de los nombres de los lugares, ya que Waze no los soportará continuamente.
* **Gestión de Datos:** Permite añadir y gestionar palabras especiales, diccionarios y reglas de reemplazo.
* **Recomendaciones de Categoría Dinámicas:** Ofrece sugerencias de categoría para los lugares, cargadas desde una hoja de Google Sheets.
* **Interfaz Flotante:** Facilita la revisión, aplicación de cambios o eliminación de lugares.

---

## Pestañas del Script

### `Gene` (General)
Pestaña principal para configuración general y escaneo. Define el número máximo de lugares a revisar y el botón `Start Scan...` para iniciar el análisis. Dispone de un checkbox para "Recomendar categorías".

### `Espe` (Especiales)
Lista de palabras o frases que no deben modificarse por la normalización (ej. marcas). Permite edición manual, importación y exportación XML.

### `Dicc` (Diccionario)
Diccionario de palabras válidas en español. Mejora sugerencias y ayuda a evitar falsos positivos. **Se carga automáticamente desde una hoja de Google Sheets (`Dictionary!A2:B`). Ya no es necesario importar el diccionario mediante un archivo XML**, aunque puedes añadir, editar o eliminar palabras manualmente para modificaciones locales.

### `Reemp` (Reemplazos)
Contiene un menú desplegable con dos herramientas:

#### 1. Reemplazo de palabras
Define reglas automáticas para sustituir abreviaturas por su versión completa (ej. `Av.` por `Avenida`). Se aplican por palabra completa.

#### 2. Palabras al principio (`Swap`)
Lista de palabras que se moverán automáticamente al **inicio** del nombre sugerido si se encuentran en otra posición (ej. `Torres del Sol Urbanización` → `Urbanización Torres del Sol`).
* 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).
* El movimiento ocurre después de la normalización.

---

## Panel de Resultados

Al finalizar el escaneo, un panel flotante muestra los lugares detectados.

* **Categoría:** Muestra el nombre de la categoría actual del lugar y su ícono debajo.
```
Cuidado personal
💅💇🦷
```
* **Categoría
Recomendada:** Aparece solo si el script encuentra al menos una categoría **diferente** a la actual para recomendar. Lista las sugerencias en líneas separadas, con su ícono y descripción. Los íconos de sugerencia tienen un **borde negro** para indicar que son clickeables.
```
👨‍⚕️ Consultorio médico
```
Al hacer clic en un ícono de sugerencia, la categoría se aplica al lugar y las demás sugerencias para ese lugar se deshabilitan.

---

## Gestión y Actualización de Categorías y Diccionario

Las reglas de categoría (`Categories!A2:E`) y las palabras del diccionario (`Dictionary!A2:B`) se cargan dinámicamente desde hojas de cálculo de Google Sheets.

* **Actualización:** El script intentará cargar las reglas y palabras desde Google Sheets cada vez que se inicia WME. No es necesario realizar una acción manual para "actualizar" las listas desde la fuente externa, ya que el script lo hace automáticamente. Los cambios que hagas en Google Sheets se reflejarán la próxima vez que cargues el editor de Waze.
* **Configuración:** Las hojas de Google Sheets están vinculadas mediante un `SPREADSHEET_ID` y `API_KEY` configurados en el código del script. Si estos valores no son válidos, el script emitirá una advertencia y omitirá la carga desde Google Sheets.

---

## Cómo usarlo

1. **Instalar:** Usa Tampermonkey o Greasemonkey.
2. **Acceder:** Busca la pestaña `NrmliZer` en Waze Map Editor.
3. **Configurar Recomendación de Categorías:** En la pestaña `Gene`, asegúrate de que el checkbox "Recomendar categorías" esté marcado si deseas ver las sugerencias. Si lo desmarcas, no se mostrarán las categorías recomendadas.
4. **Preparar Mapa:** Asegura un zoom de **100 a 200 metros** para que los lugares sean detectados.
5. **Escanear:** En `Gene`, ajusta "Máximo de places a revisar" y haz clic en `Start Scan...`. Espera a que el proceso finalice.
6. **Revisar Resultados:** Utiliza el panel flotante para ver y gestionar los lugares.
* **Eliminación de Emoticones:** El script eliminará automáticamente cualquier emoticón presente en los nombres de los lugares.
* Puedes editar nombres, aplicar sugerencias, eliminar lugares, añadir palabras a la lista de especiales.
* **Cambiar Categoría con Propuestas:** En la columna "Categoría Recomendada", haz clic en el ícono de la categoría sugerida (con borde negro) para aplicarla al lugar. Las demás sugerencias para ese lugar se deshabilitarán automáticamente.
* **Eliminar Propuestas/Desactivar Recomendaciones:** Si no deseas ver las recomendaciones de categoría, desmarca el checkbox "Recomendar categorías" en la pestaña `Gene`.

7. **Guardar:** Usa el botón de guardar de WME para aplicar los cambios.

---

## Recursos

* XML de ejemplo para palabras especiales y reglas de reemplazo: