AX - Carte (Map)
Aperçu
AX - Carte est un composant Experience Cloud qui affiche des enregistrements Salesforce sous forme de marqueurs d'emplacement interactifs sur une carte des pages Experience Sites.
Utilisez-le pour montrer aux utilisateurs du portail des emplacements basés sur des champs d'adresse ou des coordonnées latitude/longitude — comme des points de service à proximité, des sites clients, les résultats d'un localisateur de magasins ou des lieux d'événements. Les utilisateurs peuvent cliquer sur les marqueurs pour voir les détails des enregistrements et accéder aux enregistrements. Récupérez les données de localisation depuis n'importe quel objet standard ou personnalisé dans Experience Builder.
Parfait pour les localisateurs de magasins, les cartes de territoires de service, les outils de localisation d'événements, les vues de proximité des clients, ou partout où les utilisateurs du portail ont besoin de visualiser des données géographiques.
La carte Avonni est un Composant de données réactif
🎥 Tutoriels
Apprenez à afficher des enregistrements sur Experience Cloud en utilisant Avonni Map.
Configuration de la carte
Comprendre le processus de configuration, en particulier les sections Source de données et Mappages de données, est crucial pour utiliser efficacement ce composant.
Configuration de la source de données
La section Source de données est l'endroit où vous connectez Avonni Map à vos données Salesforce. Vous avez deux options.

Source de données manuelle
Saisir manuellement des données dans le tableau de données.
Idéal pour les données non dynamiques, les tests et les démonstrations.
Requête
Créez une requête pour remplir automatiquement le tableau avec des données Salesforce.
Adapté aux jeux de données dynamiques, en temps réel et volumineux.
Configuration des mappings de données
Dans la section Mappages de données, vous pouvez activer votre composant Carte en spécifiant comment les champs doivent être mappés. Cela implique d'aligner des champs comme les coordonnées de localisation issus de votre configuration Source de données avec les attributs pertinents de la carte.
Vous devez vous concentrer sur la section Emplacement pour vous assurer que vos Mappages de données sont correctement configurés, en particulier pour le mappage des emplacements. Voici pourquoi :
Configuration des mappages de données: Pour garantir que le composant Carte affiche les informations correctes, vous devez mapper les champs de données Salesforce à leurs étiquettes d'emplacement correspondantes. Par exemple, vous mapperez un champ Salesforce contenant des adresses de rue à l'étiquette « street » du composant Carte, les noms de villes à l'étiquette « city », et ainsi de suite.
Importance de la précision: Des mappages précis sont essentiels. Le composant Carte pourrait afficher des informations incorrectes si le mauvais champ Salesforce est mappé à une étiquette d'emplacement. Par exemple, si le champ « city » est mappé à tort à l'étiquette « postal code », la carte pourrait afficher un emplacement dans une ville complètement différente voire dans un autre pays.

Filtres
L'attribut Filtres vous permet de choisir des champs spécifiques pouvant être utilisés pour filtrer et affiner les marqueurs affichés sur le composant carte.

Autres paramètres
Vue liste
Cette fonction affiche ou masque la liste des emplacements. Les valeurs valides sont visible, hidden ou auto. Cette valeur par défaut est auto, qui affiche la liste uniquement lorsque plusieurs marqueurs sont présents.
Niveau de zoom
Dans le composant carte, vous pouvez ajuster le niveau de zoom pour vous concentrer sur différentes zones, du monde entier aux bâtiments individuels. Si vous ne définissez pas de niveau de zoom, la carte s'ajustera automatiquement pour afficher tous les marqueurs que vous y avez placés.

Le panneau Propriétés propose une option pour définir le zoom manuellement. Les niveaux de zoom vont de 1 à 22 sur les navigateurs de bureau et de 1 à 20 sur les appareils mobiles.
Voici un guide rapide de ce que chaque niveau de zoom montre généralement :
Niveau 1 : Le monde entier
Niveau 5 : Un continent ou une grande masse terrestre
Niveau 10 : Une ville
Niveau 15 : Détails au niveau de la rue
Niveau 20 : Bâtiments individuels
Reportez-vous à la documentation de l'API Google Maps sur Niveaux de zoom pour des informations plus approfondies.
Comportement de l'UI du composant Carte

Ces paramètres vous permettent de contrôler comment les utilisateurs interagissent avec la carte, offrant une expérience utilisateur plus rationnelle et ciblée. De la désactivation de fonctions spécifiques de zoom et de glissement à l'ajout de fonctionnalités utiles comme une barre de recherche ou un pied de page, chaque paramètre a un objectif distinct :
Désactiver le glissement
Empêche le déplacement de la carte par clic-et-glisser, la maintenant dans une position fixe.
Masquer les contrôles de zoom
Supprime les contrôles de zoom avant/arrière, maintenant un niveau de zoom cohérent sur la carte.
Désactiver le zoom à la molette
Empêche la carte de zoomer avec la molette de la souris, assurant un niveau de zoom stable.
Désactiver le double-clic pour zoom
Désactive le zoom par double-clic sur la carte, maintenant un niveau de zoom fixe.
Désactiver l'UI par défaut
Supprime les éléments d'interface standard de la carte comme le basculement Street View, offrant un affichage de carte plus épuré.
Afficher le pied de page
Affiche un pied de page sur la carte pour des informations supplémentaires telles que les sources de données de la carte ou une légende.
Consultable
Ajoute une barre de recherche à la carte, permettant aux utilisateurs de trouver et de zoomer facilement sur des emplacements ou des points spécifiques.
Emplacement central de la carte
Lors de l'utilisation de plusieurs marqueurs sur la carte, celle-ci se centrera automatiquement sur un point central proche du milieu de tous les marqueurs. Elle calcule ce point en fonction de leurs emplacements.

Interactions
Pour le composant Carte, il propose une interaction "on Select". Cette fonction vous permet de spécifier quelle action doit se produire lorsque les utilisateurs cliquent sur un marqueur de la carte.

Affiche une brève notification pop-up à l'écran, fournissant un retour ou une information rapide après le clic sur un marqueur de carte.
Redirige l'utilisateur vers une autre page de votre site ou une URL, le guidant vers des informations plus détaillées sur l'élément cliqué.
Ouvre une fenêtre modale avec un message d'alerte, présentant des informations importantes ou des avertissements concernant l'élément sélectionné.
Déclenche une boîte de dialogue de confirmation, utilisée pour des actions nécessitant une confirmation supplémentaire de l'utilisateur, comme la participation à un événement.
Ouvre une boîte de dialogue qui exécute un Flow Salesforce, initiant des workflows ou des processus liés à l'élément cliqué.
Paramètres
Titre de la liste
Définissez un titre pour votre liste de cartes.
Vue liste
Cette fonctionnalité est particulièrement utile pour que les utilisateurs voient une liste détaillée des lieux ou des éléments présents sur la carte.
Auto: Détermine automatiquement la meilleure vue.
Visible: Garde la vue liste toujours visible.
Hidden: Masque la vue liste.
Niveau de zoom
Les niveaux de zoom vont de 1 à 22 sur les navigateurs de bureau et de 1 à 20 sur les appareils mobiles.
Voici un guide rapide de ce que chaque niveau de zoom montre généralement :
Niveau 1 : Le monde entier
Niveau 5 : Un continent ou une grande masse terrestre
Niveau 10 : Une ville
Niveau 15 : Détails au niveau de la rue
Niveau 20 : Bâtiments individuels
Désactiver le glissement
Empêcher les utilisateurs de faire glisser la vue de la carte.
Masquer les contrôles de zoom
Supprimer les contrôles de zoom avant/arrière de la carte
Désactiver le zoom à la molette
Désactiver le zoom avec la molette de la souris
Désactiver le double-clic
Empêcher le double-clic de zoomer sur la carte
Désactiver l'UI par défaut
Supprimer l'interface standard de Google Maps pour un aspect plus épuré
Afficher le pied de page
Ajouter une section de pied de page au composant carte
Consultable
Activer une fonction de recherche dans la carte
Source de données
Manuel: Ajouter des marqueurs de carte manuellement.
Requête: Utiliser les données Salesforce avec mappage des données pour le placement automatique des marqueurs
Emplacement central de la carte
Spécifiez le point central initial de la carte
Options de filtrage
Configurer des filtres pour la carte, affichés sous forme de popover
Options du moteur de recherche
Espace réservé: Texte affiché dans la barre de recherche avant la saisie.
Position: Choisissez parmi left, right, center ou fill pour la position de la barre de recherche
Taille
Largeur et hauteur: Spécifiez les dimensions du composant carte.
"Débordement" fait référence à la manière dont le contenu qui dépasse les limites de son conteneur est géré ou affiché. Lorsque le contenu à l'intérieur d'un composant de mise en page est trop grand pour tenir dans les dimensions attribuées (hauteur et largeur), le paramètre de débordement détermine ce qui arrive au contenu excédentaire.
Débordement: Contrôler la façon dont le contenu débordant est géré.
Mis à jour
Ce contenu vous a-t-il été utile ?

