Paramètres Google Maps pour les tableaux de bord LookML

Important : Les graphiques de type: looker_google_map ne peuvent être affichés que sur les tableaux de bord LookML dont le paramètre preferred_viewer est défini sur dashboards-next.

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

Pour savoir comment créer un graphique Google Maps via l'interface utilisateur de Looker, consultez la page de documentation Options des graphiques Google Maps. Pour en savoir plus sur les types de champs requis pour créer une carte géographique interactive, consultez la section Paramètres de requête plus loin sur cette page.

Exemple d'utilisation

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 actif.

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

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 présentation d'un nom d'élément 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 de 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 de 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 de tile_size pour les tableaux de bord layout: static
left	Définit la position de gauche à droite d'un élément en unités de tile_size pour les tableaux de bord layout: static
row	Définit la position verticale 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 d'actualisation automatique de l'élément
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 qui doivent être pivotées pour être utilisées dans 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 tracé
map_plot_mode	Définit la façon 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 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 n'ont pas de données associées.
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 d'arrière-plan et indique si les libellés de la 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 avec map_position défini sur custom
map_longitude	Définit la longitude d'une carte avec map_position défini sur custom
map_zoom	Définit le zoom d'une carte avec map_position défini sur custom
map_scale_indicator	Détermine si une échelle de carte sera affichée et le type d'unités affichées
map_pannable	Détermine 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 si le nom de la vue doit être affiché avec le nom du champ dans les info-bulles de la carte
show_legend	Indique si une légende de carte doit être affichée en bas à droite de la visualisation
show_region_field	Indique si les informations sur la région doivent être affichées 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 l'attribut 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 la 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 la taille des cercles est déterminée, pour les éléments dont la propriété map_marker_type est définie sur circle ou circle_and_icon.
map_marker_radius_fixed	Définit un rayon fixe à appliquer à tous les repères sur la 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 l'option map_marker_radius_mode est définie sur proportional_value.
map_marker_radius_max	Définit le rayon maximal des cercles pour les éléments dont le paramètre 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 est défini 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 l'attribut 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 les couleurs sont attribuées de manière dynamique aux repères en fonction des valeurs de la requête sous-jacente.
map_marker_color	Spécifie une seule couleur à appliquer à tous les repères sur la carte, pour les éléments dont le paramètre 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 gamme de couleurs à utiliser si vous appliquez un code couleur en fonction d'une mesure.
quantize_map_value_colors	Remplace le dégradé de l'échelle de couleurs par les couleurs spécifiques que vous avez définies
reverse_map_value_colors	Permute les couleurs qui indiquent les valeurs élevées et faibles sur le graphique, en inversant le dégradé de couleurs.
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, ont une incidence sur 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 de tableau de bord.

Chaque déclaration name crée un élément du 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, ou dans le paramètre group des éléments enfants lorsque vous organisez des éléments dans un groupe de tuiles (type: group).

- 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 de 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 de 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 aucune valeur n'est spécifiée, le titre est défini par défaut sur l'élément name.

Considérez l'exemple suivant :

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

Si vous utilisez ce format, l'élément n'apparaîtra pas sous la forme Sales Overview, mais sous la forme 1) Sales Overview.

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 de tableau de bord.

type peut également être utilisé dans le cadre d'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 | button | group

Consultez la page de documentation type (pour les tableaux de bord LookML) pour obtenir une présentation des différents types d'éléments de tableau 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 de 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 de tile_size (qui est défini 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 donne à l'élément orders_by_date une hauteur de 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 de row, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal utilise par défaut une hauteur d'élément 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 une hauteur de 12 lignes, 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 de tableau de bord.

Le paramètre width définit la largeur d'un élément, en unités de 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 donne à l'élément orders_by_date une largeur de 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.

Par défaut, un tableau de bord avec une mise en page de type journal comporte 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 de 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 de tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et left: 4, en positionnant le bord gauche de l'élément orders_by_date à 400 pixels du côté 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é. Si l'élément est placé dans un groupe de tuiles à l'aide du paramètre group, row définit la position de la ligne de l'élément par rapport au haut du conteneur du groupe (row: 0).

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, ce qui signifie que les éléments du tableau de bord situés en haut (row: 0) occupent par défaut les lignes 0 à 5.

Chaque ligne mesure 50 pixels de haut, ce qui signifie que la hauteur par défaut de l'élément (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é. Si l'élément est placé dans un groupe de tuiles à l'aide du paramètre group, col définit la position de la colonne de l'élément par rapport au bord gauche du conteneur du groupe (col: 0).

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

Par exemple, le code suivant définit un élément à placer 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 de 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 actualisées. Cette fonctionnalité est souvent utile dans les environnements où un tableau de bord est affiché en permanence, 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échauffer" 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 derrière l'élément consomme beaucoup de ressources, certains éléments peuvent solliciter votre base de données plus que souhaité.

note

Vous pouvez ajouter des notes descriptives aux éléments comme suit :

- 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 choisissez collapsed et que la note est trop longue, elle se terminera par des points de suspension cliquables (...) permettant de lire l'intégralité de la note.

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 nécessite que l'utilisateur passe la souris 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_google_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 en tant que 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 de 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 se peut 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 également utiliser les autres paramètres de requête décrits ci-après pour contrôler la façon dont les données sont affichées dans un élément du tableau de bord. Pour en savoir plus sur les exigences de création d'un graphique de carte interactif avec l'UI Looker, consultez la section Créer un graphique Google Maps de la page de documentation Options des graphiques de carte.

model

Le paramètre model définit le modèle à utiliser pour la requête d'élément. Si ce paramètre n'est pas spécifié, le modèle par défaut est celui où se trouve 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 des 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 le cadre d'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 de tableau de bord.

Le paramètre explore définit l'exploration à utiliser pour la requête de l'é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 des 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 de l'é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 le comportement de tri pour la requête de l'élément. Indiquez d'abord le champ de tri principal, puis les champs de tri secondaires. Utilisez la syntaxe view_name.field_name pour spécifier la dimension ou la mesure à utiliser pour le tri.

Si vous omettez le paramètre sorts, l'élément utilise l'ordre de tri par défaut de Looker. Les tris croissants ne nécessitent pas de suffixe, tandis que les tris décroissants nécessitent le suffixe desc.

L'exemple suivant définit un seul tri :

- name: orders_by_date
  sorts: order.order_date desc

L'exemple suivant définit plusieurs tris :

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

Si vous pivotez des dimensions, vous pouvez trier les résultats de la requête en spécifiant le nom de la mesure, le sens du tri et le numéro d'index (commençant par 0) de la colonne cible dans la table de données. Par exemple, l'élément suivant trie par la première colonne de tableau croisé dynamique à l'aide de l'index 0 :

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

Pour trier par total de ligne, spécifiez l'index de la colonne des totaux. Par exemple, l'élément suivant trie par total de ligne à l'aide de l'index 2, qui représente la colonne des totaux pour une requête avec deux colonnes de tableau croisé dynamique :

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

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. La limite s'applique au nombre de lignes avant l'application des pivots.

- 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 de 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 l'utilisateur puisse modifier les filtres dans le tableau de bord, vous devez configurer les filtres à 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 utilisateurs 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, à l'aide de la syntaxe view_name.field_name. Par exemple, vous pouvez créer un filtre appelé Date qui oblige l'utilisateur à 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
    ...

Si le filtre écouté est configuré avec le paramètre vis_filter: true, la commande de filtre s'affiche dans une barre de filtre directement en haut de cette tuile de visualisation, plutôt que dans la barre de filtre supérieure du tableau de bord.

Pour obtenir d'autres exemples d'utilisation des paramètres filters et listen pour 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 définir la valeur sur user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Paramètres de tracé

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

Les paramètres que vous pouvez utiliser avec un élément de type: looker_google_map dépendent de la présence ou non d'une dimension type: location dans votre requête, ou de l'association d'un calque de carte à celle-ci.

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_google_map basé sur une dimension de type: location. Ce paramètre n'est pas disponible pour les cartes basées sur une dimension avec un calque de carte associé ni pour les dimensions de code postal. Le paramètre map_plot_mode accepte les valeurs suivantes :

• points
• automagic_heatmap
• heatmap
• lines
• areas

points

Si vous définissez map_plot_mode sur points, chaque ligne de la table de données sous-jacente est représentée sous la forme d'un point distinct sur la carte.

Une dimension 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 que vous choisissez. Si vous effectuez un zoom avant ou arrière sur cette carte, Looker recalcule 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 de type: location et une mesure.

heatmap

En définissant map_plot_mode sur heatmap, vous obtenez une carte qui peut afficher une grande quantité de données de localisation avec de nombreux points regroupés. L'intensité et l'échelle des couleurs indiquent la concentration des points de données dans chaque zone.

Votre requête doit inclure une dimension de type: location. Vous pouvez éventuellement ajouter une mesure.

lines

Si vous définissez map_plot_mode sur lines, deux dimensions de type: location sont extraites de votre requête et reliées entre elles dans la visualisation. L'ajout d'une mesure à votre requête vous permet d'ajouter un dégradé de couleurs aux lignes.

areas

Si vous définissez map_plot_mode sur areas, une dimension de type: location est prise en compte et tous les points sont reliés dans l'ordre que vous avez défini. Cela forme les limites d'une zone sur l'élément de carte. L'ajout d'une mesure à la requête vous permet de formater la taille et la couleur des points de localisation individuels qui constituent 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 chaque ligne de grille utilisée pour la carte de densité. Ce paramètre est disponible lorsque vous tracez une dimension de type: location avec map_plot_mode défini sur automagic_heatmap, ou lorsque vous tracez 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é et que vous tracez des données avec un map_layer défini, définir heatmap_gridlines_empty sur true affiche un contour autour des régions de la carte qui n'ont pas de données associées.

heatmap_gridlines_empty: true | false

heatmap_opacity

Pour les éléments de carte de densité, vous pouvez utiliser heatmap_opacity pour spécifier l'opacité des couleurs utilisées dans la carte de densité. Spécifiez un nombre décimal compris entre 0 et 1 comme valeur pour heatmap_opacity, où 0 signifie qu'il n'y a pas de couleur et 1 signifie que la couleur est totalement opaque.

heatmap_opacity: 0.5

Paramètres de carte

La plupart des paramètres décrits dans cette section correspondent aux options de la section "Options du menu Carte" de l'éditeur de visualisation pour les graphiques à colonnes.

map_tile_provider

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

• light : carte subtile et claire conçue pour fournir un contexte géographique tout en mettant en valeur vos données
• light_no_labels : identique à light, mais la carte n'affiche pas 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 valeur vos données
• dark_no_labels : identique à dark, mais la carte n'affiche pas les libellés tels que les noms de villes.
• satellite_streets : carte affichant l'imagerie satellite et aérienne mondiale
• satellite : identique à satellite_streets, mais la carte n'affiche pas les libellés tels que les noms de villes.
• streets : carte à usage général qui met l'accent sur un style lisible des réseaux routiers et de transports en commun
• outdoors : carte à usage général adaptée à la randonnée, au vélo et à d'autres activités de plein air
• traffic_day : carte claire mettant en avant les réseaux de transports en commun et les routes, y compris les informations sur le trafic en temps réel
• traffic_night : carte de couleur sombre mettant en avant les réseaux de transports en commun et les routes, y compris les informations sur le trafic en temps réel
• minimal : carte de couleur claire sans libellés ni lignes de démarcation

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 de manière à ce 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 le paramètre 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 le paramètre 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 dont le paramètre map_position est défini sur custom. Plus le nombre est élevé, plus le niveau de zoom est rapproché.

map_zoom: 10

map_scale_indicator

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

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 effectuer 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 si le nom de la vue doit être affiché avec le nom du champ dans les info-bulles de la carte, qui s'affichent lorsque les utilisateurs cliquent sur des points de données de la carte.

show_view_names: true | false

show_legend

Indiquez si une légende doit être affichée en bas à droite de la visualisation. La légende indique 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 traçage suivantes ont été spécifiées :

• Lorsque map_plot_mode est défini sur automagic_heatmap
• Lorsque map_plot_mode est défini sur points et que map_marker_color_mode est défini sur value

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 calque ou les cartes 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é de carte de densité plus élevées. Si votre carte de densité est opaque, les libellés ne s'afficheront pas, sauf s'ils sont affichés au-dessus des données.

draw_map_labels_above_data: true | false

Paramètres de point

Les options de point ne sont pas disponibles pour les cartes dont le paramètre map_plot_mode est défini sur automagic_heatmap ou heatmap.

map_marker_type

Pour les cartes basées sur une dimension de lieu et dont le paramètre 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 mettre en forme les 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 en fonction des 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 en fonction des valeurs de mesure réelles de votre requête sous-jacente.
• fixed : cette option vous permet de définir un rayon fixe à appliquer à tous les repères de la 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 sur la carte.

map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Pour les cartes dont le paramètre map_marker_type est défini sur circle ou circle_and_icon et le paramètre 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 le paramètre map_marker_type est défini sur circle ou circle_and_icon et le paramètre 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 le paramètre map_marker_type est défini sur circle ou circle_and_icon et le paramètre map_marker_radius_mode sur proportional_value, vous pouvez utiliser le paramètre map_marker_proportional_scale_type pour définir la taille des cercles 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 le paramètre 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 la carte :

• Si map_marker_color_mode est défini sur value, les couleurs sont attribuées de manière dynamique 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 la carte.

map_marker_color

Lorsque map_marker_color_mode est défini sur fixed, map_marker_color_mode définit une seule couleur à utiliser pour tous les repères de la carte. La valeur de couleur peut être formatée sous la forme d'une chaîne hexadécimale RVB, comme 2ca6cd, ou d'un nom de couleur CSS, comme mediumblue.

map_marker_color: [mediumblue]

Paramètres de valeur

Vous pouvez utiliser ces paramètres pour configurer les couleurs qui seront attribuées de manière dynamique 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 dont le paramètre map_plot_mode est défini sur automagic_heatmap, 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, comme #2ca6cd, ou de noms de couleurs CSS, comme mediumblue. Les couleurs que vous listez en premier sont associées aux valeurs les plus faibles.

map_value_colors: [green, mediumblue]

quantize_map_value_colors

Lorsqu'il est défini sur true, quantize_map_value_colors remplace le dégradé de l'échelle 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

Lorsqu'il est défini sur true, le paramètre reverse_map_value_colors change les couleurs qui indiquent les valeurs élevées et faibles sur le graphique, en inversant le dégradé de couleurs.

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 un code couleur à tous les points inférieurs à un certain seuil (le nombre spécifié) avec la couleur la plus basse spécifiée avec le paramètre map_value_colors. 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 un code couleur à tous les points au-dessus du nombre spécifié avec la couleur la plus élevée spécifiée avec le paramètre map_value_colors. Par défaut, la valeur maximale appliquée à la légende est la valeur maximale de votre requête.

map_value_scale_clamp_max: 50000