Você está visualizando a documentação do Looker 26.20. Clique neste link para acessar a documentação mais recente.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Parâmetros do Google Maps para dashboards do LookML

Nesta página, descrevemos os parâmetros para criar e editar elementos de dashboard do LookML de type: looker_google_map com parâmetros de dashboard do LookML em um arquivo dashboard.lkml.

Para saber como criar um gráfico do Google Maps usando a interface do Looker, consulte a página de documentação Opções de gráfico do Google Maps. Para informações sobre os tipos de campos necessários para criar um gráfico de mapa interativo, consulte a seção Parâmetros de consulta mais adiante nesta página.

Exemplo de uso

Um N indica que um valor numérico é obrigatório. As aspas simples indicam texto descritivo e não devem ser incluídas no código ativo.


## 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

Definições de parâmetro

Nome do parâmetro	Descrição
Parâmetros básicos
`name` (para elementos)	Cria um elemento
`title` (para elementos)	Muda como o nome de um elemento aparece para os usuários.
`type` (para elementos)	Determina o tipo de visualização a ser usado no elemento.
`height` (para elementos)	Define a altura de um elemento em unidades de `tile_size` para dashboards `layout: tile` e `layout: static`.
`width` (para elementos)	Define a largura de um elemento em unidades de `tile_size` para dashboards `layout: tile` e `layout: static`.
`top`	Define a posição de cima para baixo de um elemento em unidades de `tile_size` para dashboards `layout: static`.
`left`	Define a posição da esquerda para a direita de um elemento em unidades de `tile_size` para dashboards `layout: static`.
`row`	Define a posição de cima para baixo de um elemento em unidades de linhas para dashboards `layout: newspaper`.
`col`	Define a posição da esquerda para a direita de um elemento em unidades de colunas para dashboards `layout: newspaper`.
`refresh` (para elementos)	Define o intervalo de atualização automática do elemento.
`note`	Inicia uma seção do LookML para definir uma observação para um elemento. Esse parâmetro tem os subparâmetros `text`, `state` e `display`.
Query Parameters
`model`	Define o modelo a ser usado para a consulta do elemento
`explore` (para elementos)	Define a Análise que será usada para a consulta do elemento
`fields`	Define os campos que serão usados para a consulta do elemento. Isso pode ser usado no lugar de `dimensions` e `measures`.
`dimensions`	Define as dimensões a serem usadas para a consulta do elemento
`measures`	Define as medidas a serem usadas para a consulta do elemento
`sorts`	Define as classificações a serem usadas para a consulta do elemento
`pivots`	Define as dimensões que precisam ser dinamizadas para serem usadas na consulta do elemento
`limit`	Define o limite de linhas a ser usado na consulta do elemento
`column_limit`	Define o limite de colunas a ser usado na consulta do elemento
`filters` (para elementos)	Define os filtros que não podem ser alterados para a consulta do elemento.
`listen`	Define os filtros que podem ser alterados para a consulta do elemento, se `filters` (para o painel) tiverem sido criados
`query_timezone`	Define o fuso horário que será usado quando a consulta for executada.
Parâmetros de plotagem
`map_plot_mode`	Define como os dados de local são mostrados em um elemento de `type: looker_map`.
`heatmap_gridlines`	Adiciona uma borda ao redor de cada uma das linhas de grade usadas para um elemento de mapa de calor
`heatmap_gridlines_empty`	Para mapas de calor com `heatmap_gridlines` definido como `true`, mostra um contorno ao redor das regiões do mapa que não têm dados associados
`heatmap_opacity`	Define a opacidade das cores usadas em um mapa de calor.
Parâmetros do mapa
`map_tile_provider`	Define o tipo de mapa de plano de fundo e se os rótulos do mapa são exibidos
`map_position`	Define o ponto central e o nível de zoom do mapa visível.
`map_latitude`	Define a latitude de um mapa com `map_position` definido como `custom`.
`map_longitude`	Define a longitude de um mapa com `map_position` definido como `custom`.
`map_zoom`	Define o zoom de um mapa com `map_position` definido como `custom`.
`map_scale_indicator`	Define se uma escala de mapa será mostrada e o tipo de unidades exibidas.
`map_pannable`	Define se os usuários podem reposicionar o mapa arrastando-o.
`map_zoomable`	Define se os usuários podem aumentar e diminuir o zoom no mapa.
`show_view_names`	Define se o nome da visualização será mostrado com o nome do campo nas dicas do mapa
`show_legend`	Define se uma legenda de mapa deve ser exibida no canto inferior direito da visualização.
`show_region_field`	Define se as informações da região serão exibidas na dica do mapa.
`draw_map_labels_above_data`	Mostra os rótulos do mapa acima ou abaixo do mapa de calor.
Parâmetros de ponto
`map_marker_type`	Especifica o tipo de ponto exibido no mapa para elementos com `map_plot_mode` definido como `points`, `lines` ou `areas`.
`map_marker_icon_name`	Especifica o tipo de ícone a ser exibido em todos os marcadores de mapa para elementos com `map_marker_type` definido como `icon` ou `circle_and_icon`.
`map_marker_radius_mode`	Define como os círculos são dimensionados para elementos com `map_marker_type` definido como `circle` ou `circle_and_icon`.
`map_marker_radius_fixed`	Define um raio fixo a ser aplicado a todos os marcadores de mapa, para elementos com `map_marker_type` definido como `circle` ou `circle_and_icon` e `map_marker_radius_mode` definido como `fixed`
`map_marker_radius_min`	Define o raio mínimo para círculos, para elementos com `map_marker_radius_mode` definido como `proportional_value`.
`map_marker_radius_max`	Define o raio máximo para círculos, para elementos com `map_marker_radius_mode` definido como `proportional_value`.
`map_marker_proportional_scale_type`	Especifica se o tamanho do círculo é baseado em uma escala linear ou logarítmica para elementos com `map_marker_type` definido como `circle` ou `circle_and_icon` e `map_marker_radius_mode` definido como `proportional_value`.
`map_marker_units`	Define as unidades usadas para o raio de um círculo como `meters` ou `pixels`, para elementos com `map_marker_type` definido como `circle` ou `circle_and_icon`.
`map_marker_color_mode`	Especifica se a cor dos marcadores do mapa é fixa ou se as cores são atribuídas dinamicamente aos marcadores com base nos valores da consulta subjacente.
`map_marker_color`	Especifica uma única cor para aplicar a todos os marcadores de mapa, para elementos com `map_marker_color_mode` definido como `fixed`.
Parâmetros de valor
`map_value_colors`	Especifica as cores dos pontos do mapa ou define o intervalo de cores a ser usado se você estiver codificando por cores de acordo com uma medida.
`quantize_map_value_colors`	Muda a escala de cores de um gradiente suave para apenas as cores específicas que você definiu.
`reverse_map_value_colors`	Alterna as cores que indicam valores altos e baixos no gráfico, invertendo o gradiente de cor.
`map_value_scale_clamp_min`	Define o valor mínimo do intervalo de cores.
`map_value_scale_clamp_max`	Define o valor máximo do intervalo de cores

Parâmetros básicos

Ao definir um elemento de dashboard do LookML, é preciso especificar valores para pelo menos os parâmetros básicos name e type. Outros parâmetros básicos, como title, height e width, afetam a aparência e a posição de um elemento em um painel.

`name`

Esta seção se refere ao parâmetro name que faz parte de um elemento do dashboard.

name também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

Cada declaração name cria um novo elemento do dashboard e atribui um nome a ele. Os nomes dos elementos precisam ser exclusivos. Às vezes, os nomes são referenciados no parâmetro elements quando você usa painéis layout: grid ou no parâmetro group de elementos filhos ao organizar elementos em um grupo de blocos (type: group).

- name: orders_by_date

`title`

Esta seção se refere ao parâmetro title que faz parte de um elemento do dashboard.

title também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

title também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

O parâmetro title permite mudar como o nome de um elemento aparece para os usuários. Se não for especificado, o título padrão será o elemento name.

Por exemplo,

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

Se você usasse esse formato, em vez de o elemento aparecer como Visão geral de vendas, ele apareceria como 1) Visão geral de vendas.

`type`

Esta seção se refere ao parâmetro type que faz parte de um elemento do dashboard.

type também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

type também pode ser usado como parte de uma mesclagem, descrita na página de documentação do parâmetro type (para mesclagens).

type também pode ser usado como parte de uma dimensão, descrita na página de documentação Tipos de dimensão, filtro e parâmetro.

type também pode ser usado como parte de uma medida, descrita na página de documentação Tipos de medida.

O parâmetro type determina o tipo de visualização que será usado no 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

Consulte a página de documentação type (para dashboards do LookML) para uma visão geral dos diferentes tipos de elementos de dashboard do LookML.

`height`

Esta seção se refere ao parâmetro height que faz parte de um elemento do dashboard.

height também pode ser usado como parte de uma linha do painel, descrita na página de documentação Parâmetros do painel.

Para painéis com layouts `tile` ou `static`

O parâmetro height define a altura de um elemento, em unidades de tile_size (definido em pixels), para dashboards layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e height: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Para painéis com layout `newspaper`

O parâmetro height define a altura de um elemento, em unidades de linha, para dashboards layout: newspaper.

Um painel com layout de jornal tem como padrão uma altura de elemento de 6 linhas, ou cerca de 300 pixels. A altura mínima é de 1 linha para painéis com um parâmetro preferred viewer definido como dashboards-next. A altura mínima é de duas linhas para dashboards com um parâmetro preferred viewer definido como dashboards.

Por exemplo, o código a seguir define um elemento com 12 linhas de altura, ou o dobro da altura de outros elementos definidos como padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`width`

Esta seção se refere ao parâmetro width que faz parte de um elemento do dashboard.

width também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

O parâmetro width define a largura de um elemento, em unidades de tile_size, para dashboards layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e width: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de largura.

- dashboard: sales_overview
  tile_size: 100
  ...

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

O parâmetro width define a largura de um elemento, em unidades de colunas, para dashboards layout: newspaper.

Um painel com layout de jornal tem uma largura padrão de 24 colunas.

Por exemplo, o código a seguir define o elemento como metade da largura do painel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`top`

O parâmetro top define a posição de cima para baixo de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e top: 4, posicionando a borda superior do elemento orders_by_date a 400 pixels da parte de cima do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

`left`

O parâmetro left define a posição da esquerda para a direita de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e left: 4, posicionando a borda esquerda do elemento orders_by_date a 400 pixels do lado esquerdo do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

`row`

Para painéis layout: newspaper, o parâmetro row define a linha em que a borda superior de um elemento é colocada. Se o elemento for colocado dentro de um grupo de blocos usando o parâmetro group, row vai definir a posição da linha do elemento em relação à parte de cima do contêiner do grupo (row: 0).

Um painel começa com a linha 0 na parte de cima. Um dashboard com layout de jornal tem como padrão uma altura de elemento de 6 linhas, o que significa que os elementos do dashboard na parte de cima de um dashboard (row: 0) ocupam as linhas de 0 a 5 por padrão.

Cada linha tem 50 pixels de altura, o que significa que a altura padrão do elemento de 6 linhas é de 300 pixels.

Por exemplo, o código a seguir define um elemento na segunda linha de elementos do painel, supondo que os elementos estejam definidos com a altura padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`col`

Para dashboards layout: newspaper, o parâmetro col define a coluna em que a borda esquerda do elemento é colocada. Se o elemento for colocado dentro de um grupo de blocos usando o parâmetro group, col vai definir a posição da coluna do elemento em relação à borda esquerda do contêiner do grupo (col: 0).

Os painéis são divididos em 24 colunas. Um painel começa com a coluna 0 à esquerda. Um dashboard com layout de jornal tem como padrão uma largura de elemento de 8 colunas, o que significa que os elementos do dashboard à esquerda de um dashboard (col: 0) ocupam as colunas de 0 a 7.

Por exemplo, o código a seguir define um elemento para ser colocado na terceira coluna de elementos no painel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

`refresh`

Esta seção se refere ao parâmetro refresh que faz parte de um elemento do dashboard.

refresh também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

O parâmetro refresh permite que um elemento seja recarregado automaticamente de forma periódica, recuperando dados atualizados. Isso costuma ser útil em configurações em que um painel é exibido constantemente, como em uma TV de escritório. O painel precisa estar aberto em uma janela do navegador para que esse parâmetro tenha efeito. Essa configuração não é executada em segundo plano para "pré-aquecer" o cache do painel.

A taxa de atualização pode ser qualquer número (sem decimais) de segundos, minutos, horas ou dias. Exemplo:

- name: orders_by_date
  refresh: 2 hours

Tenha cuidado ao definir intervalos de atualização curtos. Se a consulta por trás do elemento exigir muitos recursos, alguns elementos poderão sobrecarregar o banco de dados mais do que o desejado.

`note`

Você pode adicionar notas descritivas a elementos como este:

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

note tem os subparâmetros text, state e display.

`text`

O subparâmetro text especifica o texto exibido na observação. O texto pode ser localizado.

`state`

O subparâmetro state determina se a nota será collapsed ou expanded se for muito grande para caber em uma única linha dentro da largura do elemento. Se você escolher collapsed e a nota for muito longa, ela vai terminar com reticências clicáveis (...) que podem ser usadas para ler a nota completa.

`display`

O subparâmetro display determina onde a nota é exibida em um elemento. above coloca a nota na parte de cima de um elemento, below coloca na parte de baixo e hover exige que o usuário passe o mouse sobre o elemento para ver a nota.

Parâmetros de consulta

Ao definir um elemento de dashboard do LookML, é preciso especificar valores para pelo menos os parâmetros de consulta model e explore.

Para elementos de dashboard do LookML de type: looker_google_map, também é necessário especificar pelo menos um campo geográfico como o valor do parâmetro dimensions ou fields. Um campo geográfico pode ser um dos seguintes:

Uma dimensão baseada em dados de latitude e longitude, definida no LookML como uma dimensão de type: location.
Uma dimensão com uma camada do mapa atribuída. Os desenvolvedores de LookML podem adicionar uma camada do mapa integrada ou uma camada do mapa personalizada a uma medição usando o parâmetro map_layer_name.
Uma dimensão de CEP. As regiões de CEP são baseadas nas áreas de tabulação de CEP (ZCTAs, na sigla em inglês) de 2010. Se você estiver visualizando códigos postais, talvez não haja uma correspondência de um para um entre eles e as ZCTAs usadas para visualizações de mapa. Por isso, é possível que nem todos os pontos sejam mostrados no mapa.

Também é possível usar os outros parâmetros de consulta descritos a seguir para controlar como os dados são exibidos em um elemento do dashboard. Para mais informações sobre os requisitos para criar um gráfico de mapa interativo com a interface do Looker, consulte a seção Como criar um gráfico do Google Maps da página de documentação Opções de gráfico de mapa.

`model`

O parâmetro model define o modelo a ser usado para a consulta de elementos. Se não for especificado, o padrão será o modelo em que o painel está.

- name: orders_by_date
  model: ecommerce

O parâmetro model aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de model. Com uma constante, você pode definir o nome de um modelo em um só lugar, o que é muito útil se você estiver atualizando o nome de um modelo usado por vários elementos do dashboard.

Para mais informações e um exemplo de uso de constantes com dashboards do LookML, consulte a página de documentação do parâmetro constant.

`explore`

Esta seção se refere ao parâmetro explore que faz parte de um elemento do dashboard.

explore também pode ser usado como parte de um modelo, descrito na página de documentação do parâmetro explore.

explore também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

O parâmetro explore define a Análise que será usada para a consulta do elemento.

- name: orders_by_date
  explore: order

O parâmetro explore aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de explore. Com uma constante, você pode definir o nome de uma Análise em um só lugar, o que é muito útil se você estiver atualizando o nome de uma Análise usada por vários elementos do dashboard.

Para mais informações e um exemplo de uso de constantes com dashboards do LookML, consulte a página de documentação do parâmetro constant.

`fields`

O parâmetro fields define os campos a serem usados na consulta de elementos. Use a sintaxe view_name.dimension_name para especificar os 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]

Se você usar o parâmetro fields, não será necessário usar os parâmetros dimensions e measures.

`dimensions`

O parâmetro dimensions define as dimensões que serão usadas na consulta de elementos. Use a sintaxe view_name.dimension_name para especificar a dimensão. Não inclua dimensions se a consulta não tiver nenhum.

## 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`

O parâmetro measures define as medidas que serão usadas na consulta de elemento. Use a sintaxe view_name.measure_name para especificar a métrica. Não inclua measures se a consulta não tiver nenhum.

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

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

`sorts`

O parâmetro sorts define o comportamento de classificação para a consulta do elemento. Liste primeiro o campo de classificação principal, seguido pelos campos secundários. Use a sintaxe view_name.field_name para especificar a dimensão ou medida pela qual classificar.

Se você omitir o parâmetro sorts, o elemento vai usar a ordem de classificação padrão do Looker. As classificações crescentes não exigem um sufixo, enquanto as decrescentes exigem o sufixo desc.

O exemplo a seguir define uma única classificação:

- name: orders_by_date
  sorts: order.order_date desc

O exemplo a seguir define várias classificações:

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

Se você dinamizar as dimensões, poderá classificar os resultados da consulta especificando o nome da medida, a direção da classificação e o número do índice baseado em 0 da coluna de destino na tabela de dados. Por exemplo, o elemento a seguir classifica pela primeira coluna dinâmica usando o índice 0:

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

Para classificar pelo total da linha, especifique o índice da coluna de totais. Por exemplo, o elemento a seguir classifica pelo total da linha usando o índice 2, que representa a coluna de totais de uma consulta com duas colunas dinâmicas:

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

`pivots`

O parâmetro pivots define as dimensões que precisam ser dinamizadas para a consulta de elemento. Use a sintaxe view_name.dimension_name para especificar a dimensão. Não inclua pivots se a consulta não tiver nenhum.

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

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

`limit`

O parâmetro limit define o limite de linhas que deve ser usado para a consulta de elementos. O limite se aplica ao número de linhas antes da aplicação de qualquer tabela dinâmica.

- name: orders_by_date
  limit: 100

`column_limit`

O parâmetro column_limit define o limite de colunas que deve ser usado para a consulta de elementos. O limite se aplica ao número de colunas depois que as tabelas dinâmicas são aplicadas.

- name: orders_by_date
  column_limit: 100

`filters`

Esta seção se refere ao parâmetro filters que faz parte de um elemento do dashboard.

filters também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

filters também pode ser usado como parte de uma medição, descrita na página de documentação do parâmetro filters.

O parâmetro filters define os filtros não alteráveis que devem ser usados para a consulta do elemento. Se você quiser filtros que um usuário possa alterar no painel, configure-os usando filters para painéis e aplique-os aos elementos usando listen.

A sintaxe de filters é:

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

Cada filtro pode aceitar uma expressão de filtro do Looker ou uma constante de valor. Também é possível usar as variáveis líquidas _localization ou _user_attributes na expressão de filtro para valores de filtro flexíveis.

`listen`

Com os filtros de dashboard, os leitores podem refinar de forma interativa os dados mostrados nos elementos do dashboard. Defina filtros de dashboard com o parâmetro filters para dashboards do LookML. Em seguida, use o parâmetro listen para vincular elementos do dashboard ao filtro.

A sintaxe de listen é a seguinte:

- 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

Adicione o parâmetro listen a um elemento e, em seguida, forneça o nome do filtro seguido por dois-pontos e uma referência ao campo ao qual o filtro deve ser aplicado, usando a sintaxe view_name.field_name. Por exemplo, você pode criar um filtro chamado Data que exige que o usuário insira uma data no campo de filtro na UI. Em seguida, você pode aplicar o valor inserido pelo usuário ao elemento orders_by_date desta forma:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Se o filtro que está sendo ouvido estiver configurado com o parâmetro vis_filter: true, o controle de filtro vai aparecer em uma barra de filtro diretamente na parte de cima do bloco de visualização, em vez de na barra de filtro do painel na parte de cima.

Para mais exemplos de como usar os parâmetros filters e listen para aplicar filtros de dashboard a elementos individuais, consulte Como criar dashboards do LookML.

`query_timezone`

O parâmetro query_timezone especifica o fuso horário em que a consulta será executada. As opções de fuso horário são mostradas na página de documentação Valores para timezone. Se você quiser que a consulta seja executada usando o fuso horário do espectador, atribua o valor como user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Parâmetros de plotagem

Os parâmetros descritos nesta seção correspondem às opções na seção Gráfico do editor de visualização para gráficos de mapa.

Os parâmetros que você pode usar com um elemento de type: looker_google_map dependem se a consulta inclui uma dimensão de type: location ou tem uma camada do mapa associada a ela.

`map_plot_mode`

O parâmetro map_plot_mode define como os dados são representados em um elemento type: looker_google_map com base em uma dimensão de type: location. Esse parâmetro não está disponível para mapas baseados em uma dimensão com uma camada do mapa associada ou para dimensões de CEP. O parâmetro map_plot_mode aceita os seguintes valores:

points
automagic_heatmap
heatmap
lines
areas

`points`

Definir map_plot_mode como points plota cada linha na tabela de dados como um ponto discreto no mapa.

Uma dimensão de type: location por si só coloca pontos de tamanho e cor uniformes no mapa. Adicionar uma medida à consulta permite que os pontos sejam dimensionados por cor ou tamanho usando os parâmetros map_marker_radius_mode e map_marker_color_mode.

`automagic_heatmap`

Definir map_plot_mode como automagic_heatmap mostra os dados na consulta subjacente como uma grade de mapa de calor. Ele divide o mapa visível em quadrados iguais e calcula quais valores dos seus dados se encaixam em cada quadrado. Os quadrados são coloridos de acordo com uma métrica que você escolhe. Aumentar ou diminuir o zoom desse mapa faz com que o Looker recalcule a grade para que a granularidade seja adequada ao nível de zoom.

Sua consulta precisa incluir uma dimensão de type: location e uma medição para que esse tipo de gráfico funcione corretamente.

`heatmap`

Definir map_plot_mode como heatmap produz um mapa que pode mostrar uma grande quantidade de dados de local com muitos pontos agrupados. A intensidade e a escala de cores mostram a concentração de pontos de dados em cada área.

Sua consulta precisa incluir uma dimensão de type: location. Se quiser, adicione uma medida.

`lines`

Definir map_plot_mode como lines usa duas dimensões de type: location da sua consulta e as conecta na visualização. Adicionar uma medida à consulta permite adicionar uma escala de cores às linhas.

`areas`

Definir map_plot_mode como areas usa uma dimensão de type: location e conecta todos os pontos na ordem em que você os classificou. Isso forma os limites de uma área no elemento do mapa. Adicionar uma medida à consulta permite formatar o tamanho e a cor dos pontos de localização individuais que compõem os limites da área.

`heatmap_gridlines`

Para elementos de mapa de calor, definir heatmap_gridlines como true adiciona uma borda ao redor de cada uma das linhas de grade usadas para o mapa de calor. Esse parâmetro está disponível quando você está traçando uma dimensão de type: location com map_plot_mode definido como automagic_heatmap ou quando está traçando uma dimensão de código postal ou uma dimensão com uma camada do mapa associada.


heatmap_gridlines: true | false

`heatmap_gridlines_empty`

Quando heatmap_gridlines é definido como true para elementos do mapa de calor e você está traçando dados com um map_layer definido, definir heatmap_gridlines_empty como true mostra um contorno ao redor das regiões do mapa que não têm dados associados.


heatmap_gridlines_empty: true | false

`heatmap_opacity`

Para elementos de mapa de calor, use heatmap_opacity para especificar a opacidade das cores usadas no mapa. Especifique um número decimal entre 0 e 1 como o valor de heatmap_opacity, em que 0 significa sem cor e 1 significa totalmente opaco.


heatmap_opacity: 0.5

Parâmetros de mapa

A maioria dos parâmetros descritos nesta seção corresponde às opções na seção Opções do menu de mapa do editor de visualização para gráficos de colunas.

`map_tile_provider`

Disponível para todos os mapas, o parâmetro map_tile_provider permite mudar o tipo de mapa de fundo e especificar se os rótulos (como cidades e ruas) são mostrados.

light: mapa sutil e de cores claras, projetado para fornecer contexto geográfico e destacar seus dados.
light_no_labels: igual a light, mas o mapa omite rótulos como nomes de cidades.
dark: mapa sutil e de cor escura, projetado para fornecer contexto geográfico e destacar seus dados.
dark_no_labels: igual a dark, mas o mapa omite rótulos como nomes de cidades.
satellite_streets: mapa que mostra imagens aéreas e de satélite globais
satellite: igual a satellite_streets, mas o mapa omite rótulos como nomes de cidades.
streets: mapa de uso geral que enfatiza o estilo legível de redes de transporte público e rodoviárias.
outdoors: mapa de uso geral adaptado para caminhadas, ciclismo e outras atividades ao ar livre
traffic_day: mapa de cores claras que destaca as redes de transporte público e as vias, incluindo informações de trânsito em tempo real.
traffic_night: mapa de cor escura que destaca as redes de transporte público e as vias, incluindo informações de trânsito em tempo real.
minimal: mapa de cores claras sem rótulos ou linhas de limite


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

`map_position`

Use o parâmetro map_position para definir o ponto central e o nível de zoom do mapa visível. Há duas opções para especificar essa posição:

fit_data: centraliza e aumenta o zoom do mapa automaticamente para que todos os pontos de dados da consulta fiquem visíveis.
custom: permite especificar manualmente a latitude, a longitude e o nível de zoom usando os parâmetros map_latitude, map_longitude e map_zoom.


map_position: fit_data | custom

`map_latitude`

O parâmetro map_latitude especifica a latitude de um elemento do mapa com map_position definido como custom.


map_latitude: -5.804047131379801

`map_longitude`

O parâmetro map_longitude especifica a longitude de um elemento do mapa com map_position definido como custom.


 map_longitude: 113.34732055664064

`map_zoom`

O parâmetro map_zoom permite especificar o nível de zoom de um elemento do mapa com map_position definido como custom. Números maiores criam um nível de zoom mais próximo.


map_zoom: 10

`map_scale_indicator`

Definido como 'off' por padrão, o parâmetro map_scale_indicator permite especificar se uma escala de mapa é mostrada e definir os tipos de unidades que são exibidos.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

`map_pannable`

O parâmetro map_pannable especifica se os usuários podem reposicionar o mapa arrastando-o. Esta opção é ativada por padrão.


map_pannable: true | false

`map_zoomable`

O parâmetro map_zoomable especifica se os usuários podem aumentar e diminuir o zoom no elemento do mapa. Esta opção é ativada por padrão.


map_zoomable: true | false

`show_view_names`

O parâmetro show_view_names especifica se o nome da visualização será mostrado com o nome do campo nas dicas de mapa, que aparecem quando os usuários clicam nos pontos de dados do mapa.


show_view_names: true | false

`show_legend`

Especifique se uma legenda de mapa deve ser exibida no canto inferior direito da visualização. A legenda mostra a escala de cores que você está usando, se você adicionou uma medida à visualização.

O parâmetro show_legend fica disponível quando as seguintes opções de gráfico são especificadas:

Quando map_plot_mode foi definido como automagic_heatmap
Quando map_plot_mode foi definido como points e map_marker_color_mode está definido como value


show_legend: true | false

`show_region_field`

Para mapas baseados em uma camada do mapa ou código postal, o parâmetro show_region_field mostra as informações na dica do mapa. Os usuários podem clicar em um ponto no mapa para ver o nome da região.


show_region_field: true | false

`draw_map_labels_above_data`

Para mapas de camada do mapa ou baseados em uma dimensão de código postal, use o parâmetro draw_map_labels_above_data para mostrar os rótulos do mapa acima ou abaixo do mapa de calor. Isso é especialmente significativo com valores de opacidade mais altos do mapa de calor. Se o mapa de calor for opaco, os rótulos não vão aparecer, a menos que sejam exibidos acima dos dados.


draw_map_labels_above_data: true | false

Parâmetros de ponto

As opções de ponto não estão disponíveis para mapas com map_plot_mode definido como automagic_heatmap ou heatmap.

`map_marker_type`

Para mapas baseados em uma dimensão de local e com map_plot_mode definido como points, lines ou areas, o parâmetro map_marker_type define o tipo de ponto mostrado no elemento do mapa. O parâmetro map_marker_type aceita os seguintes valores:

circle
icon
circle_and_icon
none

O valor especificado para map_marker_type afeta os parâmetros disponíveis para formatar os pontos mostrados no mapa.

`map_marker_icon_name`

Se map_marker_type estiver definido como icon ou circle_and_icon, use o parâmetro map_marker_icon_name para definir o tipo de ícone que vai aparecer em todos os marcadores do 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`

Para mapas com map_marker_type definido como circle ou circle_and_icon, use o parâmetro map_marker_radius_mode para definir os tamanhos dos círculos de acordo com as seguintes opções:

proportional_value: essa opção ajusta o tamanho relativo dos círculos de acordo com as medidas que você adicionou à consulta. Você pode usar os parâmetros map_marker_radius_min e map_marker_radius_max com essa opção para definir um raio mínimo e máximo para os círculos. Também é possível usar o parâmetro map_marker_proportional_scale_type para definir se uma escala linear ou logarítmica é usada para dimensionar os círculos.
equal_to_value: essa configuração ajusta o raio dos círculos de acordo com os valores de medição reais na consulta subjacente.
fixed: essa opção permite definir um raio fixo para aplicar a todos os marcadores do mapa usando o parâmetro map_marker_radius_fixed. O valor padrão é 500.


map_marker_radius_mode: proportional_value | equal_to_value | fixed

`map_marker_radius_fixed`

Quando map_marker_radius_mode é definido como fixed e map_marker_type é definido como circle ou circle_and_icon, é possível usar o parâmetro map_marker_radius_fixed para definir um raio fixo que se aplica a todos os marcadores do mapa.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

`map_marker_radius_min`


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

`map_marker_radius_max`


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

`map_marker_proportional_scale_type`

Para mapas com map_marker_type definido como circle ou circle_and_icon e map_marker_radius_mode definido como proportional_value, use o parâmetro map_marker_proportional_scale_type para definir o tamanho do círculo com base em uma escala linear ou logarítmica. O valor desse parâmetro pode ser linear ou log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

`map_marker_units`

Para mapas com map_marker_type definido como circle ou circle_and_icon, use o parâmetro map_marker_units para definir as unidades usadas no raio de um círculo como meters ou pixels.


map_marker_units: meters | pixels

`map_marker_color_mode`

Use map_marker_color_mode para definir as cores dos marcadores do mapa:

Se map_marker_color_mode for definido como value, as cores serão atribuídas dinamicamente aos marcadores com base nos valores da consulta. Use parâmetros de valor para configurar as cores na legenda dessa opção.
Se map_marker_color_mode for definido como fixed, use o parâmetro map_marker_color para definir uma única cor para todos os marcadores do mapa.

`map_marker_color`

Quando map_marker_color_mode é definido como fixed, map_marker_color_mode define uma única cor para todos os marcadores do mapa. O valor da cor pode ser formatado como uma string hexadecimal RGB, como 2ca6cd, ou como um nome de cor CSS, como mediumblue.


map_marker_color: [mediumblue]

Parâmetros de valor

Use esses parâmetros para configurar as cores que serão atribuídas dinamicamente aos marcadores com base nos valores da consulta quando map_marker_color_mode estiver definido como value ou para elementos do mapa com map_plot_mode definido como automagic_heatmap, heatmap lines ou areas.

`map_value_colors`

Use o parâmetro map_value_colors para definir a cor dos pontos do mapa ou, se estiver usando um código de cores de acordo com uma métrica, para definir o intervalo de cores a ser usado. Você pode inserir uma lista de strings hexadecimais, como #2ca6cd, ou nomes de cores CSS, como mediumblue. As cores listadas primeiro são associadas aos valores mais baixos.


map_value_colors: [green, mediumblue]

`quantize_map_value_colors`

Quando definido como true, quantize_map_value_colors muda a escala de cores de um gradiente suave para apenas as cores específicas que você definiu. Esse parâmetro é definido como false por padrão.


quantize_map_value_colors: true | false

`reverse_map_value_colors`

Quando definido como true, o parâmetro reverse_map_value_colors alterna as cores que indicam valores altos e baixos no gráfico, invertendo o gradiente de cor.


reverse_map_value_colors: true | false

`map_value_scale_clamp_min`

Use o parâmetro map_value_scale_clamp_min para definir o valor mínimo do intervalo de cores. Isso permite codificar por cores todos os pontos abaixo de um determinado limite (o número especificado) com a cor mais baixa especificada com o parâmetro map_value_colors. Por padrão, o valor mínimo aplicado à legenda é o valor mínimo da consulta.


map_value_scale_clamp_min: 1000

`map_value_scale_clamp_max`

Use o parâmetro map_value_scale_clamp_max para definir o valor máximo do intervalo de cores. Assim, você pode codificar por cores todos os pontos acima do número especificado com a cor mais alta definida com o parâmetro map_value_colors. Por padrão, o valor máximo aplicado à legenda é o valor máximo da consulta.


map_value_scale_clamp_max: 50000

Parâmetros do Google Maps para dashboards do LookML Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Exemplo de uso

Definições de parâmetro

Parâmetros básicos

name

title

type

height

Para painéis com layouts tile ou static

Para painéis com layout 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 plotagem

map_plot_mode

points

automagic_heatmap

heatmap

lines

areas

heatmap_gridlines

heatmap_gridlines_empty

heatmap_opacity