Google Maps-Parameter für LookML-Dashboards

Auf dieser Seite werden die Parameter zum Erstellen und Bearbeiten von LookML-Dashboard-Elementen von type: looker_google_map mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei beschrieben.

Informationen zum Erstellen eines Google Maps-Diagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Google Maps-Diagrammoptionen. Informationen zu den Feldtypen, die zum Erstellen eines interaktiven Kartendiagramms erforderlich sind, finden Sie weiter unten auf dieser Seite im Abschnitt Abfrageparameter.

Nutzungsbeispiel

Ein N gibt an, dass ein numerischer Wert erforderlich ist. Einfache Anführungszeichen kennzeichnen beschreibenden Text und sollten nicht in Live-Code enthalten sein.


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

Parameterdefinitionen

Parametername Beschreibung
Grundlegende Parameter
name (für Elemente) Erstellt ein Element
title (für Elemente) Ändert die Art und Weise, wie ein Elementname Nutzern angezeigt wird
type (für Elemente) Bestimmt den Typ der Visualisierung, die im Element verwendet werden soll.
height (für Elemente) Definiert die Höhe eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
width (für Elemente) Definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
top Definiert die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards
left Definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.
row Definiert die Position eines Elements von oben nach unten in Zeileneinheiten für layout: newspaper-Dashboards
col Definiert die Position eines Elements von links nach rechts in Spalteneinheiten für layout: newspaper-Dashboards
refresh (für Elemente) Legt das Intervall fest, in dem das Element automatisch aktualisiert wird
note Leitet einen Abschnitt von LookML ein, mit dem eine Notiz für ein Element definiert wird. Dieser Parameter hat die Unterparameter text, state und display.
Suchparameter
model Definiert das Modell, das für die Abfrage des Elements verwendet werden soll.
explore (für Elemente) Definiert den Explore, der für die Abfrage des Elements verwendet werden soll
fields Definiert die Felder, die für die Abfrage des Elements verwendet werden sollen. Dies kann anstelle von dimensions und measures verwendet werden.
dimensions Definiert die Dimensionen, die für die Abfrage des Elements verwendet werden sollen
measures Definiert die Messwerte, die für die Abfrage des Elements verwendet werden sollen
sorts Definiert die Sortierungen, die für die Abfrage des Elements verwendet werden sollen
pivots Definiert die Dimensionen, die für die Abfrage des Elements pivotiert werden sollen
limit Definiert die Zeilenbegrenzung, die für die Abfrage des Elements verwendet werden soll.
column_limit Definiert die Spaltenbegrenzung, die für die Abfrage des Elements verwendet werden soll.
filters (für Elemente) Definiert die Filter, die für die Abfrage des Elements nicht geändert werden können.
listen Definiert die Filter, die für die Abfrage des Elements geändert werden können, wenn filters (für das Dashboard) erstellt wurden.
query_timezone Definiert die Zeitzone, die beim Ausführen der Abfrage verwendet werden soll.
Diagrammparameter
map_plot_mode Definiert, wie Ihre Standortdaten in einem Element von type: looker_map dargestellt werden.
heatmap_gridlines Fügt einen Rahmen um jede der Gitternetzlinien hinzu, die für ein Heatmap-Element verwendet werden.
heatmap_gridlines_empty Bei Heatmaps, bei denen heatmap_gridlines auf true festgelegt ist, wird eine Umrisslinie um Kartenregionen ohne zugehörige Daten angezeigt.
heatmap_opacity Definiert die Deckkraft der Farben, die in einer Heatmap verwendet werden.
Kartenparameter
map_tile_provider Definiert den Typ der Hintergrundkarte und ob Kartenlabels angezeigt werden.
map_position Definiert den Mittelpunkt und die Zoomstufe der sichtbaren Karte.
map_latitude Definiert den Breitengrad für eine Karte, bei der map_position auf custom festgelegt ist.
map_longitude Definiert den Längengrad für eine Karte, bei der map_position auf custom festgelegt ist.
map_zoom Definiert den Zoom für eine Karte, bei der map_position auf custom festgelegt ist.
map_scale_indicator Legt fest, ob ein Kartenmaßstab angezeigt wird und welche Einheiten verwendet werden.
map_pannable Legt fest, ob Nutzer die Karte durch Ziehen neu positionieren können.
map_zoomable Legt fest, ob Nutzer die Karte heran- und herauszoomen können.
show_view_names Legt fest, ob der Ansichtsname zusammen mit dem Feldnamen in Karten-Kurzinfos angezeigt werden soll.
show_legend Legt fest, ob rechts unten in der Visualisierung eine Kartenlegende angezeigt werden soll.
show_region_field Legt fest, ob die Regionsinformationen in der Kurzinfo der Karte angezeigt werden sollen.
draw_map_labels_above_data Hier wird festgelegt, ob die Labels der Karte über oder unter der Heatmap angezeigt werden.
Punktparameter
map_marker_type Gibt den Typ des Punkts an, der auf der Karte für Elemente mit map_plot_mode auf points, lines oder areas festgelegt ist.
map_marker_icon_name Gibt den Typ des Symbols an, das für alle Kartenmarkierungen für Elemente angezeigt werden soll, bei denen map_marker_type auf icon oder circle_and_icon festgelegt ist.
map_marker_radius_mode Legt fest, wie die Größe der Kreise für Elemente mit map_marker_type auf circle oder circle_and_icon festgelegt wird.
map_marker_radius_fixed Legt einen festen Radius für alle Kartenmarkierungen für Elemente fest, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf fixed festgelegt ist.
map_marker_radius_min Legt den Mindestradius für Kreise für Elemente fest, bei denen map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_radius_max Legt den maximalen Radius für Kreise für Elemente fest, bei denen map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_proportional_scale_type Gibt an, ob die Kreisgröße auf einer linearen oder logarithmischen Skala basiert, für Elemente, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist.
map_marker_units Legt die Einheiten für den Radius eines Kreises auf meters oder pixels für Elemente fest, bei denen map_marker_type auf circle oder circle_and_icon festgelegt ist.
map_marker_color_mode Gibt an, ob die Farbe der Kartenmarkierungen festgelegt ist oder die Farben Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch zugewiesen werden.
map_marker_color Gibt eine einzelne Farbe an, die auf alle Kartenmarkierungen für Elemente angewendet werden soll, bei denen map_marker_color_mode auf fixed festgelegt ist.
Wertparameter
map_value_colors Gibt die Farben der Kartenpunkte an oder definiert den Farbbereich, der verwendet werden soll, wenn Sie die Punkte anhand eines Messwerts farblich codieren.
quantize_map_value_colors Ändert die Farbskala von einem stufenlosen Farbverlauf zu den von Ihnen festgelegten Farben.
reverse_map_value_colors Kehrt den Farbverlauf um, indem die Farben für hohe und niedrige Werte im Diagramm getauscht werden.
map_value_scale_clamp_min Legt den Mindestwert des Farbbereichs fest
map_value_scale_clamp_max Legt den Höchstwert des Farbbereichs fest

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie Werte für mindestens die grundlegenden Parameter name und type angeben. Andere grundlegende Parameter wie title, height und width wirken sich auf die Darstellung und Position eines Elements in einem Dashboard aus.

name

In diesem Abschnitt wird auf den Parameter name verwiesen, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit jeder name-Deklaration wird ein neues Dashboard-Element erstellt und ihm ein Name zugewiesen. Elementnamen müssen eindeutig sein. Namen werden manchmal im Parameter elements referenziert, wenn Sie layout: grid-Dashboards verwenden.

- name: orders_by_date

title

In diesem Abschnitt wird auf den Parameter title verwiesen, der Teil eines Dashboard-Elements ist.

title kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

title kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter title können Sie ändern, wie der Name eines Elements für Nutzer angezeigt wird. Wenn nichts angegeben ist, wird standardmäßig das Element name als Titel verwendet.

Betrachten Sie dieses Beispiel:

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

Wenn Sie dieses Format verwendet haben, wird das Element nicht als Umsatzübersicht, sondern als 1) Umsatzübersicht angezeigt.

type

In diesem Abschnitt wird auf den Parameter type verwiesen, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

type kann auch als Teil eines Joins verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen.

type kann auch als Teil einer Measure verwendet werden, wie auf der Dokumentationsseite Measure-Typen beschrieben.

Mit dem Parameter type wird der Visualisierungstyp festgelegt, der im Element verwendet werden soll.

- 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

Eine Übersicht über die verschiedenen Arten von LookML-Dashboard-Elementen finden Sie auf der Dokumentationsseite type (für LookML-Dashboards).

height

In diesem Abschnitt wird auf den Parameter height verwiesen, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Für Dashboards mit tile- oder static-Layouts

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von tile_size (in Pixeln) für layout: tile- und layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, wodurch das Element orders_by_date eine Höhe von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Für Dashboards mit dem Layout newspaper

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von row für layout: newspaper-Dashboards definiert.

Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementhöhe von 6 Zeilen oder etwa 300 Pixeln verwendet. Die Mindesthöhe beträgt eine Zeile für Dashboards, bei denen der Parameter preferred viewer auf dashboards-next festgelegt ist. Die Mindesthöhe beträgt 2 Zeilen für Dashboards, bei denen der Parameter preferred viewer auf dashboards festgelegt ist.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element 12 Zeilen hoch sein soll, also doppelt so hoch wie andere Elemente, für die der Standardwert festgelegt ist:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

In diesem Abschnitt wird auf den Parameter width verwiesen, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter width definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards.

Im folgenden Code werden beispielsweise tile_size: 100 und width: 4 angegeben, wodurch das Element orders_by_date eine Breite von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Mit dem Parameter width wird die Breite eines Elements in Spalteneinheiten für layout: newspaper-Dashboards definiert.

Ein Dashboard mit Zeitungsformat hat standardmäßig eine Breite von 24 Spalten.

Mit dem folgenden Code wird die Breite des Elements beispielsweise auf die Hälfte der Breite des Dashboards festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Mit dem Parameter top wird die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben. Dadurch wird die obere Kante des Elements orders_by_date 400 Pixel vom oberen Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Der Parameter left definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.

Im folgenden Code werden beispielsweise tile_size: 100 und left: 4 angegeben. Dadurch wird die linke Kante des orders_by_date-Elements 400 Pixel vom linken Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Bei layout: newspaper-Dashboards wird mit dem Parameter row die Zeile definiert, in der der obere Rand eines Elements platziert wird.

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen. Die Dashboard-Elemente oben auf einem Dashboard (row: 0) würden also standardmäßig die Zeilen 0 bis 5 einnehmen.

Jede Zeile ist 50 Pixel hoch. Die Standardhöhe von 6 Zeilen beträgt also 300 Pixel.

Mit dem folgenden Code wird beispielsweise ein Element in der zweiten Zeile der Elemente im Dashboard platziert, sofern die Elemente auf der Standardhöhe festgelegt sind:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Bei layout: newspaper-Dashboards definiert der Parameter col die Spalte, an der der linke Rand des Elements platziert wird.

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links im Dashboard. Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementbreite von 8 Spalten verwendet. Die Dashboard-Elemente auf der linken Seite eines Dashboards (col: 0) belegen also standardmäßig die Spalten 0 bis 7.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der dritten Spalte der Elemente im Dashboard platziert werden soll:

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

In diesem Abschnitt wird auf den Parameter refresh verwiesen, der Teil eines Dashboard-Elements ist.

refresh kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter refresh kann ein Element in regelmäßigen Abständen automatisch neu geladen werden, um aktuelle Daten abzurufen. Das ist oft hilfreich, wenn ein Dashboard ständig angezeigt wird, z. B. auf einem Fernseher im Büro. Das Dashboard muss in einem Browserfenster geöffnet sein, damit dieser Parameter wirksam wird. Diese Einstellung wird nicht im Hintergrund ausgeführt, um den Dashboard-Cache „vorzubereiten“.

Die Aktualisierungsrate kann eine beliebige Anzahl (ohne Dezimalstellen) von Sekunden, Minuten, Stunden oder Tagen sein. Beispiel:

- name: orders_by_date
  refresh: 2 hours

Seien Sie vorsichtig, wenn Sie kurze Aktualisierungsintervalle festlegen. Wenn die Abfrage hinter dem Element ressourcenintensiv ist, können bestimmte Elemente Ihre Datenbank stärker als gewünscht belasten.

note

So fügen Sie Elementen beschreibende Notizen hinzu:

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

note hat die Unterparameter text, state und display.

text

Mit dem Unterparameter text wird der Text angegeben, der in der Notiz angezeigt wird. Der Text kann lokalisiert werden.

state

Mit dem Unterparameter state wird festgelegt, ob die Anmerkung collapsed oder expanded wird, wenn sie zu groß ist, um in einer einzelnen Zeile innerhalb der Breite des Elements dargestellt zu werden. Wenn Sie collapsed auswählen und die Anmerkung zu lang ist, endet sie mit klickbaren Auslassungspunkten (...), über die Sie die vollständige Anmerkung lesen können.

display

Mit dem Unterparameter display wird festgelegt, wo die Anmerkung für ein Element angezeigt wird. Mit above wird die Anmerkung oben in einem Element platziert, mit below unten in einem Element und mit hover muss der Nutzer den Mauszeiger auf das Element bewegen, um die Anmerkung zu sehen.

Suchparameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie Werte für mindestens die Abfrageparameter model und explore angeben.

Für LookML-Dashboardelemente vom Typ type: looker_google_map müssen Sie auch mindestens ein geografisches Feld als Wert für den Parameter dimensions oder fields angeben. Ein geografisches Feld kann eines der folgenden sein:

  • Eine Dimension, die auf Breiten- und Längengraddaten basiert und in LookML als Dimension vom Typ type: location definiert ist.
  • Eine Dimension, der eine Kartenebene zugewiesen ist. LookML-Entwickler können einem Messwert mit dem Parameter map_layer_name eine integrierte Kartebene oder eine benutzerdefinierte Kartebene hinzufügen.
  • Eine Dimension für die Postleitzahl. Postleitzahlregionen basieren auf den ZCTAs (Zip Code Tabulation Areas) von 2010. Wenn Sie Postleitzahlen visualisieren, gibt es möglicherweise keine direkte Entsprechung zwischen Postleitzahlen und den für Kartenvisualisierungen verwendeten ZCTAs. Daher werden möglicherweise nicht alle Punkte auf der Karte visualisiert.

Sie können auch die anderen Abfrageparameter verwenden, die im Folgenden beschrieben werden, um die Darstellung von Daten in einem Dashboard-Element zu steuern. Weitere Informationen zu den Anforderungen für das Erstellen eines interaktiven Kartendiagramms mit der Looker-Benutzeroberfläche finden Sie im Abschnitt Google Maps-Diagramm erstellen auf der Dokumentationsseite Optionen für Kartendiagramme.

model

Mit dem Parameter model wird das Modell definiert, das für die Elementabfrage verwendet werden soll. Wenn nichts angegeben ist, wird standardmäßig das Modell verwendet, in dem sich das Dashboard befindet.

- name: orders_by_date
  model: ecommerce

Für den Parameter model sind LookML-Konstanten zulässig. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann mit der Syntax "@{constant_name}" die Konstante als Wert für model festlegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Modells an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Modells aktualisieren, das von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

explore

In diesem Abschnitt wird auf den Parameter explore verwiesen, der Teil eines Dashboard-Elements ist.

explore kann auch als Teil eines Modells verwendet werden, wie auf der Dokumentationsseite zum Parameter explore beschrieben.

explore kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter explore wird der Explore definiert, der für die Elementabfrage verwendet werden soll.

- name: orders_by_date
  explore: order

Für den Parameter explore sind LookML-Konstanten zulässig. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann mit der Syntax "@{constant_name}" die Konstante als Wert für explore festlegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Explores an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Explores aktualisieren, der von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

fields

Der Parameter fields definiert die Felder, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Felder anzugeben.

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

Wenn Sie den Parameter fields verwenden, müssen Sie die Parameter dimensions und measures nicht verwenden.

dimensions

Mit dem Parameter dimensions werden die Dimensionen definiert, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Geben Sie dimensions nicht an, wenn die Abfrage keine hat.

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

Mit dem Parameter measures werden die Messwerte definiert, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.measure_name, um die Messung anzugeben. Geben Sie measures nicht an, wenn die Abfrage keine hat.

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

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

sorts

Mit dem Parameter sorts wird das Sortierverhalten für die Abfrage des Elements definiert. Geben Sie zuerst das primäre Sortierfeld und dann alle sekundären Sortierfelder an. Verwenden Sie die view_name.field_name-Syntax, um die Dimension oder den Messwert anzugeben, nach dem sortiert werden soll.

Wenn Sie den Parameter sorts weglassen, wird die Standardsortierreihenfolge von Looker verwendet. Für aufsteigende Sortierungen ist kein Suffix erforderlich, für absteigende Sortierungen das Suffix desc.

Im folgenden Beispiel wird eine einzelne Sortierung definiert:

- name: orders_by_date
  sorts: order.order_date desc

Im folgenden Beispiel werden mehrere Sortierungen definiert:

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

Wenn Sie Dimensionen als Drehpunkt festlegen, können Sie Abfrageergebnisse sortieren, indem Sie den Messwertnamen, die Sortierrichtung und die nullbasierte Indexnummer der Zielspalte in der Datentabelle angeben. Im folgenden Beispiel wird nach der ersten Pivot-Spalte sortiert. Dazu wird der Index 0 verwendet:

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

Wenn Sie nach der Zeilensumme sortieren möchten, geben Sie den Index der Spalte mit den Gesamtsummen an. Mit dem folgenden Element wird beispielsweise nach der Zeilensumme sortiert. Dazu wird der Index 2 verwendet, der die Spalte „Summen“ für eine Abfrage mit zwei Pivot-Spalten darstellt:

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

pivots

Mit dem Parameter pivots werden die Dimensionen definiert, die für die Elementabfrage pivotiert werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Geben Sie pivots nicht an, wenn die Abfrage keine hat.

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

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

limit

Der Parameter limit definiert die Zeilenbegrenzung, die für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Zeilen bevor Pivots angewendet werden.

- name: orders_by_date
  limit: 100

column_limit

Der Parameter column_limit definiert das Spaltenlimit, das für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Spalten nach der Anwendung von Pivots.

- name: orders_by_date
  column_limit: 100

filters

In diesem Abschnitt wird auf den Parameter filters verwiesen, der Teil eines Dashboard-Elements ist.

filters kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

filters kann auch als Teil einer Messung verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter filters.

Mit dem Parameter filters werden die unveränderlichen Filter definiert, die für die Abfrage des Elements verwendet werden sollen. Wenn Sie Filter verwenden möchten, die ein Nutzer im Dashboard ändern kann, sollten Sie die Filter mit filters für Dashboards einrichten und sie dann mit listen auf die Elemente anwenden.

Die Syntax für filters lautet:

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

Jeder Filter kann einen Looker-Filterausdruck oder eine Wertkonstante akzeptieren. Sie können auch die Liquid-Variablen _localization oder _user_attributes im Filterausdruck verwenden, um flexible Filterwerte zu erhalten.

listen

Mit Dashboard-Filtern können Betrachter die Daten, die in Dashboard-Elementen angezeigt werden, interaktiv eingrenzen. Definieren Sie Dashboard-Filter mit dem filters-Parameter für LookML-Dashboards. Verwenden Sie dann den Parameter listen, um Dashboard-Elemente mit dem Dashboard-Filter zu verknüpfen.

Die Syntax für listen lautet so:

- 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

Fügen Sie einem Element den Parameter listen hinzu und geben Sie dann den Namen des Filters gefolgt von einem Doppelpunkt und einem Verweis auf das Feld an, auf das der Filter angewendet werden soll. Verwenden Sie dazu die Syntax view_name.field_name. Sie können beispielsweise einen Filter namens Datum erstellen, bei dem ein Nutzer ein Datum in das Filterfeld in der Benutzeroberfläche eingeben muss. Sie können den vom Nutzer eingegebenen Wert dann so auf das orders_by_date-Element anwenden:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Wenn der Filter, auf den gewartet wird, mit dem Parameter vis_filter: true konfiguriert ist, wird das Filtersteuerelement in einer Filterleiste direkt oben auf der Visualisierungskachel und nicht in der oberen Dashboard-Filterleiste angezeigt.

Weitere Beispiele für die Verwendung des Parameters filters und des Parameters listen zum Anwenden von Dashboardfiltern auf einzelne Dashboardelemente finden Sie unter LookML-Dashboards erstellen.

query_timezone

Mit dem Parameter query_timezone wird die Zeitzone angegeben, in der die Abfrage ausgeführt wird. Die Zeitzonenoptionen finden Sie auf der Dokumentationsseite Werte für timezone. Wenn die Abfrage in der Zeitzone des Betrachters ausgeführt werden soll, können Sie den Wert als user_timezone zuweisen.

- name: orders_by_date
  query_timezone: America/Los Angeles
- name: orders_by_customer
  query_timezone: user_timezone

Diagrammparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Diagrammbereich des Visualisierungseditors für Kartendiagramme.

Welche Parameter Sie mit einem Element von type: looker_google_map verwenden können, hängt davon ab, ob Ihre Abfrage eine Dimension vom Typ type: location enthält oder eine Kartenebene zugeordnet ist.

map_plot_mode

Mit dem Parameter map_plot_mode wird festgelegt, wie Ihre Daten in einem type: looker_google_map-Element dargestellt werden, das auf einer Dimension vom Typ type: location basiert. Dieser Parameter ist nicht für Karten verfügbar, die auf einer Dimension mit einer zugehörigen Kartenebene oder für Postleitzahl-Dimensionen basieren. Der Parameter map_plot_mode kann die folgenden Werte haben:

points

Wenn Sie map_plot_mode auf points festlegen, wird jede Zeile in der zugrunde liegenden Datentabelle als diskreter Punkt auf der Karte dargestellt.

Mit einer Dimension vom Typ type: location werden Punkte mit einheitlicher Größe und Farbe auf der Karte platziert. Wenn Sie der Abfrage einen Messwert hinzufügen, können die Punkte mithilfe der Parameter map_marker_radius_mode und map_marker_color_mode nach Farbe oder Größe skaliert werden.

automagic_heatmap

Wenn Sie map_plot_mode auf automagic_heatmap festlegen, werden die Daten in der zugrunde liegenden Abfrage als Heatmap-Raster dargestellt. Dazu wird die sichtbare Karte in gleich große Quadrate unterteilt und dann berechnet, welche Werte in Ihren Daten in jedes Quadrat passen. Die Quadrate werden entsprechend einem von Ihnen ausgewählten Maß eingefärbt. Wenn Sie in diese Karte hinein- oder herauszoomen, wird das Raster in Looker neu berechnet, sodass die Granularität der Zoomstufe entspricht.

Ihre Abfrage muss sowohl eine Dimension vom Typ type: location als auch einen Messwert enthalten, damit dieser Diagrammtyp richtig funktioniert.

heatmap

Wenn Sie map_plot_mode auf heatmap festlegen, wird eine Karte erstellt, auf der eine große Menge an Standortdaten mit vielen eng beieinander liegenden Punkten dargestellt werden kann. Die Farbintensität und die Farbskala geben die Konzentration der Datenpunkte in den einzelnen Bereichen an.

Ihre Abfrage muss eine Dimension von type: location enthalten. Optional können Sie eine Messung hinzufügen.

lines

Wenn Sie map_plot_mode auf lines festlegen, werden zwei Dimensionen von type: location aus Ihrer Abfrage verwendet und in der Visualisierung miteinander verbunden. Wenn Sie Ihrer Abfrage einen Messwert hinzufügen, können Sie den Linien eine Farbskala hinzufügen.

areas

Wenn Sie map_plot_mode auf areas festlegen, wird eine Dimension von type: location verwendet und alle Punkte werden in der Reihenfolge verbunden, in der Sie sie sortiert haben. Damit werden die Grenzen eines Bereichs im Kartenelement festgelegt. Wenn Sie der Abfrage eine Messung hinzufügen, können Sie die Größe und Farbe der einzelnen Standortpunkte formatieren, aus denen die Grenzen des Bereichs bestehen.

heatmap_gridlines

Wenn Sie für Heatmap-Elemente heatmap_gridlines auf true festlegen, wird um jede der für die Heatmap verwendeten Gitternetzlinien ein Rahmen hinzugefügt. Dieser Parameter ist verfügbar, wenn Sie eine Dimension vom Typ type: location mit map_plot_mode auf automagic_heatmap festgelegt darstellen oder eine Postleitzahl-Dimension oder eine Dimension mit einer zugehörigen Kartebene darstellen.


heatmap_gridlines: true | false

heatmap_gridlines_empty

Wenn heatmap_gridlines für Heatmap-Elemente auf true festgelegt ist und Sie Daten mit einem definierten map_layer darstellen, wird durch Festlegen von heatmap_gridlines_empty auf true eine Umrisslinie um die Kartenregionen angezeigt, denen keine Daten zugeordnet sind.


heatmap_gridlines_empty: true | false

heatmap_opacity

Für Heatmap-Elemente können Sie mit heatmap_opacity die Deckkraft der in der Heatmap verwendeten Farben angeben. Geben Sie eine Dezimalzahl zwischen 0 und 1 als Wert für heatmap_opacity an. Dabei bedeutet 0 keine Farbe und 1 vollständig undurchsichtig.


heatmap_opacity: 0.5

Kartenparameter

Die meisten Parameter, die in diesem Abschnitt beschrieben werden, entsprechen den Optionen im Abschnitt Kartenmenüoptionen des Visualisierungseditors für Säulendiagramme.

map_tile_provider

Der Parameter map_tile_provider ist für alle Karten verfügbar. Damit können Sie den Typ der Hintergrundkarte ändern und festlegen, ob Kartenlabels (z. B. für Städte und Straßen) angezeigt werden.

  • light: Eine dezente, hell gefärbte Karte, die geografischen Kontext bietet und gleichzeitig Ihre Daten hervorhebt.
  • light_no_labels: Wie light, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
  • dark: Eine dezente, dunkelfarbige Karte, die geografischen Kontext bietet und gleichzeitig Ihre Daten hervorhebt.
  • dark_no_labels: Wie dark, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
  • satellite_streets: Karte mit globalen Satelliten- und Luftbildern
  • satellite: Wie satellite_streets, nur dass auf der Karte keine Labels wie Städtenamen angezeigt werden.
  • streets: Eine Karte für allgemeine Zwecke, bei der die Darstellung von Straßen- und Verkehrsnetzen gut lesbar ist.
  • outdoors: Karte für allgemeine Zwecke, zugeschnitten auf Wandern, Radfahren und andere Outdoor-Aktivitäten
  • traffic_day: Helle Karte mit Schwerpunkt auf ÖPNV-Netzen und Straßen, einschließlich aktueller Verkehrsinformationen
  • traffic_night: Dunkle Karte mit Schwerpunkt auf Verkehrsnetzen und Straßen, einschließlich aktueller Verkehrsinformationen
  • minimal: Helle Karte ohne Labels oder Grenzlinien

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

map_position

Mit dem Parameter map_position können Sie den Zentralpunkt und die Zoomstufe der sichtbaren Karte festlegen. Es gibt zwei Möglichkeiten, diese Position anzugeben:

  • fit_data: Die Karte wird automatisch zentriert und gezoomt, sodass alle Datenpunkte Ihrer Abfrage sichtbar sind.
  • custom: Hiermit können Sie Breiten- und Längengrad sowie die Zoomstufe manuell mit den Parametern map_latitude, map_longitude und map_zoom angeben.

map_position: fit_data | custom

map_latitude

Mit dem Parameter map_latitude wird der Breitengrad für ein Kartenelement angegeben, bei dem map_position auf custom festgelegt ist.


map_latitude: -5.804047131379801

map_longitude

Mit dem Parameter map_longitude wird der Längengrad für ein Kartenelement angegeben, bei dem map_position auf custom festgelegt ist.


 map_longitude: 113.34732055664064

map_zoom

Mit dem Parameter map_zoom können Sie die Zoomstufe für ein Kartenelement festlegen, bei dem map_position auf custom gesetzt ist. Höhere Zahlen erzeugen eine nähere Zoomstufe.


map_zoom: 10

map_scale_indicator

Der Parameter map_scale_indicator ist standardmäßig auf 'off' festgelegt. Damit können Sie angeben, ob ein Kartenmaßstab angezeigt werden soll, und die angezeigten Einheiten festlegen.


map_scale_indicator: 'off' | metric | imperial | metric_imperial

map_pannable

Mit dem Parameter map_pannable wird angegeben, ob Nutzer die Karte durch Ziehen neu positionieren können. Diese Option ist standardmäßig aktiviert.


map_pannable: true | false

map_zoomable

Mit dem Parameter map_zoomable wird angegeben, ob Nutzer in das Kartenelement hinein- und herauszoomen können. Diese Option ist standardmäßig aktiviert.


map_zoomable: true | false

show_view_names

Mit dem Parameter show_view_names wird angegeben, ob der Ansichtsname zusammen mit dem Feldnamen in Karten-Kurzinfos angezeigt werden soll. Diese werden eingeblendet, wenn Nutzer auf Kartendatenpunkte klicken.


show_view_names: true | false

show_legend

Geben Sie an, ob unten rechts in der Visualisierung eine Kartenlegende angezeigt werden soll. In der Legende wird die Farbskala angezeigt, die Sie verwenden, wenn Sie Ihrer Visualisierung einen Messwert hinzugefügt haben.

Der Parameter show_legend ist verfügbar, wenn die folgenden Diagrammoptionen angegeben wurden:


show_legend: true | false

show_region_field

Bei Karten, die auf einer Kartenebene oder einem Postleitzahlgebiet basieren, werden mit dem Parameter show_region_field die Informationen in der Kurzinfo der Karte angezeigt. Nutzer können auf einen Punkt auf der Karte klicken, um den Namen der Region zu sehen.


show_region_field: true | false

draw_map_labels_above_data

Bei Karten mit Kartenebenen oder Karten, die auf einer Dimension für Postleitzahlen basieren, können Sie mit dem Parameter draw_map_labels_above_data die Labels der Karte ober- oder unterhalb der Heatmap anzeigen lassen. Das ist besonders bei höheren Deckkraftwerten für Heatmaps der Fall. Wenn Ihre Heatmap undurchsichtig ist, werden die Labels nur angezeigt, wenn sie über den Daten dargestellt werden.


draw_map_labels_above_data: true | false

Punktparameter

Punktoptionen sind für Karten mit map_plot_mode, die auf automagic_heatmap oder heatmap festgelegt ist, nicht verfügbar.

map_marker_type

Bei Karten, die auf einer Standortdimension basieren und für die map_plot_mode auf points, lines oder areas festgelegt ist, wird mit dem Parameter map_marker_type der Typ des Punkts definiert, der für das Kartenelement angezeigt wird. Der Parameter map_marker_type kann die folgenden Werte haben:

  • circle
  • icon
  • circle_and_icon
  • none

Der für map_marker_type angegebene Wert wirkt sich auf die Parameter aus, die zum Formatieren der auf der Karte angezeigten Punkte verfügbar sind.

map_marker_icon_name

Wenn map_marker_type auf icon oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_icon_name den Typ des Symbols festlegen, das für alle Kartenmarkierungen angezeigt werden soll.


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

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_radius_mode die Größen der Kreise entsprechend den folgenden Optionen festlegen:

  • proportional_value: Mit dieser Option wird die relative Größe der Kreise an die Messwerte angepasst, die Sie der Abfrage hinzugefügt haben. Mit dieser Option können Sie mithilfe der Parameter map_marker_radius_min und map_marker_radius_max einen Mindest- und einen Höchstradius für die Kreise festlegen. Mit dem Parameter map_marker_proportional_scale_type können Sie auch festlegen, ob die Kreise mit einer linearen oder einer logarithmischen Skala skaliert werden.
  • equal_to_value: Mit dieser Einstellung wird der Radius der Kreise an die tatsächlichen Messwerte in der zugrunde liegenden Abfrage angepasst.
  • fixed: Mit dieser Option können Sie einen festen Radius festlegen, der mit dem Parameter map_marker_radius_fixed auf alle Kartenmarkierungen angewendet wird. Der Standardwert ist 500.

map_marker_radius_mode: proportional_value | equal_to_value | fixed

map_marker_radius_fixed

Wenn map_marker_radius_mode auf fixed und map_marker_type auf circle oder circle_and_icon festgelegt ist, können Sie mit dem Parameter map_marker_radius_fixed einen festen Radius festlegen, der für alle Kartenmarkierungen gilt.


map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60

map_marker_radius_min

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_radius_min den Mindestradius für einen Kreis definieren.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5

map_marker_radius_max

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_radius_max den maximalen Radius für einen Kreis definieren.


map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50

map_marker_proportional_scale_type

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon und map_marker_radius_mode auf proportional_value festgelegt ist, können Sie mit dem Parameter map_marker_proportional_scale_type festlegen, ob die Kreisgröße auf einer linearen oder einer logarithmischen Skala basieren soll. Der Wert dieses Parameters kann linear oder log sein.


map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log

map_marker_units

Bei Karten, bei denen map_marker_type auf circle oder circle_and_icon gesetzt ist, können Sie mit dem Parameter map_marker_units die Einheiten für den Radius eines Kreises auf meters oder pixels festlegen.


map_marker_units: meters | pixels

map_marker_color_mode

Mit map_marker_color_mode können Sie die Farben der Kartenmarkierungen festlegen:

  • Wenn map_marker_color_mode auf value festgelegt ist, werden Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch Farben zugewiesen. Mit Wertparametern können Sie die Farben in der Legende für diese Option konfigurieren.
  • Wenn map_marker_color_mode auf fixed festgelegt ist, können Sie mit dem Parameter map_marker_color eine einzelne Farbe für alle Kartenmarkierungen festlegen.

map_marker_color

Wenn map_marker_color_mode auf fixed festgelegt ist, wird mit map_marker_color_mode eine einzelne Farbe für alle Kartenmarkierungen festgelegt. Der Farbwert kann als RGB-Hexadezimalstring wie 2ca6cd oder als CSS-Farbname wie mediumblue formatiert werden.


map_marker_color: [mediumblue]

Wertparameter

Mit diesen Parametern können Sie die Farben konfigurieren, die Markierungen basierend auf den Werten der zugrunde liegenden Abfrage dynamisch zugewiesen werden, wenn map_marker_color_mode auf value festgelegt ist. Das gilt auch für Kartenelemente, bei denen map_plot_mode auf automagic_heatmap, heatmap, lines oder areas festgelegt ist.

map_value_colors

Mit dem Parameter map_value_colors können Sie die Farbe von Kartenpunkten festlegen oder, wenn Sie die Farben anhand eines Messwerts codieren, den zu verwendenden Farbbereich definieren. Sie können eine Liste von Hexadezimalstrings wie #2ca6cd oder CSS-Farbnamen wie mediumblue eingeben. Die Farben, die Sie zuerst auflisten, sind den niedrigsten Werten zugeordnet.


map_value_colors: [green, mediumblue]

quantize_map_value_colors

Wenn true festgelegt ist, ändert quantize_map_value_colors die Farbskala von einem stufenlosen Farbverlauf zu den von Ihnen festgelegten Farben. Dieser Parameter ist standardmäßig auf false festgelegt.


quantize_map_value_colors: true | false

reverse_map_value_colors

Wenn der Parameter auf true festgelegt ist, werden die Farben, die hohe und niedrige Werte im Diagramm angeben, durch den Parameter reverse_map_value_colors getauscht. Dadurch wird der Farbverlauf umgekehrt.


reverse_map_value_colors: true | false

map_value_scale_clamp_min

Mit dem Parameter map_value_scale_clamp_min können Sie den Mindestwert für den Farbbereich festlegen. So können Sie alle Punkte unter einem bestimmten Schwellenwert (der angegebenen Zahl) mit der niedrigsten Farbe codieren, die mit dem Parameter map_value_colors angegeben wurde. Standardmäßig ist der Mindestwert, der auf die Legende angewendet wird, der Mindestwert aus Ihrer Abfrage.


map_value_scale_clamp_min: 1000

map_value_scale_clamp_max

Mit dem Parameter map_value_scale_clamp_max können Sie den Maximalwert für den Farbbereich festlegen. So können Sie alle Punkte, die über der mit dem Parameter map_value_colors angegebenen Zahl liegen, mit der höchsten Farbe codieren. Standardmäßig ist der Höchstwert, der auf die Legende angewendet wird, der Höchstwert aus Ihrer Abfrage.


map_value_scale_clamp_max: 50000