このページでは、dashboard.lkml ファイルで LookML ダッシュボード パラメータを使用して type: looker_map の LookML ダッシュボード要素を作成および編集するためのパラメータについて説明します。
Looker UI を使用してインタラクティブなマップグラフを作成する方法については、マップグラフのオプションのドキュメント ページをご覧ください。インタラクティブ マップグラフの作成に必要なフィールドの種類については、クエリ パラメータのセクションをご覧ください。
使用例
N は、数値が必要であることを示します。単一引用符は説明文を示しており、ライブコードに含めるべきではありません。
## 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
パラメータの定義
| パラメータ名 | 説明 | |
|---|---|---|
| 基本パラメータ | ||
name（要素の場合） |
要素を作成する | |
title（要素の場合） |
ユーザーに表示される要素名の表示方法を変更します | |
type（要素の場合） |
要素で使用する可視化のタイプを決定します | |
height（要素の場合） |
layout: tile ダッシュボードと layout: static ダッシュボードの要素の高さを tile_size 単位で定義します |
|
width（要素の場合） |
layout: tile ダッシュボードと layout: static ダッシュボードの要素の幅を tile_size 単位で定義します |
|
top |
layout: static ダッシュボードの要素の上から下の位置を tile_size 単位で定義します |
|
left |
layout: static ダッシュボードの要素の左から右への位置を tile_size 単位で定義します |
|
row |
layout: newspaper ダッシュボードの要素の上から下の位置を、行単位で定義します |
|
col |
layout: newspaper ダッシュボードの要素の左から右への位置を列単位で定義します |
|
refresh（要素の場合） |
要素が自動的に更新される間隔を設定します | |
note |
要素のメモを定義するために、LookML セクションを開始します。このパラメータには、サブパラメータtext、state、およびdisplayがあります。 |
|
| クエリ パラメータ | ||
model |
要素のクエリに使用するモデルを定義します | |
explore（要素の場合） |
要素のクエリに使用する Explore を定義します | |
fields |
要素のクエリに使用するフィールドを定義します。これは dimensions と measures の代わりに使用できます。 |
|
dimensions |
要素のクエリに使用するディメンションを定義します | |
measures |
要素のクエリで使用する指標を定義します | |
sorts |
要素のクエリに使用する並べ替えを定義します | |
pivots |
要素のクエリに使用するためにピボットするディメンションを定義します | |
limit |
要素のクエリに使用する行制限を定義します | |
column_limit |
要素のクエリに使用する列の上限を定義します | |
filters（要素の場合） |
要素のクエリで変更できないフィルタを定義します。 | |
listen |
filters（ダッシュボードの場合）が作成されている場合に、要素のクエリで変更できるフィルタを定義します。 |
|
query_timezone |
クエリの実行時に使用するタイムゾーンを定義します | |
| プロット パラメータ | ||
map_plot_mode |
位置データがtype: looker_mapの要素上にどのようにプロットされるかを定義します |
|
heatmap_gridlines |
ヒートマップ要素に使用される各グリッド線の周囲に境界線を追加します。 | |
heatmap_gridlines_empty |
heatmap_gridlines が true に設定されているヒートマップの場合、関連データがないマップ領域の周囲にアウトラインを表示します。 |
|
heatmap_opacity |
ヒートマップで使用される色の不透明度を定義します。 | |
| マップ パラメータ | ||
map_tile_provider |
背景マップの種類とマップラベルの表示の有無を定義します。 | |
map_position |
表示される地図の中心点とズームレベルを定義します。 | |
map_latitude |
map_position を custom に設定したマップの緯度を定義します。 |
|
map_longitude |
map_position を custom に設定したマップの経度を定義します。 |
|
map_zoom |
map_position が custom に設定されている地図のズームを定義します |
|
map_scale_indicator |
マップ スケールを表示するかどうかと、表示する単位の種類を設定します | |
map_pannable |
ユーザーが地図をドラッグして移動できるかどうかを設定します | |
map_zoomable |
ユーザーが地図をズームイン、ズームアウトできるかどうかを設定します | |
show_view_names |
地図のツールチップにビューの名前とフィールド名を表示するかどうかを設定します | |
show_legend |
地図の凡例をビジュアリゼーションの右下に表示するかどうかを設定します | |
show_region_field |
地図のツールチップにリージョン情報を表示するかどうかを設定します | |
draw_map_labels_above_data |
ヒートマップの上または下にマップのラベルを表示します | |
| ポイント パラメータ | ||
map_marker_type |
map_plot_mode が points、lines、areas に設定されている要素について、地図に表示されるポイントのタイプを指定します。 |
|
map_marker_icon_name |
map_marker_type が icon または circle_and_icon に設定されている要素のすべての地図上のマーカーに表示するアイコンの種類を指定します。 |
|
map_marker_radius_mode |
map_marker_type が circle または circle_and_icon に設定されている要素のバブルのサイズ設定方法を設定します |
|
map_marker_radius_fixed |
map_marker_type が circle または circle_and_icon に設定され、map_marker_radius_mode が fixed に設定されている要素のすべての地図マーカーに適用する固定半径を設定します。 |
|
map_marker_radius_min |
map_marker_radius_mode が proportional_value に設定されている要素の円の最小半径を設定します |
|
map_marker_radius_max |
map_marker_radius_mode が proportional_value に設定されている要素の円の最大半径を設定します |
|
map_marker_proportional_scale_type |
map_marker_type が circle または circle_and_icon に設定され、map_marker_radius_mode が proportional_value に設定されている要素について、円のサイズが線形スケールと対数スケールのどちらに基づくかを指定します。 |
|
map_marker_units |
map_marker_type が circle または circle_and_icon に設定されている要素について、円の半径に使用される単位を meters または pixels に設定します。 |
|
map_marker_color_mode |
地図マーカーの色を固定するか、基となるクエリの値に基づいてマーカーに動的に色を割り当てるかを指定します。 | |
map_marker_color |
map_marker_color_mode が fixed に設定されている要素のすべての地図マーカーに適用する単一の色を指定します。 |
|
| 値パラメータ | ||
map_value_colors |
地図上の地点の色を指定します。または、指標に従って色分けを行う場合に使用する色の範囲を定義します。 | |
quantize_map_value_colors |
カラースケールがスムーズなグラデーションから設定済みの特定の色のみに変わります。 | |
reverse_map_value_colors |
グラフの最大値と最小値を示す色が切り替わり、カラー グラデーションが逆になります。 | |
map_value_scale_clamp_min |
色の範囲の最小値を設定します | |
map_value_scale_clamp_max |
色範囲の最大値を設定します | |
基本パラメータ
LookML ダッシュボードの要素を定義する場合は、少なくとも name と type の基本パラメータの値を指定する必要があります。title、height、widthなどのその他の基本パラメータは、ダッシュボード上の要素の外観と位置に影響を与えます。
name
このセクションでは、ダッシュボード要素の一部である
nameパラメータについて説明します。
nameは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
各 name 宣言は、新しいダッシュボード要素を作成し、名前を割り当てます。要素名は一意である必要があります。layout: grid ダッシュボードを使用している場合、名前は elements パラメータで参照されることがあります。
- name: orders_by_date
title
このセクションでは、ダッシュボード要素の一部である
titleパラメータについて説明します。
titleは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
titleは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
title パラメータを使用すると、要素の名前がユーザーにどのように表示されるかを変更できます。指定しない場合、タイトルはデフォルトで要素 name になります。
次の例を考えてみましょう。
- name: sales_overview
title: '1) Sales Overview'
この形式を使用した場合、要素は [Sales Overview] ではなく [1) Sales Overview] と表示されます。
type
このセクションでは、ダッシュボード要素の一部である
typeパラメータについて説明します。
typeは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
typeは、type（結合の場合）パラメータのドキュメント ページで説明されているように、結合の一部としても使用できます。
typeは、ディメンション、フィルタ、パラメータ タイプに関するドキュメント ページで説明されているように、ディメンションの一部としても使用できます。
typeは、メジャーの型のドキュメント ページで説明されているように、メジャーの一部としても使用できます。
type パラメータは、要素で使用するビジュアリゼーションのタイプを決定します。
- 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
さまざまな種類の LookML ダッシュボード要素の概要については、type（LookML ダッシュボードの場合）のドキュメント ページをご覧ください。
height
このセクションでは、ダッシュボード要素の一部である
heightパラメータについて説明します。
heightは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード行の一部としても使用できます。
tile または static レイアウトのダッシュボードの場合
height パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の高さを tile_size 単位（ピクセル単位で定義）で定義します。
たとえば、次のコードでは tile_size: 100 と height: 4 を指定し、orders_by_date 要素の高さを 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
newspaper レイアウトのダッシュボードの場合
height パラメータは、layout: newspaper ダッシュボードの要素の高さを row 単位で定義します。
新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行（約 300 ピクセル）になります。preferred viewer パラメータが dashboards-next に設定されているダッシュボードの最小の高さは 1 行です。最小の高さは、preferred viewer パラメータが dashboards に設定されているダッシュボードの場合、2 行です。
たとえば、次のコードでは、要素を 12 行の高さに設定します。これは、デフォルトに設定されている他の要素の 2 倍の高さです。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
このセクションでは、ダッシュボード要素の一部である
widthパラメータについて説明します。
widthは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
width パラメータは、layout: tile ダッシュボードと layout: static ダッシュボードの要素の幅を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と width: 4 を指定し、orders_by_date 要素の幅を 400 ピクセルにしています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
width パラメータは、layout: newspaper ダッシュボードの要素の幅を列単位で定義します。
新聞レイアウトのダッシュボードのデフォルトの幅は 24 列です。
たとえば、次のコードは、要素をダッシュボードの幅の半分に設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
top パラメータは、layout: static ダッシュボードの要素の上から下の位置を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と top: 4 を指定し、orders_by_date 要素の上端をダッシュボードの上端から 400 ピクセル離して配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
left パラメータは、layout: static ダッシュボードの要素の左から右への位置を tile_size 単位で定義します。
たとえば、次のコードでは tile_size: 100 と left: 4 を指定し、orders_by_date 要素の左端をダッシュボードの左端から 400 ピクセル離して配置しています。
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
layout: newspaper ダッシュボードの場合、row パラメータは要素の上端が配置される行を定義します。
ダッシュボードは、ダッシュボードの上部にある行 0 から始まります。新聞レイアウトのダッシュボードでは、要素の高さはデフォルトで 6 行になります。つまり、ダッシュボードの上部にあるダッシュボード要素（row: 0）は、デフォルトで 0 ～ 5 行を占有します。
各行の高さは 50 ピクセルです。つまり、6 行のデフォルトの要素の高さは 300 ピクセルです。
たとえば、次のコードは、要素がデフォルトの高さに設定されていると仮定して、ダッシュボードの 2 行目の要素に設定される要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
layout: newspaper ダッシュボードの場合、col パラメータは要素の左端が配置される列を定義します。
ダッシュボードは 24 列に分割されます。ダッシュボードは、ダッシュボードの左側の列 0 から始まります。新聞レイアウトのダッシュボードでは、要素の幅はデフォルトで 8 列になります。つまり、ダッシュボードの左側にあるダッシュボード要素（col: 0）は、デフォルトで 0 ～ 7 列を占有します。
たとえば、次のコードでは、ダッシュボードの 3 列目の要素に設定される要素を設定します。
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
このセクションでは、ダッシュボード要素の一部である
refreshパラメータについて説明します。
refreshは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
refresh パラメータを使用すると、要素を定期的に自動で再読み込みして、最新のデータを取得できます。これは、オフィスのテレビなど、ダッシュボードが常に表示される設定で役立ちます。このパラメータを有効にするには、ダッシュボードがブラウザ ウィンドウで開いている必要があります。この設定は、ダッシュボードのキャッシュを「事前ウォーミング」するためにバックグラウンドで実行されません。
更新頻度は、秒、分、時間、日の任意の整数値で指定できます。次に例を示します。
- name: orders_by_date
refresh: 2 hours
短い更新間隔を設定する場合は注意してください。要素の背後にあるクエリがリソースを大量に消費する場合、特定の要素がデータベースに過度の負荷をかける可能性があります。
note
次のように、要素に説明用のメモを追加できます。
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note には、text、state、display のサブパラメータがあります。
text
text サブパラメータは、メモに表示されるテキストを指定します。テキストはローカライズできます。
state
state サブパラメータは、要素の幅内の 1 行に収まらない場合に、メモを collapsed にするか expanded にするかを決定します。collapsed を選択した場合、メモが長すぎると、メモの末尾にクリック可能な省略記号（...）が表示され、メモ全体を読むことができます。
display
display サブパラメータは、要素のどこにメモを表示するかを決定します。above は要素の上部に注釈を配置し、below は要素の下部に注釈を配置します。hover では、ユーザーが要素にマウス カーソルを合わせると注釈が表示されます。
クエリ パラメータ
LookML ダッシュボード要素を定義する際には、少なくともmodelおよびexploreクエリパラメータの値を指定する必要があります。
LookML ダッシュボード要素type: looker_mapの場合、dimensionsまたはfieldsパラメーターの値として、少なくとも 1 つの地理フィールドを指定する必要があります。地理情報フィールドは次のいずれかになります。
- 緯度と経度データに基づく次元で、LookML では
type: locationの次元として定義されます。 - 地図のレイヤが割り当てられたディメンション。LookML 開発者は、
map_layer_nameパラメーターを使用して、組み込みマップレイヤーまたはカスタムマップレイヤーをメジャーに追加できます。 - 郵便番号の次元。郵便番号領域は、2010 年の郵便番号集計エリア（ZCTA）に基づいています。郵便番号を視覚化する場合、郵便番号と地図表示に使用される ZCTA（郵便番号地域）との間に 1 対 1 の対応関係がない可能性があるため、地図上にすべての地点が視覚化されない可能性があります。
その他のクエリパラメータを使用すると、ダッシュボード要素におけるデータの表示方法を制御できます。Looker UI を使用してインタラクティブなマップチャートを作成するための要件の詳細については、以下を参照してください。インタラクティブな地図チャートを作成するセクション地図チャートのオプションドキュメントページ。
model
model パラメータは、要素クエリに使用するモデルを定義します。指定しない場合、デフォルトでダッシュボードが存在するモデルが使用されます。
- name: orders_by_date
model: ecommerce
model パラメータは LookML 定数を受け取ります。プロジェクトのマニフェスト ファイルで定数を定義し、構文 "@{constant_name}" を使用して、定数を model の値として設定できます。定数を使用すると、モデルの名前を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されているモデルの名前を更新する場合に特に便利です。
LookML ダッシュボードで定数を使用する方法の詳細と例については、constant パラメータのドキュメント ページをご覧ください。
explore
このセクションでは、ダッシュボード要素の一部である
exploreパラメータについて説明します。
exploreは、exploreパラメータのドキュメント ページで説明されているように、モデルの一部としても使用できます。
exploreは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。
explore パラメータは、要素クエリに使用する Explore を定義します。
- name: orders_by_date
explore: order
explore パラメータは LookML 定数を受け取ります。プロジェクトのマニフェスト ファイルで定数を定義し、構文 "@{constant_name}" を使用して、定数を explore の値として設定できます。定数を使用すると、Explore の名前を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されている Explore の名前を更新する場合に特に便利です。
LookML ダッシュボードで定数を使用する方法の詳細と例については、constant パラメータのドキュメント ページをご覧ください。
fields
fields パラメータは、要素クエリに使用するフィールドを定義します。フィールドを指定するには、構文 view_name.dimension_name を使用します。
## 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]
fields パラメータを使用する場合、dimensions パラメータと measures パラメータは使用する必要がありません。
dimensions
dimensions パラメータは、要素クエリに使用するディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。クエリにない場合は、dimensions を含めないでください。
## 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
measures パラメータは、要素クエリに使用するメジャーを定義します。view_name.measure_name 構文を使用して、指標を指定します。クエリにない場合は、measures を含めないでください。
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
sorts パラメータは、要素のクエリの並べ替え動作を定義します。最初にプライマリ ソート フィールドをリストし、次にセカンダリ ソート フィールドをリストします。view_name.field_name 構文を使用して、並べ替えの基準となるディメンションまたは指標を指定します。
sorts パラメータを省略すると、要素は Looker のデフォルトの並べ替え順序を使用します。昇順の並べ替えには接尾辞は必要ありませんが、降順の並べ替えには desc 接尾辞が必要です。
次の例では、単一の並べ替えを定義しています。
- name: orders_by_date
sorts: order.order_date desc
次の例では、複数の並べ替えを定義しています。
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
ディメンションをピボットすると、メジャー名、並べ替えの方向、データテーブル内のターゲット列の 0 ベースのインデックス番号を指定して、クエリ結果を並べ替えることができます。たとえば、次の要素は、インデックス 0 を使用して最初のピボット列で並べ替えます。
- name: orders_by_category
sorts: [orders.count desc 0]
行の合計で並べ替えるには、合計列のインデックスを指定します。たとえば、次の要素は、2 つのピボット列を含むクエリの合計列を表すインデックス 2 を使用して、行の合計で並べ替えます。
- name: orders_by_cohort
sorts: [users.count desc 2]
pivots
pivots パラメータは、要素クエリでピボットされるディメンションを定義します。ディメンションを指定するには、構文 view_name.dimension_name を使用します。クエリにない場合は、pivots を含めないでください。
## single pivot example
- name: orders_by_date
pivots: customer.gender
## multiple pivot example
- name: orders_by_date
pivots: [customer.gender, customer.age_tier]
limit
limit パラメータは、要素クエリに使用する行の上限を定義します。この上限は、ピボットが適用される前の行数に適用されます。
- name: orders_by_date
limit: 100
column_limit
column_limit パラメータは、要素クエリに使用する列の上限を定義します。この上限は、ピボットが適用された後の列数に適用されます。
- name: orders_by_date
column_limit: 100
filters
このセクションでは、ダッシュボード要素の一部である
filtersパラメータについて説明します。
filtersは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボードの一部としても使用できます。
filtersは、filtersパラメータのドキュメント ページで説明されているように、メジャーの一部としても使用できます。
filters パラメータは、要素のクエリに使用する変更不可のフィルタを定義します。ユーザーがダッシュボードで変更できるフィルタが必要な場合は、ダッシュボード用の filters を使用してフィルタを設定し、listen を使用して要素に適用する必要があります。
filters の構文は次のとおりです。
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
各フィルタには、Looker のフィルタ式または値定数を指定できます。柔軟なフィルタ値のフィルタ式で _localization または _user_attributes Liquid 変数を使用することもできます。
listen
ダッシュボード フィルタを使用すると、ダッシュボードの要素に表示されるデータをインタラクティブに絞り込むことができます。LookML ダッシュボードの filters パラメータを使用して、ダッシュボード フィルタを定義します。次に、listen パラメータを使用して、ダッシュボード要素をダッシュボード フィルタにリンクします。
listen の構文は次のとおりです。
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
要素に listen パラメータを追加し、フィルタの名前、コロン、フィルタを適用するフィールドの参照を view_name.field_name 構文で指定します。たとえば、ユーザーが UI のフィルタ フィールドに日付を入力する必要がある [日付] というフィルタを作成できます。ユーザーが入力した値を orders_by_date 要素に適用するには、次のようにします。
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
filters パラメータと listen パラメータを使用してダッシュボード フィルタを個々のダッシュボード要素に適用するその他の例については、LookML ダッシュボードの作成をご覧ください。
query_timezone
query_timezone パラメータは、クエリが実行されるタイムゾーンを指定します。タイムゾーン オプションについては、timezone の値のドキュメント ページをご覧ください。ビューアのタイムゾーンを使用してクエリを実行する場合は、値を user_timezone として割り当てます。
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
プロット パラメータ
このセクションで説明するパラメータは、地図グラフのビジュアリゼーション エディタの [プロット] セクションのオプションに対応しています。
type: looker_map の要素で使用できるパラメータは、クエリに type: location のディメンションが含まれているか、関連付けられた地図のレイヤがあるかによって異なります。
map_plot_mode
map_plot_mode パラメータは、type: location のディメンションに基づいて type: looker_map 要素にデータをプロットする方法を定義します。このパラメータは、関連付けられた地図のレイヤを持つディメンションに基づく地図や、郵便番号ディメンションでは使用できません。map_plot_mode パラメータは次の値を受け入れます。
points
map_plot_mode を points に設定すると、基礎となるデータテーブルの各行が個別のポイントとしてマップ上にプロットされます。
type: location のディメンション単独では、均一のサイズと色のポイントを地図上に配置します。クエリに measure を追加すると、map_marker_radius_mode パラメータと map_marker_color_mode パラメータを使用して、ポイントを色またはサイズごとにスケーリングできます。
automagic_heatmap
map_plot_mode を automagic_heatmap に設定すると、基盤となるクエリのデータがヒートマップ グリッドとして表示されます。これは、表示可能な地図を等しい正方形に分割し、データ内のどの値が各正方形に収まるかを計算することによって機能します。正方形は、選択した measure に応じて色付けされています。このマップをズームインまたはズームアウトすると Looker はグリッドを再計算するため、粒度はズームレベルに適したものになります。
このプロットタイプを正しく機能させるには、クエリに type: location のディメンションとメジャーの両方を含める必要があります。
lines
map_plot_mode を lines に設定すると、クエリから type: location の 2 つのディメンションが取得され、ビジュアリゼーションでそれらが結合されます。クエリに measure を追加すると、線にカラースケールを追加できます。
areas
map_plot_mode を areas に設定すると、type: location の 1 つのディメンションが取得され、すべてのポイントが並べ替えた順序で接続されます。これにより、地図要素のエリアの境界が形成されます。クエリにメジャーを追加すると、その領域の境界を構成する個々の位置ポイントのサイズと色をフォーマットできます。
heatmap_gridlines
ヒートマップ要素の場合、heatmap_gridlines を true に設定すると、ヒートマップに使用する各グリッド線の周囲に枠線が追加されます。このパラメータは、map_plot_mode が automagic_heatmap に設定されている type: location のディメンションをプロットする場合、または郵便番号ディメンションや地図のレイヤが関連付けられているディメンションをプロットする場合に使用できます。
heatmap_gridlines: true | false
heatmap_gridlines_empty
ヒートマップ要素の heatmap_gridlines が true に設定されている場合、heatmap_gridlines_empty を true に設定すると、関連付けられたデータがない地図領域の周囲に枠線が表示されます。
heatmap_gridlines_empty: true | false
heatmap_opacity
ヒートマップ要素の場合、heatmap_opacity を使用して、ヒートマップで使用される色の不透明度を指定できます。heatmap_opacity の値として 0 ～ 1 の数値を指定します。0 は色なし、1 は完全に不透明であることを意味します。
heatmap_opacity: 0.5
マップ パラメータ
このセクションで説明するパラメータのほとんどは、縦棒グラフのビジュアリゼーション エディタの [地図] セクションのオプションに対応しています。
map_tile_provider
すべての地図で使用できる map_tile_provider パラメータを使用すると、背景地図の種類を変更したり、地図ラベル（都市や通りなど）を表示するかどうかを指定したりできます。
light: データをハイライト表示しながら、地理的な背景を説明するように設計された、明るい色の地図light_no_labels:lightと同じですが、地図には都市名などのラベルが表示されませんdark: データをハイライト表示しながら、地理的な背景を説明するように設計された、暗い色の濃い地図dark_no_labels:darkと同じですが、地図には都市名などのラベルが表示されませんsatellite_streets: 全世界の衛星と航空画像を表示する地図satellite:satellite_streetsと同じですが、地図には都市名などのラベルが表示されませんstreets: 道路や交通網の読みやすさを重視した汎用の地図outdoors: ハイキングやサイクリング、その他のアウトドア用の汎用の地図traffic_day: 現在の交通情報など、交通網と道路に焦点を当てた明るい色の地図traffic_night: 現在の交通情報など、交通網と道路に焦点を当てた暗い色の地図
map_tile_provider: light | light_no_labels | dark | dark_no_labels | satellite_streets |
satellite | streets | outdoors | traffic_day | traffic_night
map_position
map_position パラメータを使用すると、表示される地図の中心点とズームレベルを設定できます。この位置を指定するには、次の 2 つの方法があります。
fit_data: クエリのすべてのデータポイントが表示されるように、地図を自動的にセンタリングおよびズームしますcustom:map_latitude、map_longitude、map_zoomパラメータを使用して、緯度、経度、ズームレベルを手動で指定できます。
map_position: fit_data | custom
map_latitude
map_latitude パラメータは、map_position が custom に設定されている地図要素の緯度を指定します。
map_latitude: -5.804047131379801
map_longitude
map_longitude パラメータは、map_position が custom に設定されている地図要素の経度を指定します。
map_longitude: 113.34732055664064
map_zoom
map_zoom パラメータを使用すると、map_position が custom に設定されている地図要素のズームレベルを指定できます。数値が大きいほど、ズームレベルが大きくなります。
map_zoom: 10
map_scale_indicator
デフォルトでは 'off' に設定されています。map_scale_indicator パラメータを使用すると、マップ スケールを表示するかどうかを指定し、表示する単位の種類を設定できます。
map_scale_indicator: 'off' | metric | imperial | metric_imperial
map_pannable
map_pannable パラメータは、ユーザーが地図をドラッグして移動できるかどうかを指定します。このオプションはデフォルトで有効になっています。
map_pannable: true | false
map_zoomable
map_zoomable パラメータは、ユーザーがマップ要素を拡大縮小できるかどうかを指定します。このオプションはデフォルトで有効になっています。
map_zoomable: true | false
show_view_names
show_view_names パラメータは、ユーザーがマップデータポイントをクリックしたときに表示されるマップツールチップに、フィールド名とともにビュー名を表示するかどうかを指定します。
show_view_names: true | false
show_legend
視覚化の右下に地図凡例を表示するかどうかを指定します。凡例には、視覚化にメジャーを追加した場合に使用しているカラースケールが表示されます。
show_legend パラメータは、以下の プロットオプション が指定されている場合に使用できます。
map_plot_modeがautomagic_heatmapに設定された場合map_plot_modeがpointsに設定され、map_marker_color_modeがvalueに設定された場合
show_legend: true | false
show_region_field
地図レイヤーまたは郵便番号に基づく地図の場合、show_region_field パラメータは地図のツールチップに情報を表示します。ユーザーは地図上の地点をクリックすると、その地域の名前を確認できます。
show_region_field: true | false
draw_map_labels_above_data
マップレイヤーマップや郵便番号ディメンションに基づくマップの場合、draw_map_labels_above_data パラメーターを使用して、マップのラベルをヒートマップの上または下に表示できます。これは、ヒートマップの不透明度の値が高い場合に特に重要です。ヒートマップが不透明な場合、ラベルはデータの上に表示されない限り表示されません。
draw_map_labels_above_data: true | false
点パラメータ
map_plot_mode が automagic_heatmap に設定されているマップでは、ポイントオプションは利用できません。
map_marker_type
位置ディメンションに基づくマップで、map_plot_mode が points、lines、または areas に設定されている場合、map_marker_type パラメータはマップ要素に表示されるポイントの種類を定義します。map_marker_type パラメータは次の値を受け入れます。
circleiconcircle_and_iconnone
map_marker_type に指定する値は、地図上に表示されるポイントの書式設定に使用できるパラメータに影響します。
map_marker_icon_name
map_marker_type が icon または circle_and_icon に設定されている場合、map_marker_icon_name パラメータを使用して、すべてのマップマーカーに表示するアイコンの種類を設定できます。
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
map_marker_type が circle または circle_and_icon に設定されているマップの場合、map_marker_radius_mode パラメータを使用して、次のオプションに従って円のサイズを設定できます。
proportional_value: このオプションは、クエリに追加したメジャーに応じて円の相対的なサイズを調整します。このオプションでは、map_marker_radius_minおよびmap_marker_radius_maxパラメータを使用して、円の最小半径と最大半径を設定できます。また、map_marker_proportional_scale_typeパラメータを使用して、円のサイズを決定する際に線形スケールを使用するか対数スケールを使用するかを設定することもできます。equal_to_value: この設定は、円の半径を基となるクエリの実際のメジャー値に合わせて調整します。fixed: このオプションでは、map_marker_radius_fixedパラメータを使用して、すべての地図マーカーに適用する固定半径を設定できます。デフォルト値は500です。
map_marker_radius_mode: proportional_value | equal_to_value | fixed
map_marker_radius_fixed
map_marker_radius_mode が fixed に設定され、map_marker_type が circle または circle_and_icon に設定されている場合は、map_marker_radius_fixed パラメータを使用して、すべての地図マーカーに適用される固定半径を設定できます。
map_marker_type: circle
map_marker_radius_mode: fixed
map_marker_radius_fixed: 60
map_marker_radius_min
map_marker_type が circle または circle_and_icon に設定され、map_marker_radius_mode が proportional_value に設定されている地図では、map_marker_radius_min パラメータを使用して円の最小半径を定義できます。
map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_min: 5
map_marker_radius_max
map_marker_type が circle または circle_and_icon に設定され、map_marker_radius_mode が proportional_value に設定されている地図では、map_marker_radius_max パラメータを使用して円の最大半径を定義できます。
map_marker_type: circle
map_marker_radius_mode: proportional_value
map_marker_radius_max: 50
map_marker_proportional_scale_type
map_marker_type が circle または circle_and_icon に設定され、map_marker_radius_mode が proportional_value に設定されている地図の場合、map_marker_proportional_scale_type パラメータを使用して、円のサイズを線形スケールまたは対数スケールに基づいて設定できます。このパラメータの値は、linear または log のいずれかになります。
map_marker_radius_mode: proportional_value
map_marker_proportional_scale_type: linear | log
map_marker_units
map_marker_type が circle または circle_and_icon に設定されている地図では、map_marker_units パラメータを使用して、円の半径に使用する単位を meters または pixels に設定できます。
map_marker_units: meters | pixels
map_marker_color_mode
map_marker_color_mode を使用して、地図上のマーカーの色を設定できます。
map_marker_color_modeがvalueに設定されている場合、基となるクエリの値に基づいて、マーカーに動的に色が割り当てられます。値パラメータを使用して、このオプションの凡例で色を構成できます。map_marker_color_modeがfixedに設定されている場合は、map_marker_colorパラメータを使用して、すべての地図上のマーカーに使用する単一の色を設定できます。カラー値は、2ca6cdなどの RGB 16 進数文字列、またはmediumblueなどの CSS カラー名としてフォーマットできます。
map_marker_color
map_marker_color_mode が fixed に設定されている場合は、すべての地図上のマーカーに使用する単一の色を設定します。
map_marker_color: [mediumblue]
値パラメータ
これらのパラメータを使用すると、map_marker_color_mode が value に設定されている場合、または map_plot_mode が automagic_heatmap、lines、areas に設定されている地図要素の場合に、基盤となるクエリの値に基づいてマーカーに動的に割り当てられる色を構成できます。
map_value_colors
map_value_colors パラメータを使用すると、地図上の地点の色を設定したり、measure に従って色分けを行う場合に使用する色の範囲を定義したりできます。#2ca6cd などの 16 進数の文字列のリストや、mediumblue などの CSS のカラー名を入力できます。最初に指定した色は、最も低い値に関連付けられます。
map_value_colors: [green, mediumblue]
quantize_map_value_colors
true に設定すると、quantize_map_value_colors によってカラースケールが滑らかなグラデーションから設定済みの特定の色のみに変わります。このパラメータはデフォルトで false に設定されています。
quantize_map_value_colors: true | false
reverse_map_value_colors
true に設定すると、reverse_map_value_colors パラメータでグラフの最大値と最小値を示す色が切り替わり、カラー グラデーションが逆になります。
reverse_map_value_colors: true | false
map_value_scale_clamp_min
map_value_scale_clamp_min パラメータを使用すると、色範囲の最小値を設定できます。これにより、特定のしきい値（指定された数値）以下のすべてのポイントを、map_value_colors パラメータで指定された最も低い色で色分けすることができます。デフォルトでは、凡例に適用される最小値はクエリの最小値です。
map_value_scale_clamp_min: 1000
map_value_scale_clamp_max
map_value_scale_clamp_max パラメータを使用すると、色範囲の最大値を設定できます。これにより、map_value_colors パラメータで指定された最高色で、指定された数値を超えるすべてのポイントを色分けできます。デフォルトでは、凡例に適用される最大値は、クエリからの最大値です。
map_value_scale_clamp_max: 50000