AX - Mapa
Resumen
AX - Mapa es un componente de Experience Cloud que muestra registros de Salesforce como marcadores de ubicación interactivos en las páginas de Experience Sites.
Úsalo para mostrar a los usuarios del portal ubicaciones basadas en campos de dirección o coordenadas de latitud/longitud, como ubicaciones de servicio cercanas, sitios de clientes, resultados del localizador de tiendas o sedes de eventos. Los usuarios pueden hacer clic en los marcadores para ver los detalles del registro y navegar a los registros. Obtén datos de ubicación de cualquier objeto estándar o personalizado en Experience Builder.
Perfecto para localizadores de tiendas, mapas de territorios de servicio, buscadores de ubicaciones de eventos, vistas de proximidad de clientes o cualquier lugar donde los usuarios del portal necesiten visualizar datos geográficos.
El Avonni Map es un Componente de datos reactivo
Primeros pasos
Usa este sencillo tutorial para aprender lo básico del componente Mapa y empezar a crear tus casos de uso.
Tutoriales
Aprende a mostrar registros en Experience Cloud usando Avonni Map.
Configuración del mapa
Comprender el proceso de configuración, especialmente las secciones Fuente de datos y Asignaciones de datos, es crucial para usar este componente de manera eficaz.
Configuración de la fuente de datos
La sección Fuente de datos es donde conectas el Avonni Map con tus datos de Salesforce. Tienes dos opciones.

Origen de datos manual
Introduce manualmente los datos en la tabla de datos.
Ideal para datos no dinámicos, pruebas y demostraciones.
Consulta
Crea una consulta para rellenar automáticamente la tabla con datos de Salesforce.
Adecuado para conjuntos de datos dinámicos, en tiempo real y de gran tamaño.
Configuración de asignaciones de datos
En la sección Asignaciones de datos, puedes activar tu componente Mapa especificando cómo deben asignarse los campos. Esto implica alinear campos, como las coordenadas de ubicación de tu configuración de Fuente de datos, con los atributos relevantes del mapa.
Compartición del modelo de datos con Avonni Map
Cumplimiento de las reglas de compartición de datos de Salesforce:
Respeto por la configuración de la organización: Los componentes de Avonni cumplen totalmente con las configuraciones de compartición de datos y los ajustes de acceso existentes de tu organización de Salesforce.
Política de no interferencia: Estos componentes no modifican ni afectan de ninguna manera tus reglas de compartición de datos preestablecidas.
Visibilidad y acceso controlados: La capacidad de ver e interactuar con los registros a través de los componentes de Avonni está regida por la configuración de compartición y los permisos de usuario definidos por tu organización
Debes centrarte en la sección Ubicación para asegurarte de que tus Asignaciones de datos estén configuradas correctamente, especialmente al asignar ubicaciones. He aquí por qué:
Configuración de las asignaciones de datos: Para asegurarte de que el componente Mapa muestre la información correcta, debes asignar los campos de datos de Salesforce a sus etiquetas de ubicación correspondientes. Por ejemplo, asignarás un campo de Salesforce que contenga direcciones de calle a la etiqueta 'street' en el componente Mapa, nombres de ciudad a la etiqueta 'city', y así sucesivamente.
Importancia de la precisión: Las asignaciones precisas son vitales. El componente Mapa podría mostrar información incorrecta si el campo de Salesforce equivocado se asigna a una etiqueta de ubicación. Por ejemplo, si el campo 'city' se asigna incorrectamente a la etiqueta 'postal code', el mapa podría mostrar una ubicación en una ciudad completamente diferente o incluso en un país distinto.

Filtros
El atributo Filtros te permite elegir campos específicos para filtrar y refinar los marcadores mostrados en el componente de mapa.

Otros ajustes
Vista de lista
Esta función muestra u oculta la lista de ubicaciones. Los valores válidos son visible, oculto o auto. Este valor predeterminado es auto, que muestra la lista solo cuando hay varios marcadores presentes.
Nivel de zoom
En el componente de mapa, puedes ajustar el nivel de zoom para centrarte en diferentes áreas, desde el mundo hasta edificios individuales. Si no estableces un nivel de zoom, el mapa se ajustará automáticamente para mostrar todos los marcadores que hayas colocado en él.

El panel Propiedades tiene una opción para establecer el zoom manualmente. Los niveles de zoom van de 1 a 22 en navegadores de escritorio y de 1 a 20 en dispositivos móviles.
Aquí tienes una guía rápida de lo que generalmente muestra cada nivel de zoom:
Nivel 1: El mundo entero
Nivel 5: Un continente o una gran masa terrestre
Nivel 10: Una ciudad
Nivel 15: Detalles a nivel de calle
Nivel 20: Edificios individuales
Consulta la documentación de la API de Google Maps sobre Niveles de zoom para obtener información más detallada.
Comportamiento de la interfaz del componente Mapa

Estos ajustes te permiten controlar cómo interactúan los usuarios con el mapa, proporcionando una experiencia de usuario más ágil y centrada. Desde desactivar funciones específicas de zoom y arrastre hasta añadir funciones valiosas como una barra de búsqueda o un pie de página, cada ajuste tiene un propósito distinto:
Desactivar arrastre
Evita mover el mapa mediante clic y arrastre, manteniéndolo en una posición fija.
Ocultar controles de zoom
Elimina los controles de acercar/alejar, manteniendo un nivel de zoom constante en el mapa.
Desactivar zoom con la rueda del ratón
Impide que el mapa acerque o aleje con la rueda del ratón, garantizando un nivel de zoom estable.
Desactivar zoom con doble clic
Desactiva el zoom al hacer doble clic en el mapa, manteniendo un nivel de zoom fijo.
Desactivar la interfaz predeterminada
Elimina elementos estándar de la interfaz del mapa, como el selector de Street View, proporcionando una visualización más limpia.
Mostrar pie de página
Muestra un pie de página en el mapa para información adicional, como fuentes de datos del mapa o una leyenda.
Buscable
Añade una barra de búsqueda al mapa, permitiendo a los usuarios encontrar y acercarse fácilmente a ubicaciones o puntos específicos.
Ubicación del centro del mapa
Cuando hay varios marcadores en el mapa, se centrará automáticamente en un punto central cercano al centro de todos los marcadores. Calcula este punto en función de sus ubicaciones.

Interacciones
Para el componente Mapa, cuenta con una interacción "al seleccionar". Esta función te permite especificar qué acción debe ocurrir cuando los usuarios hacen clic en un marcador del mapa.

Muestra una breve notificación emergente en la pantalla, proporcionando una respuesta rápida o información después de hacer clic en un marcador de mapa.
Redirige al usuario a una página diferente de tu sitio o URL, guiándolo hacia información más detallada sobre la ubicación en la que hizo clic.
Abre una ventana modal con un mensaje de alerta, presentando información importante o advertencias sobre la ubicación seleccionada.
Activa un cuadro de diálogo de confirmación, usado para acciones que requieren confirmación adicional del usuario, como la asistencia a un evento.
Abre un diálogo que ejecuta un flujo de Salesforce, iniciando flujos de trabajo o procesos relacionados con la ubicación en la que se hizo clic.
Configuración
Título de la lista
Establece un título para tu lista del mapa.
Vista de lista
Esta función es especialmente útil para que los usuarios vean una lista detallada de los lugares o elementos del mapa.
Auto: Determina automáticamente la mejor vista.
Visible: Mantiene la vista de lista siempre visible.
Oculto: Oculta la vista de lista.
Nivel de zoom
Los niveles de zoom van de 1 a 22 en navegadores de escritorio y de 1 a 20 en dispositivos móviles.
Aquí tienes una guía rápida de lo que generalmente muestra cada nivel de zoom:
Nivel 1: El mundo entero
Nivel 5: Un continente o una gran masa terrestre
Nivel 10: Una ciudad
Nivel 15: Detalles a nivel de calle
Nivel 20: Edificios individuales
Desactivar arrastre
Evita que los usuarios arrastren la vista del mapa.
Ocultar controles de zoom
Elimina los controles de acercar/alejar del mapa
Desactivar zoom con la rueda del ratón
Desactiva el zoom usando la rueda de desplazamiento del ratón
Desactivar doble clic
Evita que al hacer doble clic se acerque el mapa
Desactivar la interfaz predeterminada
Elimina la interfaz estándar de Google Maps para un aspecto más limpio
Mostrar pie de página
Añade una sección de pie de página al componente Mapa
Buscable
Habilita una función de búsqueda dentro del mapa
Fuente de datos
Manual: Añade marcadores de mapa manualmente.
Consulta: Usa datos de Salesforce con asignación de datos para la colocación automática de marcadores
Ubicación del centro del mapa
Especifica el punto central inicial del mapa
Opciones de filtrado
Configura filtros para el mapa, mostrados como un popover
Opciones del motor de búsqueda
Marcador de posición: Texto que se muestra en la barra de búsqueda antes de introducir algo.
Posición: Elige entre izquierda, derecha, centro o relleno para la posición de la barra de búsqueda
Tamaño
Ancho y alto: Especifica las dimensiones del componente Mapa.
"Desbordamiento" se refiere a cómo se maneja o muestra el contenido que excede los límites de su contenedor. Cuando el contenido dentro de un componente de diseño es demasiado grande para ajustarse a las dimensiones asignadas (alto y ancho), la configuración de desbordamiento determina qué sucede con el contenido sobrante.
Desbordamiento: Controla cómo se gestiona el contenido desbordado.
Ejemplos de casos de uso
Ejemplo 1 : Mapa reactivo de cuentas
Da vida a tus datos de cuentas con un mapa interactivo que responde al instante a las selecciones del usuario. Al conectar el componente Mapa con tu Tabla de datos de cuentas, puedes mostrar ubicaciones exactas de facturación en el momento en que un representante hace clic en cualquier registro de cuenta.
Lo que lograrás
Mapeo contextual: El mapa se actualiza automáticamente para mostrar la ubicación de facturación de la cuenta seleccionada según la elección del representante en la tabla de datos
Navegación de cuentas optimizada: Los representantes pueden localizar visualmente las cuentas sin salir nunca de la página
Antes de empezar
Componente Tabla de datos de cuentas: Asegúrate de que ya haya un componente Tabla de datos de cuentas colocado en la página con el nombre de API
AccountsTable
Cómo configurarlo
Ejemplo 2 : Seguimiento de pedidos de clientes
Ofrece a tus clientes visibilidad en tiempo real sobre dónde están sus pedidos. Al asignar datos de geolocalización directamente desde el objeto Pedido, puedes crear una experiencia de seguimiento transparente e intuitiva que mantenga informados a los clientes en cada paso del proceso.
Lo que lograrás
Visibilidad del pedido en tiempo real: Los clientes pueden ver la ubicación actual de su pedido trazada en un mapa interactivo
Confianza a través de la transparencia: Una experiencia de seguimiento clara y visual reduce las consultas de soporte y mejora la satisfacción del cliente
Antes de empezar
Campo de geolocalización personalizado: Asegúrate de haber creado un campo de Geolocalización personalizado en el objeto Pedido para almacenar coordenadas de seguimiento en tiempo real
Cómo configurarlo
Última actualización
¿Te fue útil?

