Estás viendo la documentación de Looker 26.20. Haz clic en este vínculo para ver la documentación más reciente.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Parámetros de Google Maps para paneles de LookML

En esta página, se describen los parámetros para crear y editar elementos de paneles de LookML de type: looker_google_map con parámetros de paneles de LookML en un archivo dashboard.lkml.

Para obtener información sobre cómo crear un gráfico de Google Maps a través de la IU de Looker, consulta la página de documentación Opciones de gráficos de Google Maps. Para obtener información sobre los tipos de campos necesarios para crear un gráfico de mapa interactivo, consulta la sección Parámetros de consulta que aparece más adelante en esta página.

Ejemplo de uso

Un N indica que se requiere un valor numérico. Las comillas simples indican texto descriptivo y no deben incluirse en el código activo.


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_google_map
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone

## PLOT PARAMETERS
map_plot_mode: points | automagic_heatmap | heatmap | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: 'decimal number between 0 and 1'

## MAP PARAMETERS
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night | minimal
map_position: fit_data | custom
map_latitude: 'latitude value'
map_longitude: 'longitude value'
map_zoom: N
map_scale_indicator: off | metric | imperial | metric_imperial
map_pannable: true | false
map_zoomable: true | false
show_view_names: true | false
show_legend: true | false
show_region_field: true | false
draw_map_labels_above_data: true | false

## POINT PARAMETERS
map_marker_type: circle | icon | circle_and_icon | none
map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed: N
map_marker_radius_min: N
map_marker_radius_max: N
map_marker_proportional_scale_type: linear | log
map_marker_units: meters | pixels
map_marker_color_mode: value | fixed
map_marker_color: ['color value']

## VALUE PARAMETERS
map_value_colors: ['one or more color values']
quantize_map_value_colors: true | false
reverse_map_value_colors: true | false
map_value_scale_clamp_min: N
map_value_scale_clamp_max: N

Definiciones de los parámetros

Nombre del parámetro	Descripción
Parámetros básicos
`name` (para elementos)	Crea un elemento
`title` (para elementos)	Cambia la forma en que se muestra el nombre de un elemento a los usuarios.
`type` (para elementos)	Determina el tipo de visualización que se usará en el elemento.
`height` (para elementos)	Define la altura de un elemento en unidades de `tile_size` para los paneles `layout: tile` y `layout: static`
`width` (para elementos)	Define el ancho de un elemento en unidades de `tile_size` para los paneles `layout: tile` y `layout: static`
`top`	Define la posición de arriba hacia abajo de un elemento en unidades de `tile_size` para paneles `layout: static`
`left`	Define la posición de izquierda a derecha de un elemento en unidades de `tile_size` para paneles de `layout: static`
`row`	Define la posición de arriba hacia abajo de un elemento en unidades de filas para los paneles de `layout: newspaper`
`col`	Define la posición de izquierda a derecha de un elemento en unidades de columnas para los paneles de `layout: newspaper`
`refresh` (para elementos)	Establece el intervalo en el que se actualizará automáticamente el elemento
`note`	Inicia una sección de LookML para definir una nota para un elemento. Este parámetro tiene los subparámetros `text`, `state` y `display`.
Parámetros de búsqueda
`model`	Define el modelo que se usará para la consulta del elemento
`explore` (para elementos)	Define la exploración que se usará para la consulta del elemento
`fields`	Define los campos que se usarán para la consulta del elemento. Esto se puede usar en lugar de `dimensions` y `measures`.
`dimensions`	Define las dimensiones que se usarán para la consulta del elemento
`measures`	Define las mediciones que se usarán para la consulta del elemento
`sorts`	Define las ordenaciones que se usarán para la consulta del elemento
`pivots`	Define las dimensiones que se deben dinamizar para usarlas en la consulta del elemento
`limit`	Define el límite de filas que se usará para la consulta del elemento
`column_limit`	Define el límite de columnas que se usará para la consulta del elemento.
`filters` (para elementos)	Define los filtros que no se pueden cambiar para la consulta del elemento.
`listen`	Define los filtros que se pueden cambiar para la consulta del elemento, si se crearon `filters` (para el panel)
`query_timezone`	Define la zona horaria que se debe usar cuando se ejecuta la consulta.
Parámetros de trazado
`map_plot_mode`	Define cómo se trazan tus datos de ubicación en un elemento de `type: looker_map`
`heatmap_gridlines`	Agrega un borde alrededor de cada una de las líneas de cuadrícula que se usan para un elemento de mapa de calor.
`heatmap_gridlines_empty`	En el caso de los mapas de calor con `heatmap_gridlines` establecido en `true`, muestra un contorno alrededor de las regiones del mapa que no tienen datos asociados
`heatmap_opacity`	Define la opacidad de los colores que se usan en un mapa de calor.
Parámetros de mapa
`map_tile_provider`	Define el tipo de mapa de fondo y si se muestran las etiquetas del mapa
`map_position`	Define el punto central y el nivel de zoom del mapa visible
`map_latitude`	Define la latitud de un mapa con `map_position` establecido en `custom`
`map_longitude`	Define la longitud de un mapa con `map_position` establecido en `custom`
`map_zoom`	Define el zoom de un mapa con `map_position` establecido en `custom`
`map_scale_indicator`	Establece si se mostrará una escala del mapa y el tipo de unidades que se mostrarán
`map_pannable`	Establece si los usuarios pueden cambiar la posición del mapa arrastrándolo
`map_zoomable`	Establece si los usuarios pueden acercar y alejar el mapa.
`show_view_names`	Establece si se debe mostrar el nombre de la vista junto con el nombre del campo en los cuadros de información del mapa
`show_legend`	Establece si se debe mostrar una leyenda del mapa en la parte inferior derecha de la visualización.
`show_region_field`	Establece si se debe mostrar la información de la región en el cuadro de información del mapa
`draw_map_labels_above_data`	Muestra las etiquetas del mapa por encima o por debajo del mapa de calor
Parámetros de puntos
`map_marker_type`	Especifica el tipo de punto que se muestra en el mapa para los elementos con `map_plot_mode` establecido en `points`, `lines` o `areas`.
`map_marker_icon_name`	Especifica el tipo de ícono que se mostrará en todos los marcadores de mapa para los elementos con `map_marker_type` establecido en `icon` o `circle_and_icon`.
`map_marker_radius_mode`	Establece la forma en que se dimensionan los círculos para los elementos con `map_marker_type` configurado como `circle` o `circle_and_icon`.
`map_marker_radius_fixed`	Establece un radio fijo para aplicar a todos los marcadores de mapa, para los elementos con `map_marker_type` establecido en `circle` o `circle_and_icon` y `map_marker_radius_mode` establecido en `fixed`
`map_marker_radius_min`	Establece el radio mínimo de los círculos para los elementos con `map_marker_radius_mode` establecido en `proportional_value`
`map_marker_radius_max`	Establece el radio máximo de los círculos para los elementos con `map_marker_radius_mode` establecido en `proportional_value`.
`map_marker_proportional_scale_type`	Especifica si el tamaño del círculo se basa en una escala lineal o logarítmica, para los elementos con `map_marker_type` establecido en `circle` o `circle_and_icon` y `map_marker_radius_mode` establecido en `proportional_value`
`map_marker_units`	Establece las unidades que se usan para el radio de un círculo en `meters` o `pixels`, para los elementos con `map_marker_type` establecido en `circle` o `circle_and_icon`.
`map_marker_color_mode`	Especifica si el color de los marcadores del mapa es fijo o si los colores se asignan de forma dinámica a los marcadores según los valores de la consulta subyacente
`map_marker_color`	Especifica un solo color para aplicar a todos los marcadores de mapa, para los elementos con `map_marker_color_mode` establecido en `fixed`
Parámetros de valor
`map_value_colors`	Especifica los colores de los puntos del mapa o define el rango de colores que se usarán si estableces códigos de color según una medición
`quantize_map_value_colors`	Cambia la escala de colores de un gradiente suave a solo los colores específicos que hayas establecido
`reverse_map_value_colors`	Cambia los colores que indican los valores altos y bajos en el gráfico, lo que invierte el gradiente de color.
`map_value_scale_clamp_min`	Establece el valor mínimo del rango de colores
`map_value_scale_clamp_max`	Establece el valor máximo del rango de colores

Parámetros básicos

Cuando definas un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros básicos name y type. Otros parámetros básicos, como title, height y width, afectan la apariencia y la posición de un elemento en un panel.

`name`

En esta sección, se hace referencia al parámetro name que forma parte de un elemento de panel.

name también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

Cada declaración name crea un nuevo elemento de panel y le asigna un nombre. Los nombres de los elementos deben ser únicos. A veces, se hace referencia a los nombres en el parámetro elements cuando usas paneles layout: grid o en el parámetro group de los elementos secundarios cuando organizas elementos en un grupo de tarjetas (type: group).

- name: orders_by_date

`title`

En esta sección, se hace referencia al parámetro title que forma parte de un elemento de panel.

title también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

title también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

El parámetro title te permite cambiar la forma en que se mostrará el nombre de un elemento a los usuarios. Si no se especifica, el título se establece de forma predeterminada en el elemento name.

Considera el siguiente ejemplo:

- name: sales_overview
  title: '1) Sales Overview'

Si usaras este formato, en lugar de que el elemento aparezca como Descripción general de las ventas, aparecería como 1) Descripción general de las ventas.

`type`

En esta sección, se hace referencia al parámetro type que forma parte de un elemento de panel.

type también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

type también se puede usar como parte de una unión, que se describe en la página de documentación del parámetro type (para uniones).

type también se puede usar como parte de una dimensión, que se describe en la página de documentación Tipos de dimensiones, filtros y parámetros.

type también se puede usar como parte de una medición, que se describe en la página de documentación Tipos de mediciones.

El parámetro type determina el tipo de visualización que se usará en el elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth |
        looker_waterfall | looker_wordcloud | looker_boxplot | button | group

Consulta la página de documentación de type (para paneles de LookML) para obtener una descripción general de los diferentes tipos de elementos de panel de LookML.

`height`

En esta sección, se hace referencia al parámetro height que forma parte de un elemento de panel.

height también se puede usar como parte de una fila del panel, que se describe en la página de documentación Parámetros del panel.

Para paneles con diseños `tile` o `static`

El parámetro height define la altura de un elemento, en unidades de tile_size (que se define en píxeles), para los paneles layout: tile y layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y height: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Para paneles con diseño de `newspaper`

El parámetro height define la altura de un elemento, en unidades de fila, para los paneles de layout: newspaper.

Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, o alrededor de 300 píxeles. La altura mínima es de 1 fila para los paneles con un parámetro preferred viewer establecido en dashboards-next. La altura mínima es de 2 filas para los paneles con un parámetro preferred viewer establecido en dashboards.

Por ejemplo, el siguiente código establece que un elemento tenga 12 filas de alto, o el doble de alto que otros elementos que se establecen en el valor predeterminado:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

`width`

En esta sección, se hace referencia al parámetro width que forma parte de un elemento de panel.

width también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

El parámetro width define el ancho de un elemento, en unidades de tile_size, para los paneles layout: tile y layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y width: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de ancho.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

El parámetro width define el ancho de un elemento, en unidades de columnas, para los paneles de layout: newspaper.

Un panel con diseño de periódico tiene un ancho predeterminado de 24 columnas.

Por ejemplo, el siguiente código establece el elemento en la mitad del ancho del panel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

`top`

El parámetro top define la posición de arriba abajo de un elemento, en unidades de tile_size, para los paneles de layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y top: 4, lo que posiciona el borde superior del elemento orders_by_date a 400 píxeles de la parte superior del panel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

`left`

El parámetro left define la posición de izquierda a derecha de un elemento, en unidades de tile_size, para los paneles de layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y left: 4, lo que posiciona el borde izquierdo del elemento orders_by_date a 400 píxeles del lado izquierdo del panel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

`row`

Para los paneles layout: newspaper, el parámetro row define la fila en la que se coloca el borde superior de un elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, row define la posición de la fila del elemento en relación con la parte superior del contenedor del grupo (row: 0).

Un panel comienza con la fila 0 en la parte superior. Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, lo que significa que los elementos del panel en la parte superior de un panel (row: 0) ocuparían las filas de la 0 a la 5 de forma predeterminada.

Cada fila tiene 50 píxeles de alto, lo que significa que la altura predeterminada del elemento de 6 filas es de 300 píxeles.

Por ejemplo, el siguiente código establece un elemento que se colocará en la segunda fila de elementos del panel, suponiendo que los elementos se establecen en la altura predeterminada:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

`col`

Para los paneles layout: newspaper, el parámetro col define la columna en la que se coloca el borde izquierdo del elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, col define la posición de la columna del elemento en relación con el borde izquierdo del contenedor del grupo (col: 0).

Los paneles se dividen en 24 columnas. Un panel comienza con la columna 0 a la izquierda del panel. Un panel con diseño de periódico tiene un ancho de elemento predeterminado de 8 columnas, lo que significa que los elementos del panel que se encuentran a la izquierda (col: 0) ocuparían las columnas de la 0 a la 7 de forma predeterminada.

Por ejemplo, el siguiente código establece que un elemento se coloque en la tercera columna de elementos del panel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

`refresh`

En esta sección, se hace referencia al parámetro refresh que forma parte de un elemento de panel.

refresh también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

El parámetro refresh permite que un elemento se vuelva a cargar automáticamente de forma periódica, lo que recupera datos actualizados. Esto suele ser útil en entornos en los que se muestra un panel de forma constante, como en la TV de una oficina. Ten en cuenta que el panel debe estar abierto en una ventana del navegador para que este parámetro tenga efecto. Este parámetro de configuración no se ejecuta en segundo plano para "precalentar" la caché del panel.

La frecuencia de actualización puede ser cualquier cantidad (sin decimales) de segundos, minutos, horas o días. Por ejemplo:

- name: orders_by_date
  refresh: 2 hours

Ten cuidado cuando configures intervalos de actualización cortos. Si la consulta detrás del elemento consume muchos recursos, es posible que ciertos elementos sobrecarguen tu base de datos más de lo deseado.

`note`

Puedes agregar notas descriptivas a los elementos de la siguiente manera:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note tiene los subparámetros text, state y display.

`text`

El subparámetro text especifica el texto que se muestra en la nota. El texto se puede localizar.

`state`

El subparámetro state determina si la nota se collapsed o expanded si es demasiado grande para caber en una sola fila dentro del ancho del elemento. Si eliges collapsed y la nota es demasiado larga, terminará con puntos suspensivos en los que se puede hacer clic (...) para leer la nota completa.

`display`

El subparámetro display determina dónde se muestra la nota en un elemento. above coloca la nota en la parte superior de un elemento, below la coloca en la parte inferior de un elemento y hover requiere que el usuario coloque el cursor sobre el elemento para ver la nota.

Parámetros de consulta

Cuando definas un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros de consulta model y explore.

Para los elementos de panel de LookML de type: looker_google_map, también debes especificar al menos un campo geográfico como el valor del parámetro dimensions o fields. Un campo geográfico puede ser uno de los siguientes:

Es una dimensión basada en datos de latitud y longitud, definida en LookML como una dimensión de type: location.
Una dimensión con una capa del mapa asignada Los desarrolladores de LookML pueden agregar una capa del mapa integrada o una capa del mapa personalizada a una medición con el parámetro map_layer_name.
Es una dimensión de código postal. Las regiones de códigos postales se basan en las áreas de tabulación de códigos postales (ZCTA) de 2010. Si visualizas códigos postales, es posible que no haya una correspondencia uno a uno entre los códigos postales y las ZCTA que se usan para las visualizaciones de mapas, por lo que es posible que no se visualicen todos los puntos en el mapa.

También puedes usar los otros parámetros de consulta que se describen a continuación para controlar la forma en que se muestran los datos en un elemento de panel. Para obtener más información sobre los requisitos para crear un gráfico de mapa interactivo con la IU de Looker, consulta la sección Crea un gráfico de Google Maps de la página de documentación Opciones de gráficos de mapa.

`model`

El parámetro model define el modelo que se usará para la consulta de elementos. Si no se especifica, se usará de forma predeterminada el modelo en el que reside el panel.

- name: orders_by_date
  model: ecommerce

El parámetro model acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de model. Usar una constante te permite definir el nombre de un modelo en un solo lugar, lo que es particularmente útil si actualizas el nombre de un modelo que usan varios elementos de panel.

Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.

`explore`

En esta sección, se hace referencia al parámetro explore que forma parte de un elemento de panel.

explore también se puede usar como parte de un modelo, que se describe en la página de documentación del parámetro explore.

explore también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

El parámetro explore define la exploración que se usará para la consulta del elemento.

- name: orders_by_date
  explore: order

El parámetro explore acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de explore. Usar una constante te permite definir el nombre de una exploración en un solo lugar, lo que es particularmente útil si actualizas el nombre de una exploración que usan varios elementos de panel.

Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.

`fields`

El parámetro fields define los campos que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar los campos.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Si usas el parámetro fields, no necesitas usar los parámetros dimensions y measures.

`dimensions`

El parámetro dimensions define la dimensión o las dimensiones que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas dimensions si la consulta no tiene ninguno.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

`measures`

El parámetro measures define la medición o las mediciones que se usarán para la consulta de elementos. Usa la sintaxis view_name.measure_name para especificar la medición. No incluyas measures si la consulta no tiene ninguno.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

`sorts`

El parámetro sorts define el comportamiento de ordenamiento para la consulta del elemento. Enumera primero el campo de ordenamiento principal, seguido de los campos de ordenamiento secundarios. Usa la sintaxis view_name.field_name para especificar la dimensión o la medición por la que se ordenará.

Si omites el parámetro sorts, el elemento usa el orden de clasificación predeterminado de Looker. Las ordenaciones ascendentes no requieren un sufijo, mientras que las descendentes requieren el sufijo desc.

En el siguiente ejemplo, se define un solo orden:

- name: orders_by_date
  sorts: order.order_date desc

En el siguiente ejemplo, se definen varias clasificaciones:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Si dinamizas las dimensiones, puedes ordenar los resultados de la consulta especificando el nombre de la medición, la dirección de ordenamiento y el número de índice basado en 0 de la columna de destino en la tabla de datos. Por ejemplo, el siguiente elemento ordena por la primera columna dinámica con el índice 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Para ordenar por el total de la fila, especifica el índice de la columna de totales. Por ejemplo, el siguiente elemento ordena por el total de la fila con el índice 2, que representa la columna de totales para una consulta con dos columnas dinámicas:

- name: orders_by_cohort
  sorts: [users.count desc 2]

`pivots`

El parámetro pivots define las dimensiones que se deben dinamizar para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas pivots si la consulta no tiene ninguno.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

`limit`

El parámetro limit define el límite de filas que se debe usar para la consulta de elementos. El límite se aplica a la cantidad de filas antes de que se apliquen las tablas dinámicas.

- name: orders_by_date
  limit: 100

`column_limit`

El parámetro column_limit define el límite de columnas que se debe usar para la consulta de elementos. El límite se aplica a la cantidad de columnas después de que se aplican las tablas dinámicas.

- name: orders_by_date
  column_limit: 100

`filters`

En esta sección, se hace referencia al parámetro filters que forma parte de un elemento de panel.

filters también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

filters también se puede usar como parte de una medición, que se describe en la página de documentación del parámetro filters.

El parámetro filters define los filtros no modificables que se deben usar para la consulta del elemento. Si quieres filtros que un usuario pueda cambiar en el panel, debes configurarlos con filters para paneles y, luego, aplicarlos a los elementos con listen.

La sintaxis de filters es la siguiente:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Cada filtro puede aceptar una expresión de filtro de Looker o una constante de valor. También puedes usar las variables de Liquid _localization o _user_attributes en la expresión de filtro para obtener valores de filtro flexibles.

`listen`

Los filtros de panel permiten que los usuarios definan mejor de forma interactiva los datos que se muestran en los elementos de panel. Define filtros de paneles con el parámetro filters para paneles de LookML. Luego, usa el parámetro listen para vincular los elementos del panel al filtro del panel.

La sintaxis de listen es la siguiente:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Agrega el parámetro listen a un elemento y, luego, proporciona el nombre del filtro seguido de dos puntos y una referencia al campo al que se debe aplicar el filtro, con la sintaxis view_name.field_name. Por ejemplo, puedes crear un filtro llamado Fecha que requiera que el usuario ingrese una fecha en el campo de filtro de la IU. Luego, puedes aplicar el valor que ingresa el usuario al elemento orders_by_date de la siguiente manera:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Si el filtro que se escucha se configura con el parámetro vis_filter: true, el control de filtro aparece en una barra de filtros directamente en la parte superior de esa tarjeta de visualización, en lugar de en la barra de filtros del panel superior.

Para obtener más ejemplos de cómo usar los parámetros filters y listen para aplicar filtros de panel a elementos de panel individuales, consulta Cómo compilar paneles de LookML.

`query_timezone`

El parámetro query_timezone especifica la zona horaria en la que se ejecutará la consulta. Las opciones de zona horaria se muestran en la página de documentación Valores para timezone. Si quieres que la consulta se ejecute con la zona horaria del visualizador, puedes asignar el valor como user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Parámetros de trazado

Los parámetros que se describen en esta sección corresponden a las opciones de la sección Trazado del editor de visualizaciones para gráficos de mapa.

Los parámetros que puedes usar con un elemento de type: looker_google_map dependen de si tu consulta incluye una dimensión de type: location o tiene una capa del mapa asociada.

`map_plot_mode`

El parámetro map_plot_mode define la forma en que se trazan tus datos en un elemento type: looker_google_map que se basa en una dimensión de type: location. Este parámetro no está disponible para los mapas basados en una dimensión con una capa de mapa asociada ni para las dimensiones de código postal. El parámetro map_plot_mode acepta los siguientes valores:

points
automagic_heatmap
heatmap
lines
areas

`points`

Si configuras map_plot_mode como points, se traza cada fila de la tabla de datos subyacente como un punto discreto en el mapa.

Una dimensión de type: location por sí sola coloca puntos de tamaño y color uniformes en el mapa. Agregar una medición a la consulta permite que los puntos se escalen por color o tamaño con los parámetros map_marker_radius_mode y map_marker_color_mode.

`automagic_heatmap`

Si configuras map_plot_mode como automagic_heatmap, los datos de la consulta subyacente se mostrarán como una cuadrícula de mapa de calor. Para ello, divide el mapa visible en cuadrados iguales y, luego, calcula qué valores de tus datos se ajustan a cada cuadrado. Los cuadrados se colorean según la medida que elijas. Si acercas o alejas este mapa, Looker volverá a calcular la cuadrícula para que el nivel de detalle sea el adecuado para el nivel de zoom.

Tu consulta debe incluir una dimensión de type: location y una medición para que este tipo de gráfico funcione correctamente.

`heatmap`

Si configuras map_plot_mode como heatmap, se produce un mapa que puede mostrar una gran cantidad de datos de ubicación con muchos puntos agrupados de forma cercana. La intensidad y la escala de colores transmiten la concentración de puntos de datos en cada área.

Tu consulta debe incluir una dimensión de type: location. De manera opcional, puedes agregar una medición.

`lines`

Si configuras map_plot_mode como lines, se toman dos dimensiones de type: location de tu consulta y se conectan en la visualización. Agregar una medición a tu consulta te permite agregar una escala de colores a las líneas.

`areas`

Si configuras map_plot_mode como areas, se toma una dimensión de type: location y se conectan todos los puntos en el orden en que los ordenaste. Esto forma los límites de un área en el elemento de mapa. Agregar una medición a la consulta te permite dar formato al tamaño y al color de los puntos de ubicación individuales que conforman los límites del área.

`heatmap_gridlines`

En el caso de los elementos de mapa de calor, si se establece heatmap_gridlines en true, se agrega un borde alrededor de cada una de las líneas de cuadrícula que se usan para el mapa de calor. Este parámetro está disponible cuando trazas una dimensión de type: location con map_plot_mode establecido en automagic_heatmap, o cuando trazas una dimensión de código postal o una dimensión con una capa del mapa asociada.


heatmap_gridlines: true | false

`heatmap_gridlines_empty`

Cuando heatmap_gridlines se establece en true para los elementos del mapa de calor y trazas datos con un map_layer definido, establecer heatmap_gridlines_empty en true muestra un contorno alrededor de las regiones del mapa que no tienen datos asociados.


heatmap_gridlines_empty: true | false

`heatmap_opacity`

En el caso de los elementos de mapa de calor, puedes usar heatmap_opacity para especificar la opacidad de los colores que se usan en el mapa de calor. Especifica un número decimal entre 0 y 1 como el valor de heatmap_opacity, donde 0 significa que no hay color y 1 significa que es totalmente opaco.


heatmap_opacity: 0.5

Parámetros del mapa

La mayoría de los parámetros que se describen en esta sección corresponden a las opciones de la sección Opciones del menú Mapa del editor de visualizaciones para gráficos de columnas.

`map_tile_provider`

Disponible para todos los mapas, el parámetro map_tile_provider te permite cambiar el tipo de mapa de fondo y especificar si se muestran las etiquetas del mapa (como ciudades y calles).

light: Mapa sutil de colores claros diseñado para proporcionar contexto geográfico y, al mismo tiempo, destacar tus datos
light_no_labels: Es igual que light, excepto que el mapa omite las etiquetas, como los nombres de las ciudades.
dark: Mapa sutil de color oscuro diseñado para proporcionar contexto geográfico y, al mismo tiempo, destacar tus datos
dark_no_labels: Es igual que dark, excepto que el mapa omite las etiquetas, como los nombres de las ciudades.
satellite_streets: Mapa que muestra imágenes satelitales y aéreas globales
satellite: Es igual que satellite_streets, excepto que el mapa omite las etiquetas, como los nombres de las ciudades.
streets: Es un mapa de uso general que destaca el diseño legible de las redes de rutas y transporte público.
outdoors: Es un mapa de uso general adaptado para senderismo, ciclismo y otros usos al aire libre.
traffic_day: Es un mapa de color claro que destaca las redes de transporte público y las rutas, incluida la información del tráfico actual.
traffic_night: Es un mapa de color oscuro que destaca las redes de transporte público y las rutas, incluida la información de tráfico actual.
minimal: Mapa de color claro sin etiquetas ni líneas de límites


map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
                    satellite | streets | outdoors | traffic_day | traffic_night

`map_position`

Puedes usar el parámetro map_position para establecer el punto central y el nivel de zoom del mapa visible. Existen dos opciones para especificar esta posición:

fit_data: Centra y acerca automáticamente el mapa para que todos los datos de tu consulta sean visibles.
custom: Te permite especificar manualmente la latitud, la longitud y el nivel de zoom con los parámetros map_latitude, map_longitude y map_zoom.


map_position: fit_data | custom

`map_latitude`

El parámetro map_latitude especifica la latitud de un elemento de mapa con map_position establecido en custom.


map_latitude: -5.804047131379801

`map_longitude`

El parámetro map_longitude especifica la longitud de un elemento de mapa con map_position establecido en custom.


 map_longitude: 113.34732055664064

`map_zoom`

El parámetro map_zoom te permite especificar el nivel de zoom de un elemento del mapa con map_position establecido en custom. Los números más altos crean un nivel de zoom más cercano.


map_zoom: 10

`map_scale_indicator`

El parámetro map_scale_indicator, que se establece en 'off' de forma predeterminada, te permite especificar si se muestra una escala del mapa y establecer los tipos de unidades que se muestran.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

`map_pannable`

El parámetro map_pannable especifica si los usuarios pueden cambiar la posición del mapa arrastrándolo. Esta opción está habilitada de forma predeterminada.


map_pannable: true | false

`map_zoomable`

El parámetro map_zoomable especifica si los usuarios pueden acercar y alejar el elemento del mapa. Esta opción está habilitada de forma predeterminada.


map_zoomable: true | false

`show_view_names`

El parámetro show_view_names especifica si se debe mostrar el nombre de la vista junto con el nombre del campo en las descripciones emergentes del mapa, que se muestran cuando los usuarios hacen clic en los datos del mapa.


show_view_names: true | false

`show_legend`

Especifica si se debe mostrar una leyenda del mapa en la parte inferior derecha de la visualización. La leyenda muestra la escala de colores que estás usando, si agregaste una medición a tu visualización.

El parámetro show_legend está disponible cuando se especifican las siguientes opciones de trazado:

Cuando map_plot_mode se haya establecido en automagic_heatmap
Cuando map_plot_mode se estableció en points y map_marker_color_mode se estableció en value


show_legend: true | false

`show_region_field`

En el caso de los mapas basados en una capa de mapa o un código postal, el parámetro show_region_field muestra la información en la información sobre la herramienta del mapa. Los usuarios pueden hacer clic en un punto del mapa para ver el nombre de la región.


show_region_field: true | false

`draw_map_labels_above_data`

En el caso de los mapas de capa de mapa o los mapas basados en una dimensión de código postal, puedes usar el parámetro draw_map_labels_above_data para mostrar las etiquetas del mapa por encima o por debajo del mapa de calor. Esto es especialmente importante con valores de opacidad más altos del mapa de calor. Si el mapa de calor es opaco, las etiquetas no se mostrarán, a menos que se muestren sobre los datos.


draw_map_labels_above_data: true | false

Parámetros de puntos

Las opciones de puntos no están disponibles para los mapas con map_plot_mode establecido en automagic_heatmap o heatmap.

`map_marker_type`

En el caso de los mapas basados en una dimensión de ubicación y con map_plot_mode establecido en points, lines o areas, el parámetro map_marker_type define el tipo de punto que se muestra en el elemento del mapa. El parámetro map_marker_type acepta los siguientes valores:

circle
icon
circle_and_icon
none

El valor que especifiques para map_marker_type afecta los parámetros que están disponibles para dar formato a los puntos que se muestran en el mapa.

`map_marker_icon_name`

Si map_marker_type se establece en icon o circle_and_icon, puedes usar el parámetro map_marker_icon_name para establecer el tipo de ícono que se mostrará en todos los marcadores de mapa.


map_marker_icon_name: default | airplane | ambulance | anchor | beaker | bell | bolt | briefcase |
                      building | camera | car | checkmark | coffee | comment | envelope | file |
                      gamepad | gavel | gift | glass | headphones | heart | house | key | leaf |
                      microphone | music | person | phone | restaurant | school | shopping_cart |
                      star | suitcase | taxi | tree | trophy | truck | university | wrench

`map_marker_radius_mode`

En los mapas con map_marker_type configurado como circle o circle_and_icon, puedes usar el parámetro map_marker_radius_mode para establecer los tamaños de los círculos según las siguientes opciones:

proportional_value: Esta opción ajusta el tamaño relativo de los círculos según las mediciones que agregaste a tu consulta. Puedes usar los parámetros map_marker_radius_min y map_marker_radius_max con esta opción para establecer un radio mínimo y un radio máximo para los círculos. También puedes usar el parámetro map_marker_proportional_scale_type para establecer si se usa una escala lineal o logarítmica para ajustar el tamaño de los círculos.
equal_to_value: Este parámetro de configuración ajusta el radio de los círculos a los valores de medición reales de tu consulta subyacente.
fixed: Esta opción te permite establecer un radio fijo para aplicar a todos los marcadores de mapa con el parámetro map_marker_radius_fixed. El valor predeterminado es 500.


map_marker_radius_mode: proportional_value | equal_to_value | fixed

`map_marker_radius_fixed`

Cuando map_marker_radius_mode se establece en fixed y map_marker_type se establece en circle o circle_and_icon, puedes usar el parámetro map_marker_radius_fixed para establecer un radio fijo que se aplique a todos los marcadores de mapa.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

`map_marker_radius_min`

En los mapas con map_marker_type configurado como circle o circle_and_icon y map_marker_radius_mode configurado como proportional_value, puedes usar el parámetro map_marker_radius_min para definir el radio mínimo de un círculo.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

`map_marker_radius_max`

En el caso de los mapas con map_marker_type establecido en circle o circle_and_icon y map_marker_radius_mode establecido en proportional_value, puedes usar el parámetro map_marker_radius_max para definir el radio máximo de un círculo.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

`map_marker_proportional_scale_type`

En el caso de los mapas con map_marker_type configurado como circle o circle_and_icon y map_marker_radius_mode configurado como proportional_value, puedes usar el parámetro map_marker_proportional_scale_type para establecer el tamaño del círculo en función de una escala lineal o logarítmica. El valor de este parámetro puede ser linear o log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

`map_marker_units`

En los mapas con map_marker_type configurado como circle o circle_and_icon, puedes usar el parámetro map_marker_units para establecer las unidades que se usan para el radio de un círculo en meters o pixels.


map_marker_units: meters | pixels

`map_marker_color_mode`

Puedes usar map_marker_color_mode para establecer los colores de los marcadores del mapa:

Si map_marker_color_mode se establece en value, los colores se asignan de forma dinámica a los marcadores según los valores de tu consulta subyacente. Puedes usar parámetros de valor para configurar los colores de la leyenda de esta opción.
Si map_marker_color_mode se establece en fixed, puedes usar el parámetro map_marker_color para establecer un solo color que se use en todos los marcadores de mapa.

`map_marker_color`

Cuando map_marker_color_mode se establece en fixed, map_marker_color_mode establece un solo color para todos los marcadores de mapa. El valor de color se puede formatear como una cadena hexadecimal RGB, como 2ca6cd, o como un nombre de color CSS, como mediumblue.


map_marker_color: [mediumblue]

Parámetros de valor

Puedes usar estos parámetros para configurar los colores que se asignarán de forma dinámica a los marcadores según los valores de tu consulta subyacente cuando map_marker_color_mode se establezca en value, o para los elementos del mapa con map_plot_mode establecido en automagic_heatmap, heatmap lines o areas.

`map_value_colors`

Puedes usar el parámetro map_value_colors para establecer el color de los puntos del mapa o, si usas un código de colores según una medición, para definir el rango de colores que se usará. Puedes ingresar una lista de cadenas hexadecimales, como #2ca6cd, o nombres de colores CSS, como mediumblue. Los colores que indiques primero se asociarán con los valores más bajos.


map_value_colors: [green, mediumblue]

`quantize_map_value_colors`

Cuando se establece en true, quantize_map_value_colors cambia la escala de colores de un gradiente suave a solo los colores específicos que hayas establecido. Este parámetro se establece en false de forma predeterminada.


quantize_map_value_colors: true | false

`reverse_map_value_colors`

Cuando se establece en true, el parámetro reverse_map_value_colors cambia los colores que indican valores altos y bajos en el gráfico, lo que invierte el gradiente de color.


reverse_map_value_colors: true | false

`map_value_scale_clamp_min`

Puedes usar el parámetro map_value_scale_clamp_min para establecer el valor mínimo del rango de colores. Esto te permite codificar por color todos los puntos que se encuentren por debajo de un umbral determinado (el número especificado) con el color más bajo especificado con el parámetro map_value_colors. De forma predeterminada, el valor mínimo que se aplica en la leyenda es el valor mínimo de tu consulta.


map_value_scale_clamp_min: 1000

`map_value_scale_clamp_max`

Puedes usar el parámetro map_value_scale_clamp_max para establecer el valor máximo del rango de colores, lo que te permite codificar por color todos los puntos por encima del número especificado con el color más alto especificado con el parámetro map_value_colors. De forma predeterminada, el valor máximo que se aplica en la leyenda es el valor máximo de tu consulta.


map_value_scale_clamp_max: 50000

Parámetros de Google Maps para paneles de LookML Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Ejemplo de uso

Definiciones de los parámetros

Parámetros básicos

name

title

type

height

Para paneles con diseños tile o static

Para paneles con diseño de newspaper

width

top

left

row

col

refresh

note

text

state

display

Parámetros de consulta

model

explore

fields

dimensions

measures

sorts

pivots

limit

column_limit

filters

listen

query_timezone

Parámetros de trazado

map_plot_mode

points

automagic_heatmap

heatmap

lines

areas

heatmap_gridlines

heatmap_gridlines_empty

heatmap_opacity