Shortcode web_gmap
El shortcode web_gmap muestra el componente de mapa avanzado.
Los atributos siguientes coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis sin procesar solo para contenido revisado que no pueda mantenerse mediante los controles visuales.
Shortcodes secundarios permitidos: web_gmap_marker, web_gmap_route, web_gmap_dynamic_route.
Uso
[web_gmap]
Content
[/web_gmap]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
height |
300px |
Valor positivo en px/rem/em/%/vh/vw | Limitado a 3000px o 200 unidades relativas; los valores no válidos usan 300px. El porcentaje necesita un contenedor principal con tamaño definido. |
center_based_on_markers |
calculate |
custom, calculate |
Establece un centro personalizado o usa el centro de los límites de marcadores resueltos. El zoom de ajuste anula el centro personalizado mientras existan marcadores. |
center_lat |
— | Cadena, salvo que se indique lo contrario | Controla la latitud predeterminada del centro del mapa. Disponible cuando center_based_on_markers es custom. |
center_long |
— | Cadena, salvo que se indique lo contrario | Controla la longitud predeterminada del centro del mapa. Disponible cuando center_based_on_markers es custom. |
zoom_level |
12 |
fit, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 |
Cuanto menor sea el número, mayor será la cobertura. |
zoom_control |
yes |
yes |
Controla el control de zoom. |
map_type_control |
yes |
yes |
Controla el control de tipo de mapa. |
street_view_control |
— | yes |
Controla el control de street view. |
full_screen_control |
— | yes |
Controla el control de pantalla completa. |
custom_style_name |
Map |
Cadena, salvo que se indique lo contrario | Controla el nombre del estilo personalizado. |
json_map_styles |
Estilo de mapa del tema | Matriz JSON codificada en Base64, opcionalmente codificada en URL | El editor visual se encarga de la codificación. Una matriz vacía codificada selecciona el estilo estándar de Google. |
el_id |
ID único generado | Ancla HTML opcional | Usa un ancla única cuando te dirijas a un mapa concreto. |
device_visibility |
— | Cadena, salvo que se indique lo contrario | Aplica la regla de visibilidad responsive seleccionada. |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas aplicar un estilo diferente a un elemento de contenido concreto, usa este campo para añadir un nombre de clase y haz referencia a él en tu archivo CSS. |
Contenido incluido
El contenido entre las etiquetas de apertura y cierre se procesa como contenido de shortcode de WordPress. Mantén la estructura de elemento principal/secundario mostrada por el constructor visual para que los componentes anidados reciban el contexto que esperan.
Requisito de Google Maps
Configura Google Maps en Settings → POM Theme → Integrations → Google Maps antes de usar este componente.
Verificación
Rellena web_gmap con shortcodes secundarios de marcador de mapa o de ruta y confirma que cada elemento secundario siga siendo accesible en el orden previsto. Presta especial atención a height y center_based_on_markers.
Los mapas heredados conservan todos los marcadores y rutas creados; el bloque Map nativo tiene límites de composición independientes. Los límites de waypoints del proveedor siguen aplicándose a cada solicitud de indicaciones, y las rutas largas se dividen en solicitudes consecutivas.
Ambos editores usan el mismo tiempo de ejecución de mapas. Los bloques Map nativos mantienen las dimensiones en el CSS de la página; las alturas de shortcode existentes conservan su declaración en línea validada. La Vista previa de WordPress es pasiva. Los mapas públicos contactan con Google a través del cargador compartido; configura la gestión del consentimiento y el acceso aprobado a la API antes de la publicación.
Se admite el almacenamiento en caché de páginas HTML estáticas. El reproductor compartido también lee el marcado de mapa generado por versiones anteriores del shortcode, por lo que las páginas en caché existentes no necesitan una migración de contenido.