Mapper les paramètres pour les tableaux de bord LookML

Cette page décrit les paramètres permettant de créer et de modifier les éléments de tableau de bord LookML de type: looker_map avec les paramètres de tableau de bord LookML dans un fichier dashboard.lkml.

Pour savoir comment créer un graphique cartographique interactif dans l'interface utilisateur Looker, consultez la page de documentation Options du graphique cartographique. Pour en savoir plus sur les types de champs requis pour créer un graphique cartographique interactif, consultez la section Paramètres de requête.

Exemple d'utilisation

Un N indique qu'une valeur numérique est requise. Les guillemets simples indiquent un texte descriptif et ne doivent pas être inclus dans le code en direct.


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_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 | lines | areas
heatmap_gridlines: true | false
heatmap_gridlines_empty: true | false
heatmap_opacity: '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
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

Définition des paramètres

Nom du paramètre Description
Paramètres de base
name (pour les éléments) Crée un élément.
title (pour les éléments) Modifie la façon dont le nom d'un élément s'affiche pour les utilisateurs
type (pour les éléments) Détermine le type de visualisation à utiliser dans l'élément.
height (pour les éléments) Définit la hauteur d'un élément en unités tile_size pour les tableaux de bord layout: tile et layout: static
width (pour les éléments) Définit la largeur d'un élément en unités tile_size pour les tableaux de bord layout: tile et layout: static
top Définit la position de haut en bas d'un élément en unités tile_size pour les tableaux de bord layout: static
left Définit la position de gauche à droite d'un élément en unités tile_size pour les tableaux de bord layout: static.
row Définit la position de haut en bas d'un élément en nombre de lignes pour les tableaux de bord layout: newspaper
col Définit la position de gauche à droite d'un élément en unités de colonnes pour les tableaux de bord layout: newspaper
refresh (pour les éléments) Définit l'intervalle auquel l'élément est automatiquement actualisé
note Marque le début d'une section de code LookML pour définir une note pour un élément. Ce paramètre comporte les sous-paramètres text, state et display.
Paramètres de requête
model Définit le modèle à utiliser pour la requête de l'élément
explore (pour les éléments) Définit l'exploration à utiliser pour la requête de l'élément.
fields Définit les champs à utiliser pour la requête de l'élément. Vous pouvez l'utiliser à la place de dimensions et measures.
dimensions Définit les dimensions à utiliser pour la requête de l'élément
measures Définit les mesures à utiliser pour la requête de l'élément.
sorts Définit les tris à utiliser pour la requête de l'élément
pivots Définit les dimensions à pivoter pour être utilisées pour la requête de l'élément
limit Définit la limite de lignes à utiliser pour la requête de l'élément
column_limit Définit la limite de colonnes à utiliser pour la requête de l'élément
filters (pour les éléments) Définit les filtres qui ne peuvent pas être modifiés pour la requête de l'élément.
listen Définit les filtres qui peuvent être modifiés pour la requête de l'élément, si des filters (pour le tableau de bord) ont été créés.
query_timezone Définit le fuseau horaire à utiliser lors de l'exécution de la requête.
Paramètres du graphique
map_plot_mode Définit la manière dont vos données de localisation sont représentées sur un élément de type: looker_map.
heatmap_gridlines Ajoute une bordure autour de chacune des lignes de la grille utilisées pour un élément de carte de densité
heatmap_gridlines_empty Pour les cartes de densité dont le paramètre heatmap_gridlines est défini sur true, affiche un contour autour des régions de la carte qui ne sont associées à aucune donnée.
heatmap_opacity Définit l'opacité des couleurs utilisées dans une carte de densité
Paramètres de la carte
map_tile_provider Définit le type de carte de fond et indique si les libellés de carte sont affichés.
map_position Définit le point central et le niveau de zoom de la carte visible
map_latitude Définit la latitude d'une carte dont map_position est défini sur custom
map_longitude Définit la longitude d'une carte dont map_position est défini sur custom.
map_zoom Définit le zoom d'une carte avec map_position défini sur custom
map_scale_indicator Définit si une échelle de carte doit être affichée et le type d'unités à afficher
map_pannable Définit si les utilisateurs peuvent repositionner la carte en la faisant glisser.
map_zoomable Détermine si les utilisateurs peuvent faire un zoom avant ou arrière sur la carte.
show_view_names Indique s'il faut afficher le nom de la vue avec le nom du champ dans les info-bulles de la carte.
show_legend Indique si une légende de carte doit s'afficher en bas à droite de la visualisation.
show_region_field Indique s'il faut afficher les informations sur la région dans l'info-bulle de la carte.
draw_map_labels_above_data Affiche les libellés de la carte au-dessus ou en dessous de la carte de densité.
Paramètres de point
map_marker_type Spécifie le type de point affiché sur la carte pour les éléments dont map_plot_mode est défini sur points, lines ou areas.
map_marker_icon_name Spécifie le type d'icône à afficher sur tous les repères de carte pour les éléments dont map_marker_type est défini sur icon ou circle_and_icon.
map_marker_radius_mode Définit la façon dont les cercles sont dimensionnés pour les éléments dont map_marker_type est défini sur circle ou circle_and_icon.
map_marker_radius_fixed Définit un rayon fixe à appliquer à tous les repères de carte, pour les éléments dont map_marker_type est défini sur circle ou circle_and_icon et map_marker_radius_mode est défini sur fixed.
map_marker_radius_min Définit le rayon minimal des cercles pour les éléments dont map_marker_radius_mode est défini sur proportional_value.
map_marker_radius_max Définit le rayon maximal des cercles pour les éléments dont map_marker_radius_mode est défini sur proportional_value.
map_marker_proportional_scale_type Indique si la taille du cercle est basée sur une échelle linéaire ou logarithmique, pour les éléments dont map_marker_type est défini sur circle ou circle_and_icon et map_marker_radius_mode sur proportional_value
map_marker_units Définit les unités utilisées pour le rayon d'un cercle sur meters ou pixels, pour les éléments dont map_marker_type est défini sur circle ou circle_and_icon
map_marker_color_mode Indique si la couleur des repères de la carte est fixe ou si elle est attribuée de manière dynamique en fonction des valeurs de la requête sous-jacente.
map_marker_color Spécifie une seule couleur à appliquer à tous les repères de carte, pour les éléments dont map_marker_color_mode est défini sur fixed.
Paramètres de valeur
map_value_colors Spécifie les couleurs des points de la carte ou définit la plage de couleurs à utiliser si vous utilisez un code couleur en fonction d'une mesure.
quantize_map_value_colors Remplace le dégradé de couleurs par les couleurs spécifiques que vous avez définies.
reverse_map_value_colors Inverse le dégradé de couleurs en échangeant les couleurs qui indiquent les valeurs élevées et faibles sur le graphique.
map_value_scale_clamp_min Définit la valeur minimale de la plage de couleurs.
map_value_scale_clamp_max Définit la valeur maximale de la plage de couleurs.

Paramètres de base

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres de base name et type. D'autres paramètres de base, tels que title, height et width, affectent l'apparence et la position d'un élément sur un tableau de bord.

name

Cette section fait référence au paramètre name qui fait partie d'un élément de tableau de bord.

name peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Chaque déclaration name crée un élément de tableau de bord et lui attribue un nom. Les noms des éléments doivent être uniques. Les noms sont parfois référencés dans le paramètre elements lorsque vous utilisez des tableaux de bord layout: grid.

- name: orders_by_date

title

Cette section fait référence au paramètre title qui fait partie d'un élément de tableau de bord.

title peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

title peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre title vous permet de modifier la façon dont le nom d'un élément s'affiche pour les utilisateurs. Si aucun titre n'est spécifié, le titre par défaut est l'élément name.

Considérez l'exemple suivant :

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

Si vous avez utilisé ce format, l'élément Aperçu des ventes s'affichera 1) Aperçu des ventes.

type

Cette section fait référence au paramètre type qui fait partie d'un élément de tableau de bord.

type peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

type peut également être utilisé dans une jointure, comme décrit sur la page de documentation du paramètre type (pour les jointures).

type peut également être utilisé dans une dimension, comme décrit sur la page de documentation Types de dimensions, de filtres et de paramètres.

type peut également être utilisé dans une mesure, comme décrit sur la page de documentation Types de mesures.

Le paramètre type détermine le type de visualisation à utiliser dans l'élément.

- 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

Pour obtenir une présentation des différents types d'éléments de tableau de bord LookML, consultez la page de documentation type (pour les tableaux de bord LookML).

height

Cette section fait référence au paramètre height qui fait partie d'un élément de tableau de bord.

height peut également être utilisé dans une ligne de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Pour les tableaux de bord avec des mises en page tile ou static

Le paramètre height définit la hauteur d'un élément, en unités tile_size (qui est définie en pixels), pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et height: 4, ce qui définit la hauteur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Pour les tableaux de bord avec une mise en page newspaper

Le paramètre height définit la hauteur d'un élément, en unités row, pour les tableaux de bord layout: newspaper.

La hauteur par défaut des éléments d'un tableau de bord avec une mise en page de type journal est de six lignes, soit environ 300 pixels. La hauteur minimale est d'une ligne pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards-next. La hauteur minimale est de deux lignes pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards.

Par exemple, le code suivant définit un élément sur 12 lignes de hauteur, soit deux fois plus haut que les autres éléments définis sur la valeur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

Cette section fait référence au paramètre width qui fait partie d'un élément de tableau de bord.

width peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre width définit la largeur d'un élément, en unités tile_size, pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et width: 4, ce qui définit la largeur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Le paramètre width définit la largeur d'un élément, en unités de colonnes, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal est défini par défaut sur une largeur de 24 colonnes.

Par exemple, le code suivant définit l'élément sur la moitié de la largeur du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Le paramètre top définit la position de haut en bas d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et top: 4, ce qui positionne le bord supérieur de l'élément orders_by_date à 400 pixels du haut du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Le paramètre left définit la position de gauche à droite d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et left: 4, ce qui positionne le bord gauche de l'élément orders_by_date à 400 pixels du bord gauche du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Pour les tableaux de bord layout: newspaper, le paramètre row définit la ligne sur laquelle le bord supérieur d'un élément est placé.

Un tableau de bord commence par la ligne 0 en haut du tableau de bord. Un tableau de bord avec une mise en page de type journal a une hauteur d'élément par défaut de six lignes. Cela signifie que les éléments de tableau de bord en haut d'un tableau de bord (row: 0) occuperaient par défaut les lignes 0 à 5.

Chaque ligne mesure 50 pixels de haut, ce qui signifie que la hauteur par défaut d'un élément de six lignes est de 300 pixels.

Par exemple, le code suivant définit un élément à placer sur la deuxième ligne d'éléments du tableau de bord, en supposant que les éléments sont définis à la hauteur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Pour les tableaux de bord layout: newspaper, le paramètre col définit la colonne sur laquelle le bord gauche de l'élément est placé.

Les tableaux de bord sont divisés en 24 colonnes. Un tableau de bord commence par la colonne 0 à gauche. Un tableau de bord avec une mise en page de type journal a une largeur d'élément par défaut de huit colonnes. Cela signifie que les éléments de tableau de bord situés à gauche (col: 0) occuperont par défaut les colonnes 0 à 7.

Par exemple, le code suivant définit un élément à définir dans la troisième colonne d'éléments du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

Cette section fait référence au paramètre refresh qui fait partie d'un élément de tableau de bord.

refresh peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre refresh permet à un élément de se recharger automatiquement à intervalles réguliers, ce qui permet de récupérer des données récentes. Cela est souvent utile dans les paramètres où un tableau de bord est constamment affiché, par exemple sur un téléviseur de bureau. Notez que le tableau de bord doit être ouvert dans une fenêtre de navigateur pour que ce paramètre ait un effet. Ce paramètre ne s'exécute pas en arrière-plan pour "pré-remplir" le cache du tableau de bord.

La fréquence d'actualisation peut être n'importe quel nombre (sans décimales) de secondes, de minutes, d'heures ou de jours. Exemple :

- name: orders_by_date
  refresh: 2 hours

Soyez prudent lorsque vous définissez des intervalles d'actualisation courts. Si la requête à l'origine de l'élément est gourmande en ressources, certains éléments peuvent solliciter votre base de données plus que souhaité.

note

Vous pouvez ajouter des notes descriptives à des éléments comme celui-ci :

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

note comporte les sous-paramètres text, state et display.

text

Le sous-paramètre text spécifie le texte affiché dans la note. Le texte peut être localisé.

state

Le sous-paramètre state détermine si la note sera collapsed ou expanded si elle est trop grande pour tenir sur une seule ligne dans la largeur de l'élément. Si vous sélectionnez collapsed et que la note est trop longue, elle se terminera par des points de suspension cliquables (...) qui permettent de lire la note complète.

display

Le sous-paramètre display détermine l'emplacement de la note sur un élément. above place la note en haut d'un élément, below la place en bas d'un élément et hover exige que l'utilisateur pointe sur l'élément pour voir la note.

Paramètres de requête

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres de requête model et explore.

Pour les éléments de tableau de bord LookML de type type: looker_map, vous devez également spécifier au moins un champ géographique comme valeur du paramètre dimensions ou fields. Un champ géographique peut être l'un des suivants :

  • Dimension basée sur des données de latitude et de longitude, définie dans LookML comme dimension de type: location.
  • Dimension à laquelle un calque de carte est attribué. Les développeurs LookML peuvent ajouter un calque de carte intégré ou un calque de carte personnalisé à une mesure à l'aide du paramètre map_layer_name.
  • Dimension "Code postal". Les régions de codes postaux sont basées sur les zones de tabulation des codes postaux (ZCTA) de 2010. Si vous visualisez des codes postaux, il est possible qu'il n'y ait pas de correspondance exacte entre les codes postaux et les ZCTA utilisés pour les visualisations de cartes. Il est donc possible que tous les points ne soient pas visualisés sur la carte.

Vous pouvez utiliser les autres paramètres de requête pour contrôler la façon dont les données sont affichées dans un élément de tableau de bord. Pour en savoir plus sur les exigences à respecter pour créer un graphique cartographique interactif avec l'interface utilisateur Looker, consultez la section Créer un graphique cartographique interactif de la page de documentation Options des graphiques cartographiques.

model

Le paramètre model définit le modèle à utiliser pour la requête d'élément. Si aucune valeur n'est spécifiée, la valeur par défaut est le modèle dans lequel réside le tableau de bord.

- name: orders_by_date
  model: ecommerce

Le paramètre model accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de model. L'utilisation d'une constante vous permet de définir le nom d'un modèle à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'un modèle utilisé par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation de constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

explore

Cette section fait référence au paramètre explore qui fait partie d'un élément de tableau de bord.

explore peut également être utilisé dans un modèle, comme décrit sur la page de documentation du paramètre explore.

explore peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre explore définit l'onglet Explorer à utiliser pour la requête d'élément.

- name: orders_by_date
  explore: order

Le paramètre explore accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de explore. L'utilisation d'une constante vous permet de définir le nom d'une exploration à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'une exploration utilisée par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation de constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

fields

Le paramètre fields définit les champs à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier les champs.

## 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 vous utilisez le paramètre fields, vous n'avez pas besoin d'utiliser les paramètres dimensions et measures.

dimensions

Le paramètre dimensions définit la ou les dimensions à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier la dimension. N'incluez pas dimensions si la requête n'en comporte pas.

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

Le paramètre measures définit la ou les mesures à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.measure_name pour spécifier la mesure. N'incluez pas measures si la requête n'en comporte pas.

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

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

sorts

Le paramètre sorts définit les tris à utiliser pour la requête d'élément. Le tri principal est indiqué en premier, suivi du tri secondaire, et ainsi de suite. Utilisez la syntaxe view_name.field_name pour spécifier la dimension ou la mesure. N'incluez pas sorts si vous souhaitez utiliser l'ordre de tri par défaut de Looker. Les tris par ordre décroissant sont suivis du suffixe desc, tandis que les tris par ordre croissant n'en ont pas besoin.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

pivots

Le paramètre pivots définit les dimensions à pivoter pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier la dimension. N'incluez pas pivots si la requête n'en comporte pas.

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

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

limit

Le paramètre limit définit la limite de lignes à utiliser pour la requête d'élément. Cette limite s'applique au nombre de lignes avant l'application des tableaux croisés dynamiques.

- name: orders_by_date
  limit: 100

column_limit

Le paramètre column_limit définit la limite de colonnes à utiliser pour la requête d'élément. La limite s'applique au nombre de colonnes après l'application des tableaux croisés dynamiques.

- name: orders_by_date
  column_limit: 100

filters

Cette section fait référence au paramètre filters qui fait partie d'un élément de tableau de bord.

filters peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

filters peut également être utilisé dans une mesure, comme décrit sur la page de documentation du paramètre filters.

Le paramètre filters définit les filtres non modifiables à utiliser pour la requête de l'élément. Si vous souhaitez que les utilisateurs puissent modifier les filtres dans le tableau de bord, vous devez les configurer à l'aide de filters pour les tableaux de bord, puis les appliquer aux éléments à l'aide de listen.

La syntaxe de filters est la suivante :

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

Chaque filtre peut accepter une expression de filtre Looker ou une constante de valeur. Vous pouvez également utiliser les variables Liquid _localization ou _user_attributes dans l'expression de filtre pour obtenir des valeurs de filtre flexibles.

listen

Les filtres de tableau de bord permettent aux lecteurs d'affiner de manière interactive les données affichées dans les éléments du tableau de bord. Définissez des filtres de tableau de bord avec le paramètre filters pour les tableaux de bord LookML. Ensuite, utilisez le paramètre listen pour associer les éléments du tableau de bord au filtre du tableau de bord.

Voici la syntaxe à utiliser pour listen :

- 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

Ajoutez le paramètre listen à un élément, puis indiquez le nom du filtre, suivi d'un deux-points et d'une référence au champ auquel le filtre doit s'appliquer, en utilisant la syntaxe view_name.field_name. Par exemple, vous pouvez créer un filtre appelé Date qui demande à l'utilisateur de saisir une date dans le champ de filtre de l'UI. Vous pouvez ensuite appliquer la valeur saisie par l'utilisateur à l'élément orders_by_date comme suit :

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Pour obtenir d'autres exemples d'utilisation des paramètres filters et listen afin d'appliquer des filtres de tableau de bord à des éléments de tableau de bord individuels, consultez Créer des tableaux de bord LookML.

query_timezone

Le paramètre query_timezone spécifie le fuseau horaire dans lequel la requête sera exécutée. Les options de fuseau horaire sont indiquées sur la page de documentation Valeurs pour timezone. Si vous souhaitez que la requête s'exécute en utilisant le fuseau horaire du lecteur, vous pouvez attribuer la valeur user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Paramètres du graphique

Les paramètres décrits dans cette section correspondent aux options de la section Tracé de l'éditeur de visualisations pour les cartes.

Les paramètres que vous pouvez utiliser avec un élément type: looker_map dépendent du fait que votre requête inclut une dimension type: location ou qu'elle est associée à une couche de carte.

map_plot_mode

Le paramètre map_plot_mode définit la façon dont vos données sont représentées sur un élément type: looker_map basé sur une dimension type: location. Ce paramètre n'est pas disponible pour les cartes basées sur une dimension avec une couche de carte associée ni pour les dimensions de code postal. Le paramètre map_plot_mode accepte les valeurs suivantes :

points

Si vous définissez map_plot_mode sur points, chaque ligne du tableau de données sous-jacent est représentée sous forme de point distinct sur la carte.

Une dimension de type: location seule place des points de taille et de couleur uniformes sur la carte. L'ajout d'une mesure à la requête permet de mettre à l'échelle les points par couleur ou par taille à l'aide des paramètres map_marker_radius_mode et map_marker_color_mode.

automagic_heatmap

Si vous définissez map_plot_mode sur automagic_heatmap, les données de la requête sous-jacente s'affichent sous forme de grille de carte de densité. Pour ce faire, elle divise la carte visible en carrés égaux, puis calcule les valeurs de vos données qui correspondent à chaque carré. Les carrés sont colorés en fonction d'une mesure de votre choix. Si vous effectuez un zoom avant ou arrière sur cette carte, Looker recalculera la grille afin que la précision soit adaptée au niveau de zoom.

Pour que ce type de graphique fonctionne correctement, votre requête doit inclure à la fois une dimension type: location et une mesure.

lines

Si vous définissez map_plot_mode sur lines, deux dimensions de type: location de votre requête sont associées dans la visualisation. Ajouter une mesure à votre requête vous permet d'ajouter une échelle de couleurs aux lignes.

areas

Si vous définissez map_plot_mode sur areas, une dimension de type: location est sélectionnée et tous les points sont reliés dans l'ordre dans lequel vous les avez triés. Cela forme les limites d'une zone sur l'élément de carte. L'ajout d'une mesure à la requête vous permet de mettre en forme la taille et la couleur des points individuels qui composent les limites de la zone.

heatmap_gridlines

Pour les éléments de carte de densité, définir heatmap_gridlines sur true ajoute une bordure autour de chacune des lignes de la grille utilisées pour la carte de densité. Ce paramètre est disponible lorsque vous représentez une dimension type: location avec map_plot_mode défini sur automagic_heatmap, ou lorsque vous représentez une dimension de code postal ou une dimension avec un calque de carte associé.


heatmap_gridlines: true | false

heatmap_gridlines_empty

Lorsque heatmap_gridlines est défini sur true pour les éléments de carte de densité, définir heatmap_gridlines_empty sur true affiche un contour autour des régions de la carte qui n'ont aucune donnée associée.


heatmap_gridlines_empty: true | false

heatmap_opacity

Pour les éléments de carte de densité, vous pouvez utiliser heatmap_opacity afin de spécifier l'opacité des couleurs utilisées dans la carte de densité. Spécifiez un nombre compris entre 0 et 1 comme valeur pour heatmap_opacity, où 0 signifie aucune couleur et 1 signifie totalement opaque.


heatmap_opacity: 0.5

Paramètres de la carte

La plupart des paramètres décrits dans cette section correspondent aux options de la section Carte de l'éditeur de visualisations pour les graphiques à barres.

map_tile_provider

Disponible pour toutes les cartes, le paramètre map_tile_provider vous permet de modifier le type de carte de fond et d'indiquer si les libellés de carte (comme les villes et les rues) sont affichés.

  • light : carte subtile et de couleur claire conçue pour fournir un contexte géographique tout en mettant en évidence vos données
  • light_no_labels : identique à light, sauf que la carte omet les libellés tels que les noms de villes.
  • dark : carte subtile de couleur sombre conçue pour fournir un contexte géographique tout en mettant en évidence vos données.
  • dark_no_labels : identique à dark, sauf que la carte omet les libellés tels que les noms de villes.
  • satellite_streets : carte affichant des images satellite et aériennes du monde entier
  • satellite : identique à satellite_streets, sauf que la carte omet les libellés tels que les noms de villes.
  • streets : carte à usage général qui met l'accent sur le style lisible des réseaux routiers et de transport en commun
  • outdoors : carte polyvalente adaptée à la randonnée, au vélo et à d'autres utilisations en extérieur
  • traffic_day : carte de couleur claire mettant en avant les réseaux de transport en commun et les routes, y compris les informations sur le trafic actuel
  • traffic_night : carte de couleur sombre mettant en avant les réseaux de transport en commun et les routes, y compris les informations actuelles sur le trafic

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

map_position

Vous pouvez utiliser le paramètre map_position pour définir le point central et le niveau de zoom de la carte visible. Vous pouvez spécifier cette position de deux manières :

  • fit_data : centre et zoome automatiquement la carte pour que tous les points de données de votre requête soient visibles.
  • custom : vous permet de spécifier manuellement la latitude, la longitude et le niveau de zoom à l'aide des paramètres map_latitude, map_longitude et map_zoom.

map_position: fit_data | custom

map_latitude

Le paramètre map_latitude spécifie la latitude d'un élément de carte dont map_position est défini sur custom.


map_latitude: -5.804047131379801

map_longitude

Le paramètre map_longitude spécifie la longitude d'un élément de carte dont map_position est défini sur custom.


 map_longitude: 113.34732055664064

map_zoom

Le paramètre map_zoom vous permet de spécifier le niveau de zoom d'un élément de carte avec map_position défini sur custom. Plus le nombre est élevé, plus le niveau de zoom est proche.


map_zoom: 10

map_scale_indicator

Défini sur 'off' par défaut, le paramètre map_scale_indicator vous permet d'indiquer si une échelle de carte est affichée et de définir les types d'unités qui sont affichées.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

Le paramètre map_pannable indique si les utilisateurs peuvent repositionner la carte en la faisant glisser. Cette option est activée par défaut.


map_pannable: true | false

map_zoomable

Le paramètre map_zoomable indique si les utilisateurs peuvent faire un zoom avant ou arrière sur l'élément de carte. Cette option est activée par défaut.


map_zoomable: true | false

show_view_names

Le paramètre show_view_names indique s'il faut afficher le nom de la vue avec le nom du champ dans les info-bulles de la carte, qui s'affichent lorsque les utilisateurs cliquent sur les points de données de la carte.


show_view_names: true | false

show_legend

Indiquez si une légende de carte doit s'afficher en bas à droite de la visualisation. La légende affiche l'échelle de couleurs que vous utilisez, si vous avez ajouté une mesure à votre visualisation.

Le paramètre show_legend est disponible lorsque les options de tracé suivantes ont été spécifiées :


show_legend: true | false

show_region_field

Pour les cartes basées sur un calque de carte ou un code postal, le paramètre show_region_field affiche les informations dans l'info-bulle de la carte. Les utilisateurs peuvent cliquer sur un point de la carte pour afficher le nom de la région.


show_region_field: true | false

draw_map_labels_above_data

Pour les cartes de calques ou celles basées sur une dimension de code postal, vous pouvez utiliser le paramètre draw_map_labels_above_data pour afficher les libellés de la carte au-dessus ou en dessous de la carte de densité. Cela est particulièrement important avec des valeurs d'opacité plus élevées pour la carte de densité. Si votre carte de densité est opaque, les libellés ne s'afficheront pas, sauf s'ils sont placés au-dessus des données.


draw_map_labels_above_data: true | false

Paramètres de points

Les options de points ne sont pas disponibles pour les cartes dont map_plot_mode est défini sur automagic_heatmap.

map_marker_type

Pour les cartes basées sur une dimension de localisation et dont map_plot_mode est défini sur points, lines ou areas, le paramètre map_marker_type définit le type de point affiché sur l'élément de carte. Le paramètre map_marker_type accepte les valeurs suivantes :

  • circle
  • icon
  • circle_and_icon
  • none

La valeur que vous spécifiez pour map_marker_type a un impact sur les paramètres disponibles pour la mise en forme des points affichés sur la carte.

map_marker_icon_name

Si map_marker_type est défini sur icon ou circle_and_icon, vous pouvez utiliser le paramètre map_marker_icon_name pour définir le type d'icône à afficher sur tous les repères de la carte.


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

Pour les cartes dont le paramètre map_marker_type est défini sur circle ou circle_and_icon, vous pouvez utiliser le paramètre map_marker_radius_mode pour définir la taille des cercles selon les options suivantes :

  • proportional_value : cette option ajuste la taille relative des cercles en fonction des mesures que vous avez ajoutées à votre requête. Vous pouvez utiliser les paramètres map_marker_radius_min et map_marker_radius_max avec cette option pour définir un rayon minimal et un rayon maximal pour les cercles. Vous pouvez également utiliser le paramètre map_marker_proportional_scale_type pour définir si une échelle linéaire ou logarithmique est utilisée pour dimensionner les cercles.
  • equal_to_value : ce paramètre ajuste le rayon des cercles aux valeurs de mesure réelles dans votre requête sous-jacente.
  • fixed : cette option vous permet de définir un rayon fixe à appliquer à tous les repères de carte à l'aide du paramètre map_marker_radius_fixed. La valeur par défaut est 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

Lorsque map_marker_radius_mode est défini sur fixed et que map_marker_type est défini sur circle ou circle_and_icon, vous pouvez utiliser le paramètre map_marker_radius_fixed pour définir un rayon fixe qui s'applique à tous les repères de la carte.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Pour les cartes dont map_marker_type est défini sur circle ou circle_and_icon et map_marker_radius_mode sur proportional_value, vous pouvez utiliser le paramètre map_marker_radius_min pour définir le rayon minimal d'un cercle.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

Pour les cartes dont map_marker_type est défini sur circle ou circle_and_icon et map_marker_radius_mode sur proportional_value, vous pouvez utiliser le paramètre map_marker_radius_max pour définir le rayon maximal d'un cercle.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

Pour les cartes dont map_marker_type est défini sur circle ou circle_and_icon et map_marker_radius_mode sur proportional_value, vous pouvez utiliser le paramètre map_marker_proportional_scale_type pour définir la taille du cercle en fonction d'une échelle linéaire ou logarithmique. La valeur de ce paramètre peut être linear ou log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

Pour les cartes dont map_marker_type est défini sur circle ou circle_and_icon, vous pouvez utiliser le paramètre map_marker_units pour définir les unités utilisées pour le rayon d'un cercle sur meters ou pixels.


map_marker_units: meters | pixels

map_marker_color_mode

Vous pouvez utiliser map_marker_color_mode pour définir les couleurs des repères de carte :

  • Si map_marker_color_mode est défini sur value, les couleurs sont attribuées dynamiquement aux repères en fonction des valeurs de votre requête sous-jacente. Vous pouvez utiliser des paramètres de valeur pour configurer les couleurs de la légende pour cette option.
  • Si map_marker_color_mode est défini sur fixed, vous pouvez utiliser le paramètre map_marker_color pour définir une seule couleur à utiliser pour tous les repères de carte. La valeur de couleur peut être mise en forme sous la forme d'une chaîne hexadécimale RVB, comme 2ca6cd, ou sous la forme d'un nom de couleur CSS, comme mediumblue.

map_marker_color

Lorsque map_marker_color_mode est défini sur fixed, définissez une seule couleur à utiliser pour tous les repères de la carte.


map_marker_color: [mediumblue]

Paramètres de valeur

Vous pouvez utiliser ces paramètres pour configurer les couleurs qui seront attribuées dynamiquement aux repères en fonction des valeurs de votre requête sous-jacente lorsque map_marker_color_mode est défini sur value, ou pour les éléments de carte avec map_plot_mode défini sur automagic_heatmap, lines ou areas.

map_value_colors

Vous pouvez utiliser le paramètre map_value_colors pour définir la couleur des points de la carte ou, si vous utilisez un code couleur en fonction d'une mesure, pour définir la plage de couleurs à utiliser. Vous pouvez saisir une liste de chaînes hexadécimales, telles que #2ca6cd, ou des noms de couleurs CSS, tels que mediumblue. Les couleurs que vous listez en premier sont associées aux valeurs les plus basses.


map_value_colors: [green, mediumblue]

quantize_map_value_colors

Lorsque la valeur est définie sur true, quantize_map_value_colors remplace le dégradé de couleurs par les couleurs spécifiques que vous avez définies. Ce paramètre est défini sur false par défaut.


quantize_map_value_colors: true | false

reverse_map_value_colors

Lorsque le paramètre reverse_map_value_colors est défini sur true, il inverse le dégradé de couleurs, en échangeant les couleurs qui indiquent les valeurs élevées et faibles sur le graphique.


reverse_map_value_colors: true | false

map_value_scale_clamp_min

Vous pouvez utiliser le paramètre map_value_scale_clamp_min pour définir la valeur minimale de la plage de couleurs. Cela vous permet d'attribuer la couleur la plus basse spécifiée avec le paramètre map_value_colors à tous les points situés en dessous d'un certain seuil (le nombre spécifié). Par défaut, la valeur minimale appliquée à la légende est la valeur minimale de votre requête.


map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

Vous pouvez utiliser le paramètre map_value_scale_clamp_max pour définir la valeur maximale de la plage de couleurs. Cela vous permet d'attribuer la couleur la plus élevée spécifiée avec le paramètre map_value_colors à tous les points au-dessus du nombre indiqué. Par défaut, la valeur maximale appliquée à la légende est celle de votre requête.


map_value_scale_clamp_max: 50000