Países, estados, ciudades

Cada dirección en GCM — dirección particular del miembro, ubicación de reunión del grupo, lugar del ministerio, campus escolar — se elige de tres menús desplegables en cascada: País → Estado / Provincia → Ciudad. Los valores provienen de tres tablas de referencia (countries, states, cities) y las listas son gestionadas por la plataforma, así que verás las mismas opciones ya seas una plantación de 50 miembros en Belice o una red de 5.000 miembros en Brasil.

Este artículo recorre dónde aparecen, cómo funciona la cascada, qué está precargado y qué hacen los administradores de la plataforma detrás de escena.

Dónde aparece la geografía

Los menús desplegables de país / estado / ciudad aparecen en:

• Perfil del miembro — campos de dirección particular.
• Perfil de grupo / ministerio — lugar de reunión.
• Campus escolar — ubicación física.
• Formulario de visitante — campo público "¿de dónde eres?".
• Configuración de la organización — la dirección de la propia iglesia.
• Módulo de mapas — las direcciones se geocodifican y se marcan, luego se agrupan por ciudad / estado.

Cada tabla guarda el nombre legible por humanos más un código ISO para que la función edge de geocodificación y las analíticas posteriores hablen en un estándar.

La cascada

Las tres tablas están vinculadas por claves foráneas:

countries  ← states (country_id)  ← cities (state_id, country_id)

En la interfaz, elegir un país reduce el menú desplegable de estado a los estados de ese país, y elegir un estado reduce el menú desplegable de ciudad. Elige Jamaica y el menú desplegable de estado muestra las 14 parroquias; elige Saint Andrew y el menú desplegable de ciudad muestra Kingston, Half Way Tree, etc.

Si tu país usa provincias en lugar de estados o departamentos en lugar de provincias, la columna para ese nivel es la misma — la tabla de referencia de la plataforma almacena admin_level_label por país para que la interfaz pueda mostrar "Provincia" en Canadá y "Estado" en los Estados Unidos sin un cambio de código.

Por qué está gestionado por la plataforma

Tres razones:

1. Consistencia de geocodificación. El módulo de mapas de GCM llama a un servicio de geocodificación (Nominatim por defecto, opcionalmente Google o Mapbox). El servicio espera nombres canónicos de país y estado — si la iglesia A escribe Saint Andrew y la iglesia B escribe St Andrew, el geocodificador devuelve dos lat/lons diferentes y el mapa se ve roto.
2. Estadísticas entre inquilinos. Las analíticas de la plataforma consolidan los conteos de miembros por país y estado. El texto libre haría que esos totales no tuvieran sentido.
3. i18n. Cada país tiene traducciones a inglés, español, portugués, francés — ser dueño de la lista permite a la plataforma mantener limpias esas traducciones.

No verás países / estados / ciudades en la página de Datos de Referencia a nivel de organización. Viven detrás de Administrador de la Plataforma → Geografía, accesible solo por el personal de GCM.

Qué está precargado

En el momento de la siembra, la plataforma carga:

• Cada país — los 195 países más territorios dependientes, con códigos ISO 3166-1 alfa-2, códigos de marcación y emojis de bandera.
• Estados / provincias / regiones — para cada país, las divisiones administrativas de nivel superior.
• Ciudades — una lista inicial de las 30-50 ciudades más grandes por país.

Si a tu menú desplegable de dirección le falta una ciudad — particularmente común para ciudades pequeñas o áreas recientemente incorporadas — el camino es solicitar una adición vía soporte, o que un administrador de la plataforma la agregue directamente a través de la pestaña de geografía (ver Agregar estados o ciudades abajo).

Agregar estados o ciudades

Esto es trabajo de administrador de la plataforma, pero vale la pena saber cómo sucede para que puedas solicitar adiciones eficientemente.

El administrador de la plataforma abre Administrador de la Plataforma → Geografía y ve una cascada de tres paneles: Países a la izquierda, Estados en el medio, Ciudades a la derecha. Al hacer clic en un país, se cargan sus estados; al hacer clic en un estado, se cargan sus ciudades.

Para una o dos adiciones, hace clic en el botón + junto al encabezado del panel, completa el nombre (y el código ISO para estados), guarda.

Importación masiva por CSV

Para un país nuevo lanzando una lista grande — digamos, los 50 estados de EE.UU. o 200 municipios brasileños — hay una importación masiva por CSV.

1. Selecciona el país (para estados) o el estado (para ciudades) a la izquierda.
2. Haz clic en Cargar en el encabezado del panel.
3. Pega líneas en el área de texto de importación, una por línea:
   • Estados: name,iso_code (el código ISO por defecto es las primeras 3 letras del nombre si se omite)
   • Ciudades: name
4. Las líneas que comienzan con # se ignoran. Las líneas en blanco se ignoran.
5. Haz clic en Importar.

Detrás de escena hace un solo INSERT ida y vuelta; el índice único de la tabla significa que reimportar la misma lista es una operación nula para filas que ya existen. Una importación típica de 50 estados de EE.UU. es de menos de un segundo.

Ejemplo de importación de estados para los Estados Unidos:

# US states — full list
Alabama,AL
Alaska,AK
Arizona,AZ
# ...

Cómo el administrador de la organización debe manejar una ciudad faltante

No tienes acceso de edición, pero aquí está el flujo de trabajo:

1. El miembro agrega la ciudad como un texto libre. El perfil del miembro tiene un campo de respaldo "Ciudad (texto libre)" que se usa cuando el menú desplegable no la cubre. El geocodificador aún funciona porque recurre a la ciudad de texto libre.
2. Envías un correo a soporte con el país, estado y nombre de la ciudad a agregar.
3. El personal de la plataforma la agrega en unos pocos días hábiles, el menú desplegable la recoge automáticamente, y la próxima vez que se edite el miembro su registro puede moverse del respaldo de texto libre a la ciudad canónica.

La lat/lon geocodificada del miembro sobrevive al movimiento porque se almacena directamente en la fila del miembro, no en la ciudad.

Campos de país más allá del nombre

Cada fila de país tiene más que solo un nombre:

Columna	Ejemplo	Usado para
iso_code	JM	Geocodificación, validación de teléfono, integraciones
iso_numeric	388	Banca, enrutamiento BIC
dial_code	+1	Prefijo automático de campo de teléfono en el formulario de visitante
flag_emoji	JM	Decoración visual en menús desplegables
admin_level_label	Parish	Cómo llamar a la división de segundo nivel en la interfaz

Verás el emoji de bandera en el menú desplegable de país y el código de marcación precargado en las entradas de teléfono — ahí es donde estos campos adicionales aparecen al usuario final.

Traducciones

Los países, estados y ciudades todos soportan la columna translations JSONB. La plataforma precarga inglés; las traducciones al español y portugués se cargan para los 30+ países más grandes. Si una traducción falta, la interfaz recurre al nombre en inglés. Consulta Etiquetas multilingües.

Siguiente

• Etiquetas multilingües — cómo se renderizan los nombres de país / estado / ciudad por configuración regional.
• Personalizar tipos de miembro — de vuelta a las listas que controlas completamente.