Pays, états, villes

Chaque adresse dans GCM — adresse personnelle d'un membre, lieu de réunion d'un groupe, lieu d'un ministère, campus d'une école — sélectionne dans trois listes déroulantes en cascade : Pays → État / Province → Ville. Les valeurs proviennent de trois tables de référence (countries, states, cities) et les listes sont gérées par la plateforme, donc vous verrez les mêmes options que vous soyez une plantation de 50 membres au Belize ou un réseau de 5 000 membres au Brésil.

Cet article parcourt où elles apparaissent, comment la cascade fonctionne, ce qui est préchargé, et ce que font les administrateurs de plateforme en coulisses.

Où la géographie fait surface

Les listes déroulantes pays / état / ville apparaissent dans :

• Profil du membre — champs d'adresse personnelle.
• Profil de groupe / ministère — lieu de réunion.
• Campus d'école — emplacement physique.
• Formulaire visiteur — champ public « d'où venez-vous ? ».
• Paramètres de l'organisation — l'adresse de l'église elle-même.
• Module carte — les adresses sont géocodées et épinglées, puis regroupées par ville / état.

Chaque table contient le nom lisible par l'humain plus un code ISO pour que la edge function de géocodage et les analyses en aval parlent en standard.

La cascade

Les trois tables sont liées par des clés étrangères :

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

Dans l'interface, choisir un pays restreint la liste déroulante des états aux états de ce pays, et choisir un état restreint la liste déroulante des villes. Choisissez Jamaïque et la liste déroulante des états affiche les 14 paroisses ; choisissez Saint Andrew et la liste déroulante des villes affiche Kingston, Half Way Tree, etc.

Si votre pays utilise provinces au lieu d'états ou départements au lieu de provinces, la colonne pour ce niveau est la même — la table de référence de la plateforme stocke admin_level_label par pays pour que l'interface puisse afficher « Province » au Canada et « État » aux États-Unis sans changement de code.

Pourquoi c'est géré par la plateforme

Trois raisons :

1. Cohérence du géocodage. Le module carte de GCM appelle un service de géocodage (Nominatim par défaut, optionnellement Google ou Mapbox). Le service attend des noms canoniques de pays et d'états — si l'église A épelle Saint Andrew et l'église B épelle St Andrew, le géocodeur renvoie deux lat/lon différents et la carte a l'air cassée.
2. Statistiques inter-locataires. Les analyses de la plateforme roulent les décomptes de membres par pays et état. Le texte libre rendrait ces totaux dénués de sens.
3. i18n. Chaque pays a des traductions en anglais, espagnol, portugais, français — posséder la liste permet à la plateforme de garder ces traductions propres.

Vous ne verrez pas pays / états / villes sur la page Données de référence au niveau de l'organisation. Ils vivent derrière Admin de plateforme → Géographie, accessible uniquement par le personnel de GCM.

Ce qui est préchargé

Au moment de l'amorçage, la plateforme charge :

• Chaque pays — les 195 pays plus les territoires dépendants, avec les codes ISO 3166-1 alpha-2, les codes d'appel et les emojis de drapeau.
• États / provinces / régions — pour chaque pays, les divisions administratives de premier niveau.
• Villes — une liste de démarrage des 30-50 plus grandes villes par pays.

Si votre liste déroulante d'adresse manque une ville — particulièrement courant pour les petites villes ou les zones récemment constituées en municipalité — le chemin est de demander un ajout via le support, ou de faire ajouter directement par un administrateur de plateforme via l'onglet géographie (voir Ajouter des états ou villes ci-dessous).

Ajouter des états ou villes

C'est du travail d'administrateur de plateforme mais cela vaut la peine de savoir comment cela se passe pour pouvoir demander des ajouts efficacement.

L'administrateur de plateforme ouvre Admin de plateforme → Géographie et voit une cascade à trois panneaux : Pays à gauche, États au milieu, Villes à droite. Cliquer sur un pays charge ses états ; cliquer sur un état charge ses villes.

Pour un ou deux ajouts, il clique sur le bouton + à côté de l'en-tête du panneau, remplit le nom (et le code ISO pour les états), enregistre.

Importation CSV en masse

Pour un nouveau pays qui déploie une grande liste — disons, les 50 états américains ou 200 municipalités brésiliennes — il existe une importation CSV en masse.

1. Sélectionnez le pays (pour les états) ou l'état (pour les villes) à gauche.
2. Cliquez sur Téléverser sur l'en-tête du panneau.
3. Collez des lignes dans la zone de texte d'importation, une par ligne :
   • États : name,iso_code (le code ISO par défaut est les 3 premières lettres du nom s'il est omis)
   • Villes : name
4. Les lignes commençant par # sont ignorées. Les lignes vides sont ignorées.
5. Cliquez sur Importer.

En coulisses, cela fait un seul aller-retour INSERT ; l'index unique de la table signifie que réimporter la même liste est sans effet pour les lignes qui existent déjà. Une importation typique de 50 états américains prend moins d'une seconde.

Exemple d'importation d'états pour les États-Unis :

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

Comment l'administrateur d'organisation devrait gérer une ville manquante

Vous n'avez pas accès en édition, mais voici le workflow :

1. Le membre ajoute la ville comme remplacement en texte libre. Le profil du membre a un champ de secours « Ville (texte libre) » qui est utilisé quand la liste déroulante ne couvre pas. Le géocodeur fonctionne toujours parce qu'il bascule sur la ville en texte libre.
2. Vous envoyez un e-mail au support avec le pays, l'état et le nom de la ville à ajouter.
3. Le personnel de la plateforme l'ajoute en quelques jours ouvrables, la liste déroulante le récupère automatiquement, et la prochaine fois que le membre est édité, son enregistrement peut être déplacé du remplacement en texte libre vers la ville canonique.

Les lat/lon géocodés du membre survivent au déplacement parce qu'ils sont stockés directement sur la ligne du membre, pas sur la ville.

Champs de pays au-delà du nom

Chaque ligne de pays a plus qu'un simple nom :

Colonne	Exemple	Utilisé pour
iso_code	JM	Géocodage, validation de téléphone, intégrations
iso_numeric	388	Banque, routage BIC
dial_code	+1	Préfixe automatique du champ téléphone dans le formulaire visiteur
flag_emoji	🇯🇲	Décoration visuelle dans les listes déroulantes
admin_level_label	Parish	Comment appeler la division de second niveau dans l'interface

Vous verrez l'emoji de drapeau dans la liste déroulante des pays et le code d'appel pré-rempli sur les entrées de téléphone — c'est là que ces champs supplémentaires apparaissent à l'utilisateur final.

Traductions

Les pays, états et villes supportent tous la colonne translations JSONB. La plateforme pré-remplit l'anglais ; les traductions espagnoles et portugaises sont chargées pour les 30+ plus grands pays. Si une traduction manque, l'interface bascule sur le nom anglais. Voir Étiquettes multilingues.

Suivant

• Étiquettes multilingues — comment les noms de pays / état / ville sont rendus par locale.
• Personnaliser les types de membres — retour aux listes que vous possédez pleinement.