Mappare i parametri per le dashboard LookML

Questa pagina descrive i parametri per la creazione e la modifica degli elementi della dashboard LookML di type: looker_map con i parametri della dashboard LookML in un file dashboard.lkml.

Per informazioni sulla creazione di un grafico a mappa interattivo tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni dei grafici a mappa. Per informazioni sui tipi di campi necessari per creare un grafico a mappa interattivo, consulta la sezione Parametri di query.

Esempio di utilizzo

Un N indica che è richiesto un valore numerico. Le virgolette singole indicano il testo descrittivo e non devono essere incluse nel codice pubblicato.


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

Definizioni dei parametri

Nome parametro Descrizione
Parametri di base
name (per gli elementi) Crea un elemento
title (per gli elementi) Modifica il modo in cui il nome di un elemento viene visualizzato dagli utenti
type (per gli elementi) Determina il tipo di visualizzazione da utilizzare nell'elemento
height (per gli elementi) Definisce l'altezza di un elemento in unità di tile_size per le dashboard layout: tile e layout: static
width (per gli elementi) Definisce la larghezza di un elemento in unità di tile_size per le dashboard layout: tile e layout: static
top Definisce la posizione dall'alto verso il basso di un elemento in unità di tile_size per le dashboard layout: static
left Definisce la posizione da sinistra a destra di un elemento in unità di tile_size per le dashboard layout: static
row Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per le dashboard layout: newspaper
col Definisce la posizione da sinistra a destra di un elemento in unità di colonne per le dashboard layout: newspaper
refresh (per gli elementi) Imposta l'intervallo di aggiornamento automatico dell'elemento
note Avvia una sezione di LookML per definire una nota per un elemento. Questo parametro ha i sottoparametri text, state e display.
Parametri di query
model Definisce il modello da utilizzare per la query dell'elemento
explore (per gli elementi) Definisce l'esplorazione da utilizzare per la query dell'elemento
fields Definisce i campi da utilizzare per la query dell'elemento. Può essere utilizzato al posto di dimensions e measures.
dimensions Definisce le dimensioni da utilizzare per la query dell'elemento
measures Definisce le misure da utilizzare per la query dell'elemento
sorts Definisce gli ordinamenti da utilizzare per la query dell'elemento
pivots Definisce le dimensioni che devono essere sottoposte a pivot per essere utilizzate per la query dell'elemento
limit Definisce il limite di righe da utilizzare per la query dell'elemento
column_limit Definisce il limite di colonne da utilizzare per la query dell'elemento
filters (per gli elementi) Definisce i filtri che non possono essere modificati per la query dell'elemento
listen Definisce i filtri che possono essere modificati per la query dell'elemento, se sono stati creati filters (per la dashboard)
query_timezone Definisce il fuso orario da utilizzare quando viene eseguita la query
Parametri del grafico
map_plot_mode Definisce il modo in cui i dati sulla posizione vengono tracciati su un elemento di type: looker_map
heatmap_gridlines Aggiunge un bordo attorno a ciascuna delle linee della griglia utilizzate per un elemento della mappa termica
heatmap_gridlines_empty Per le mappe termiche con heatmap_gridlines impostato su true, mostra un contorno intorno alle regioni della mappa che non hanno dati associati
heatmap_opacity Definisce l'opacità dei colori utilizzati in una mappa termica
Parametri mappa
map_tile_provider Definisce il tipo di mappa di sfondo e se vengono visualizzate le etichette della mappa
map_position Definisce il punto centrale e il livello di zoom della mappa visibile
map_latitude Definisce la latitudine per una mappa con map_position impostato su custom
map_longitude Definisce la longitudine di una mappa con map_position impostato su custom
map_zoom Definisce lo zoom per una mappa con map_position impostato su custom
map_scale_indicator Imposta se mostrare una scala della mappa e il tipo di unità visualizzate
map_pannable Imposta se gli utenti possono riposizionare la mappa trascinandola
map_zoomable Imposta se gli utenti possono aumentare o diminuire lo zoom sulla mappa
show_view_names Imposta se mostrare il nome della visualizzazione insieme al nome del campo nelle descrizioni comando della mappa
show_legend Imposta se mostrare o meno una legenda della mappa in basso a destra nella visualizzazione
show_region_field Imposta se visualizzare le informazioni sulla regione nella descrizione comando della mappa
draw_map_labels_above_data Visualizza le etichette della mappa sopra o sotto la mappa termica
Parametri dei punti
map_marker_type Specifica il tipo di punto visualizzato sulla mappa per gli elementi con map_plot_mode impostato su points, lines o areas
map_marker_icon_name Specifica il tipo di icona da visualizzare su tutti gli indicatori della mappa per gli elementi con map_marker_type impostato su icon o circle_and_icon
map_marker_radius_mode Imposta il modo in cui vengono ridimensionati i cerchi per gli elementi con map_marker_type impostato su circle o circle_and_icon
map_marker_radius_fixed Imposta un raggio fisso da applicare a tutti gli indicatori sulla mappa, per gli elementi con map_marker_type impostato su circle o circle_and_icon e map_marker_radius_mode impostato su fixed
map_marker_radius_min Imposta il raggio minimo dei cerchi per gli elementi con map_marker_radius_mode impostato su proportional_value
map_marker_radius_max Imposta il raggio massimo dei cerchi per gli elementi con map_marker_radius_mode impostato su proportional_value
map_marker_proportional_scale_type Specifica se la dimensione del cerchio si basa su una scala lineare o logaritmica per gli elementi con map_marker_type impostato su circle o circle_and_icon e map_marker_radius_mode impostato su proportional_value
map_marker_units Imposta le unità utilizzate per il raggio di un cerchio su meters o pixels, per gli elementi con map_marker_type impostato su circle o circle_and_icon
map_marker_color_mode Specifica se il colore degli indicatori della mappa è fisso o se i colori vengono assegnati dinamicamente agli indicatori in base ai valori della query sottostante
map_marker_color Specifica un singolo colore da applicare a tutti gli indicatori sulla mappa, per gli elementi con map_marker_color_mode impostato su fixed
Parametri dei valori
map_value_colors Specifica i colori dei punti sulla mappa o definisce l'intervallo di colori da utilizzare se utilizzi la codifica dei colori in base a una misura
quantize_map_value_colors Cambia la scala di colori da un gradiente uniforme ai soli colori specifici che hai impostato
reverse_map_value_colors Cambia i colori che indicano i valori alti e bassi nel grafico, invertendo la mappa a gradiente di colore
map_value_scale_clamp_min Imposta il valore minimo dell'intervallo di colori
map_value_scale_clamp_max Imposta il valore massimo dell'intervallo di colori

Parametri base

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri di base name e type. Altri parametri di base, come title, height e width, influiscono sull'aspetto e sulla posizione di un elemento in una dashboard.

name

Questa sezione si riferisce al parametro name, che fa parte di un elemento della dashboard.

name può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci. A volte i nomi vengono indicati nel parametro elements quando utilizzi le dashboard layout: grid o nel parametro group degli elementi secondari quando organizzi gli elementi in un gruppo di riquadri (type: group).

- name: orders_by_date

title

Questa sezione si riferisce al parametro title, che fa parte di un elemento della dashboard.

title può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

title può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro title ti consente di modificare il modo in cui il nome di un elemento viene visualizzato dagli utenti. Se non specificato, il titolo predefinito è l'elemento name.

Considera questo esempio:

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

Se hai utilizzato questo formato, l'elemento non verrà visualizzato come Panoramica delle vendite, ma come 1) Panoramica delle vendite.

type

Questa sezione si riferisce al parametro type, che fa parte di un elemento della dashboard.

type può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

type può essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametro type (per i join).

type può essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.

type può essere utilizzato anche come parte di una misura, descritta nella pagina della documentazione Tipi di misure.

Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.

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

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione type (per le dashboard LookML).

height

Questa sezione si riferisce al parametro height, che fa parte di un elemento della dashboard.

height può essere utilizzato anche come parte di una riga della dashboard, descritta nella pagina della documentazione relativa ai parametri della dashboard.

Per le dashboard con layout tile o static

Il parametro height definisce l'altezza di un elemento, in unità di tile_size (definita in pixel), per le dashboard layout: tile e layout: static.

Ad esempio, il codice seguente specifica tile_size: 100 e height: 4, rendendo l'elemento orders_by_date alto 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Per le dashboard con layout newspaper

Il parametro height definisce l'altezza di un elemento, in unità di row, per le dashboard layout: newspaper.

Per impostazione predefinita, una dashboard con layout di giornale ha un'altezza degli elementi di 6 righe o circa 300 pixel. L'altezza minima è di 1 riga per le dashboard con un parametro preferred viewer impostato su dashboards-next. L'altezza minima è di 2 righe per le dashboard con un parametro preferred viewer impostato su dashboards.

Ad esempio, il seguente codice imposta un elemento in modo che sia alto 12 righe, ovvero il doppio rispetto agli altri elementi impostati sul valore predefinito:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

Questa sezione si riferisce al parametro width, che fa parte di un elemento della dashboard.

width può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per le dashboard layout: tile e layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e width: 4, rendendo l'elemento orders_by_date largo 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Il parametro width definisce la larghezza di un elemento, in unità di colonne, per le dashboard layout: newspaper.

Una dashboard con layout di tipo giornale ha una larghezza predefinita di 24 colonne.

Ad esempio, il seguente codice imposta l'elemento su metà della larghezza della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Il parametro top definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per le dashboard layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e top: 4, posizionando il bordo superiore dell'elemento orders_by_date a 400 pixel dalla parte superiore della dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Il parametro left definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per le dashboard layout: static.

Ad esempio, il codice seguente specifica tile_size: 100 e left: 4, posizionando il bordo sinistro dell'elemento orders_by_date a 400 pixel dal lato sinistro della dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Per le dashboard layout: newspaper, il parametro row definisce la riga su cui viene posizionato il bordo superiore di un elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, row definisce la posizione della riga dell'elemento rispetto alla parte superiore del contenitore del gruppo (row: 0).

Una dashboard inizia con la riga 0 nella parte superiore. Una dashboard con layout di tipo giornale ha un'altezza predefinita degli elementi di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occuperebbero per impostazione predefinita le righe 0-5.

Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è di 300 pixel.

Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi della dashboard, supponendo che gli elementi siano impostati sull'altezza predefinita:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Per le dashboard layout: newspaper, il parametro col definisce la colonna in cui è posizionato il bordo sinistro dell'elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, col definisce la posizione della colonna dell'elemento rispetto al bordo sinistro del contenitore del gruppo (col: 0).

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di tipo giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperebbero per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna di elementi della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

Questa sezione si riferisce al parametro refresh, che fa parte di un elemento della dashboard.

refresh può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro refresh consente a un elemento di ricaricarsi automaticamente a intervalli regolari, recuperando così dati aggiornati. Questa opzione è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio sulla TV di un ufficio. Tieni presente che la dashboard deve essere aperta in una finestra del browser affinché questo parametro abbia effetto. Questa impostazione non viene eseguita in background per "pre-riscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere un numero qualsiasi (senza decimali) di secondi, minuti, ore o giorni. Ad esempio:

- name: orders_by_date
  refresh: 2 hours

Presta attenzione quando imposti intervalli di aggiornamento brevi. Se la query alla base dell'elemento richiede molte risorse, alcuni elementi potrebbero sovraccaricare il database più del previsto.

note

Puoi aggiungere note descrittive agli elementi in questo modo:

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

note ha i sottoparametri text, state e display.

text

Il sottoparametro text specifica il testo visualizzato nella nota. Il testo può essere localizzato.

state

Il sottoparametro state determina se la nota verrà collapsed o expanded se è troppo grande per essere inserita in una singola riga all'interno della larghezza dell'elemento. Se scegli collapsed e la nota è troppo lunga, terminerà con dei puntini di sospensione cliccabili (...) che possono essere utilizzati per leggere la nota completa.

display

Il sottoparametro display determina dove viene visualizzata la nota su un elemento. above posiziona la nota nella parte superiore di un elemento, below la posiziona nella parte inferiore di un elemento e hover richiede all'utente di passare il mouse sopra l'elemento per visualizzare la nota.

Parametri di query

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri di ricerca model e explore.

Per gli elementi della dashboard LookML di type: looker_map, devi anche specificare almeno un campo geografico come valore del parametro dimensions o fields. Un campo geografico può essere uno dei seguenti:

  • Una dimensione basata sui dati di latitudine e longitudine, definita in LookML come dimensione di type: location.
  • Una dimensione a cui è assegnato un livello della mappa. Gli sviluppatori LookML possono aggiungere un livello della mappa integrato o un livello della mappa personalizzato a una misura utilizzando il parametro map_layer_name.
  • Una dimensione del codice postale. Le regioni dei codici postali si basano sulle aree di tabulazione dei codici postali (ZCTA) del 2010. Se visualizzi i codici postali, potrebbe non esserci una corrispondenza uno a uno tra i codici postali e le ZCTA utilizzate per le visualizzazioni della mappa, pertanto è possibile che non tutti i punti vengano visualizzati nella mappa.

Puoi utilizzare gli altri parametri di ricerca per controllare il modo in cui i dati vengono visualizzati in un elemento della dashboard. Per saperne di più sui requisiti per la creazione di un grafico a mappa interattivo con l'interfaccia utente di Looker, consulta la sezione Creazione di un grafico a mappa interattivo della pagina della documentazione Opzioni dei grafici a mappa.

model

Il parametro model definisce il modello da utilizzare per la query dell'elemento. Se non specificato, il valore predefinito sarà il modello in cui si trova la dashboard.

- name: orders_by_date
  model: ecommerce

Il parametro model accetta le costanti LookML. Puoi definire una costante nel file manifest del progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per model. L'utilizzo di una costante consente di definire il nome di un modello in un unico punto, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi della dashboard.

Per ulteriori informazioni e un esempio di utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

explore

Questa sezione si riferisce al parametro explore, che fa parte di un elemento della dashboard.

explore può essere utilizzato anche nell'ambito di un modello, come spiegato nella pagina della documentazione dedicata al parametro explore.

explore può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro explore definisce l'esplorazione da utilizzare per la query dell'elemento.

- name: orders_by_date
  explore: order

Il parametro explore accetta le costanti LookML. Puoi definire una costante nel file manifest del progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per explore. L'utilizzo di una costante consente di definire il nome di un'esplorazione in un unico punto, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi della dashboard.

Per ulteriori informazioni e un esempio di utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

fields

Il parametro fields definisce i campi da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare i campi.

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

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

Se utilizzi il parametro fields, non è necessario utilizzare i parametri dimensions e measures.

dimensions

Il parametro dimensions definisce la dimensione o le dimensioni da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere dimensions se la query non ne ha.

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

Il parametro measures definisce la misura o le misure da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.measure_name per specificare la misura. Non includere measures se la query non ne ha.

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

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

sorts

Il parametro sorts definisce il comportamento di ordinamento per la query dell'elemento. Elenca prima il campo di ordinamento principale, seguito da eventuali campi di ordinamento secondari. Utilizza la sintassi view_name.field_name per specificare la dimensione o la misura in base alla quale ordinare.

Se ometti il parametro sorts, l'elemento utilizza l'ordinamento predefinito di Looker. Gli ordinamenti crescenti non richiedono un suffisso, mentre quelli decrescenti richiedono il suffisso desc.

L'esempio seguente definisce un singolo ordinamento:

- name: orders_by_date
  sorts: order.order_date desc

L'esempio seguente definisce più ordinamenti:

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

Se utilizzi le dimensioni pivot, puoi ordinare i risultati della query specificando il nome della misura, la direzione di ordinamento e il numero di indice basato su 0 della colonna di destinazione nella tabella dei dati. Ad esempio, il seguente elemento ordina in base alla prima colonna pivot utilizzando l'indice 0:

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

Per ordinare in base al totale della riga, specifica l'indice della colonna dei totali. Ad esempio, il seguente elemento ordina in base al totale della riga utilizzando l'indice 2, che rappresenta la colonna dei totali per una query con due colonne pivot:

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

pivots

Il parametro pivots definisce le dimensioni che devono essere sottoposte a pivot per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere pivots se la query non ne ha.

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

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

limit

Il parametro limit definisce il limite di righe da utilizzare per la query dell'elemento. Il limite si applica al numero di righe prima dell'applicazione di eventuali pivot.

- name: orders_by_date
  limit: 100

column_limit

Il parametro column_limit definisce il limite di colonne da utilizzare per la query dell'elemento. Il limite si applica al numero di colonne dopo l'applicazione di eventuali pivot.

- name: orders_by_date
  column_limit: 100

filters

Questa sezione si riferisce al parametro filters, che fa parte di un elemento della dashboard.

filters può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

filters può essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametro filters.

Il parametro filters definisce i filtri non modificabili da utilizzare per la query dell'elemento. Se vuoi che i filtri possano essere modificati da un utente nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.

La sintassi di filters è:

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

Ogni filtro può accettare un'espressione di filtro di Looker o una costante di valore. Puoi anche utilizzare le variabili Liquid _localization o _user_attributes nell'espressione di filtro per valori di filtro flessibili.

listen

I filtri della dashboard consentono ai visualizzatori di perfezionare in modo interattivo i dati visualizzati negli elementi della dashboard. Definisci i filtri della dashboard con il parametro filters per le dashboard LookML. Poi, utilizza il parametro listen per collegare gli elementi della dashboard al filtro della dashboard.

La sintassi di listen è la seguente:

- 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

Aggiungi il parametro listen a un elemento, quindi fornisci il nome del filtro seguito da due punti e un riferimento al campo a cui applicare il filtro, utilizzando la sintassi view_name.field_name. Ad esempio, potresti creare un filtro denominato Data che richiede a un utente di inserire una data nel campo del filtro nell'interfaccia utente. Puoi quindi applicare il valore inserito dall'utente all'elemento orders_by_date in questo modo:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Se il filtro ascoltato è configurato con il parametro vis_filter: true, il controllo del filtro viene visualizzato in una barra dei filtri direttamente nella parte superiore del riquadro di visualizzazione, anziché nella barra dei filtri della dashboard in alto.

Per altri esempi di utilizzo dei parametri filters e listen per applicare i filtri della dashboard ai singoli elementi della dashboard, consulta Creazione di dashboard LookML.

query_timezone

Il parametro query_timezone specifica il fuso orario in cui verrà eseguita la query. Le opzioni relative ai fusi orari sono mostrate nella pagina della documentazione Valori per timezone. Se vuoi che la query venga eseguita utilizzando il fuso orario del visualizzatore, puoi assegnare il valore user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

Parametri del grafico

I parametri descritti in questa sezione corrispondono alle opzioni della sezione Traccia dell'editor di visualizzazione per i grafici a mappa.

I parametri che puoi utilizzare con un elemento di type: looker_map dipendono dal fatto che la query includa una dimensione di type: location o abbia un livello della mappa associato.

map_plot_mode

Il parametro map_plot_mode definisce il modo in cui i dati vengono rappresentati su un elemento type: looker_map basato su una dimensione di type: location. Questo parametro non è disponibile per le mappe basate su una dimensione con un livello della mappa associato o per le dimensioni del codice postale. Il parametro map_plot_mode accetta i seguenti valori:

points

Se imposti map_plot_mode su points, ogni riga della tabella dati sottostante viene tracciata come un punto distinto sulla mappa.

Una dimensione di type: location da sola posiziona punti di dimensioni e colore uniformi sulla mappa. L'aggiunta di una misura alla query consente di scalare i punti in base al colore o alle dimensioni utilizzando i parametri map_marker_radius_mode e map_marker_color_mode.

automagic_heatmap

Se imposti map_plot_mode su automagic_heatmap, i dati della query sottostante vengono visualizzati come griglia della mappa termica. Funziona dividendo la mappa visibile in quadrati uguali e poi calcolando quali valori dei dati rientrano in ogni quadrato. I quadrati sono colorati in base a una misura scelta da te. Se aumenti o diminuisci lo zoom di questa mappa, Looker ricalcolerà la griglia in modo che la granularità sia appropriata per il livello di zoom.

Perché questo tipo di grafico funzioni correttamente, la query deve includere sia una dimensione di type: location sia una misura.

lines

Se imposti map_plot_mode su lines, vengono prese due dimensioni di type: location dalla query e vengono collegate nella visualizzazione. L'aggiunta di una misura alla query ti consente di aggiungere una scala di colori alle linee.

areas

Se imposti map_plot_mode su areas, viene presa una dimensione di type: location e vengono collegati tutti i punti nell'ordine in cui li hai ordinati. In questo modo si formano i confini di un'area sull'elemento della mappa. L'aggiunta di una misura alla query consente di formattare le dimensioni e il colore dei singoli punti di località che costituiscono i confini dell'area.

heatmap_gridlines

Per gli elementi della mappa termica, l'impostazione di heatmap_gridlines su true aggiunge un bordo attorno a ciascuna delle linee della griglia utilizzate per la mappa termica. Questo parametro è disponibile quando tracci una dimensione di type: location con map_plot_mode impostato su automagic_heatmap o quando tracci una dimensione del codice postale o una dimensione con un livello della mappa associato.


heatmap_gridlines: true | false

heatmap_gridlines_empty

Quando heatmap_gridlines è impostato su true per gli elementi della mappa termica, l'impostazione di heatmap_gridlines_empty su true mostra un contorno intorno alle regioni della mappa che non hanno dati associati.


heatmap_gridlines_empty: true | false

heatmap_opacity

Per gli elementi della mappa termica, puoi utilizzare heatmap_opacity per specificare l'opacità dei colori utilizzati nella mappa termica. Specifica un numero compreso tra 0 e 1 come valore per heatmap_opacity, dove 0 indica nessun colore e 1 indica un colore totalmente opaco.


heatmap_opacity: 0.5

Parametri della mappa

La maggior parte dei parametri descritti in questa sezione corrisponde alle opzioni della sezione Mappa dell'editor di visualizzazione per i grafici a colonne.

map_tile_provider

Disponibile per tutte le mappe, il parametro map_tile_provider consente di modificare il tipo di mappa di sfondo e di specificare se visualizzare le etichette della mappa (come città e strade).

  • light: mappa dai colori chiari e tenui progettata per fornire un contesto geografico evidenziando al contempo i tuoi dati
  • light_no_labels: come light, ma la mappa omette le etichette come i nomi delle città
  • dark: mappa discreta dai colori scuri progettata per fornire un contesto geografico mettendo in evidenza i tuoi dati
  • dark_no_labels: come dark, ma la mappa omette le etichette come i nomi delle città
  • satellite_streets: mappa che mostra immagini satellitari e aeree globali
  • satellite: come satellite_streets, ma la mappa omette le etichette come i nomi delle città
  • streets: mappa per uso generico che enfatizza lo stile leggibile delle reti stradali e di trasporto pubblico
  • outdoors: mappa per uso generico personalizzata per escursionismo, ciclismo e altri usi all'aperto
  • traffic_day: mappa dai colori chiari che mette in evidenza le reti di trasporto pubblico e le strade, incluse le informazioni sul traffico attuale
  • traffic_night: mappa dai colori scuri che mette in evidenza le reti di trasporto pubblico e le strade, incluse le informazioni sul traffico attuale

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

map_position

Puoi utilizzare il parametro map_position per impostare il punto centrale e il livello di zoom della mappa visibile. Esistono due opzioni per specificare questa posizione:

  • fit_data: centra e aumenta lo zoom della mappa automaticamente in modo che tutti i punti dati della query siano visibili
  • custom: consente di specificare manualmente latitudine, longitudine e livello di zoom utilizzando i parametri map_latitude, map_longitude e map_zoom

map_position: fit_data | custom

map_latitude

Il parametro map_latitude specifica la latitudine di un elemento della mappa con map_position impostato su custom.


map_latitude: -5.804047131379801

map_longitude

Il parametro map_longitude specifica la longitudine di un elemento della mappa con map_position impostato su custom.


 map_longitude: 113.34732055664064

map_zoom

Il parametro map_zoom consente di specificare il livello di zoom per un elemento della mappa con map_position impostato su custom. I numeri più alti creano un livello di zoom più ravvicinato.


map_zoom: 10

map_scale_indicator

Impostato su 'off' per impostazione predefinita, il parametro map_scale_indicator consente di specificare se mostrare una scala della mappa e di impostare i tipi di unità visualizzati.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

Il parametro map_pannable specifica se gli utenti possono riposizionare la mappa trascinandola. Questa opzione è attiva per impostazione predefinita.


map_pannable: true | false

map_zoomable

Il parametro map_zoomable specifica se gli utenti possono aumentare e diminuire lo zoom dell'elemento mappa. Questa opzione è attiva per impostazione predefinita.


map_zoomable: true | false

show_view_names

Il parametro show_view_names specifica se mostrare il nome della visualizzazione insieme al nome del campo nelle descrizioni comando della mappa, che vengono visualizzate quando gli utenti fanno clic sui punti dati della mappa.


show_view_names: true | false

show_legend

Specifica se mostrare una legenda della mappa in basso a destra nella visualizzazione. La legenda mostra la scala di colori che stai utilizzando, se hai aggiunto una misura alla visualizzazione.

Il parametro show_legend è disponibile quando sono state specificate le seguenti opzioni di grafico:


show_legend: true | false

show_region_field

Per le mappe basate su un livello della mappa o su un codice postale, il parametro show_region_field visualizza le informazioni nel tooltip della mappa. Gli utenti possono fare clic su un punto della mappa per visualizzare il nome della regione.


show_region_field: true | false

draw_map_labels_above_data

Per le mappe con livelli della mappa o basate su una dimensione del codice postale, puoi utilizzare il parametro draw_map_labels_above_data per visualizzare le etichette della mappa sopra o sotto la mappa termica. Questo è particolarmente importante con valori di opacità della mappa termica più elevati. Se la mappa termica è opaca, le etichette non verranno visualizzate, a meno che non siano mostrate sopra i dati.


draw_map_labels_above_data: true | false

Parametri dei punti

Le opzioni dei punti non sono disponibili per le mappe con map_plot_mode impostato su automagic_heatmap.

map_marker_type

Per le mappe basate su una dimensione di località e con map_plot_mode impostato su points, lines o areas, il parametro map_marker_type definisce il tipo di punto visualizzato nell'elemento della mappa. Il parametro map_marker_type accetta i seguenti valori:

  • circle
  • icon
  • circle_and_icon
  • none

Il valore specificato per map_marker_type influisce sui parametri disponibili per la formattazione dei punti visualizzati sulla mappa.

map_marker_icon_name

Se map_marker_type è impostato su icon o circle_and_icon, puoi utilizzare il parametro map_marker_icon_name per impostare il tipo di icona da visualizzare su tutti gli indicatori di mappa.


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

Per le mappe con map_marker_type impostato su circle o circle_and_icon, puoi utilizzare il parametro map_marker_radius_mode per impostare le dimensioni dei cerchi in base alle seguenti opzioni:

  • proportional_value: questa opzione regola le dimensioni relative dei cerchi in base alle misure che hai aggiunto alla query. Con questa opzione puoi utilizzare i parametri map_marker_radius_min e map_marker_radius_max per impostare un raggio minimo e un raggio massimo per i cerchi. Puoi anche utilizzare il parametro map_marker_proportional_scale_type per impostare se utilizzare una scala lineare o logaritmica per ridimensionare i cerchi.
  • equal_to_value: questa impostazione regola il raggio dei cerchi in base ai valori di misurazione effettivi nella query sottostante.
  • fixed: questa opzione consente di impostare un raggio fisso da applicare a tutti gli indicatori sulla mappa utilizzando il parametro map_marker_radius_fixed. Il valore predefinito è 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

Quando map_marker_radius_mode è impostato su fixed e map_marker_type è impostato su circle o circle_and_icon, puoi utilizzare il parametro map_marker_radius_fixed per impostare un raggio fisso che si applica a tutti gli indicatori sulla mappa.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Per le mappe con map_marker_type impostato su circle o circle_and_icon e map_marker_radius_mode impostato su proportional_value, puoi utilizzare il parametro map_marker_radius_min per definire il raggio minimo di un cerchio.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

Per le mappe con map_marker_type impostato su circle o circle_and_icon e map_marker_radius_mode impostato su proportional_value, puoi utilizzare il parametro map_marker_radius_max per definire il raggio massimo di un cerchio.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

Per le mappe con map_marker_type impostato su circle o circle_and_icon e map_marker_radius_mode impostato su proportional_value, puoi utilizzare il parametro map_marker_proportional_scale_type per impostare le dimensioni del cerchio in base a una scala lineare o logaritmica. Il valore di questo parametro può essere linear o log.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

Per le mappe con map_marker_type impostato su circle o circle_and_icon, puoi utilizzare il parametro map_marker_units per impostare le unità utilizzate per il raggio di un cerchio su meters o pixels.


map_marker_units: meters | pixels

map_marker_color_mode

Puoi utilizzare map_marker_color_mode per impostare i colori degli indicatori sulla mappa:

  • Se map_marker_color_mode è impostato su value, i colori vengono assegnati dinamicamente agli indicatori in base ai valori della query sottostante. Puoi utilizzare i parametri dei valori per configurare i colori nella legenda per questa opzione.
  • Se map_marker_color_mode è impostato su fixed, puoi utilizzare il parametro map_marker_color per impostare un singolo colore da utilizzare per tutti gli indicatori sulla mappa. Il valore del colore può essere formattato come stringa esadecimale RGB, ad esempio 2ca6cd, o come nome colore CSS, ad esempio mediumblue.

map_marker_color

Quando map_marker_color_mode è impostato su fixed, imposta un unico colore da utilizzare per tutti gli indicatori sulla mappa.


map_marker_color: [mediumblue]

Parametri dei valori

Puoi utilizzare questi parametri per configurare i colori che verranno assegnati dinamicamente agli indicatori in base ai valori della query sottostante quando map_marker_color_mode è impostato su value o per gli elementi della mappa con map_plot_mode impostato su automagic_heatmap, lines o areas.

map_value_colors

Puoi utilizzare il parametro map_value_colors per impostare il colore dei punti sulla mappa o, se utilizzi un codice colore in base a una misura, per definire l'intervallo di colori da utilizzare. Puoi inserire un elenco di stringhe esadecimali, ad esempio #2ca6cd, o nomi di colori CSS, ad esempio mediumblue. I colori elencati per primi sono associati ai valori più bassi.


map_value_colors: [green, mediumblue]

quantize_map_value_colors

Se impostato su true, quantize_map_value_colors cambia la scala di colori da un gradiente uniforme ai soli colori specifici che hai impostato. Per impostazione predefinita, questo parametro è impostato su false.


quantize_map_value_colors: true | false

reverse_map_value_colors

Se impostato su true, il parametro reverse_map_value_colors cambia i colori che indicano i valori alti e bassi nel grafico, invertendo la mappa a gradiente di colore.


reverse_map_value_colors: true | false

map_value_scale_clamp_min

Puoi utilizzare il parametro map_value_scale_clamp_min per impostare il valore minimo per l'intervallo di colori. In questo modo, puoi colorare tutti i punti al di sotto di una determinata soglia (il numero specificato) con il colore più basso specificato con il parametro map_value_colors. Per impostazione predefinita, il valore minimo applicato alla legenda è il valore minimo della query.


map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

Puoi utilizzare il parametro map_value_scale_clamp_max per impostare il valore massimo per l'intervallo di colori, in modo da codificare con un colore tutti i punti al di sopra del numero specificato con il colore più alto specificato con il parametro map_value_colors. Per impostazione predefinita, il valore massimo applicato alla legenda è il valore massimo della query.


map_value_scale_clamp_max: 50000