LookML ダッシュボードの Google マップ パラメータ

重要: type: looker_google_map のグラフは、preferred_viewer が dashboards-next に設定された LookML ダッシュボードにのみ表示されます。

このページでは、dashboard.lkml ファイルの LookML ダッシュボード パラメータを使用して、type: looker_google_map の LookML ダッシュボード要素を作成および編集するためのパラメータについて説明します。

type: looker_google_map のグラフは、preferred_viewer が dashboards-next に設定されている LookML ダッシュボードにのみ表示されます。Explore で Google マップのグラフを表示するには（たとえば、ダッシュボード ビューアがダッシュボードのタイルメニューで [Explore from Here] をクリックした場合）、新しい Explore ビジュアリゼーションの Labs 機能を有効にする必要があります。

Looker UI を使用して Google マップのグラフを作成する方法については、Google マップのグラフ オプションのドキュメントをご覧ください。インタラクティブな地図グラフを作成するために必要なフィールドのタイプについては、このページのクエリ パラメータ セクションをご覧ください。

使用例

N は数値が必要なことを示します。単一引用符は説明文を示しており、ライブコードに含めないでください。

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

パラメーター定義

パラメーター名	説明
基本パラメータ
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'

この形式を使用すると、要素は [販売の概要] ではなく [1）販売の概要] と表示されます。

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 ダッシュボードの要素の高さを行単位で定義します。

新聞レイアウトのダッシュボードのデフォルトは、6 行（およそ 300 ピクセル）の要素の高さです。preferred viewer パラメータが dashboards-next に設定されたダッシュボードの最小高さは 1 行です。ダッシュボードの高さの最小値は 2 行で、preferred viewer パラメータを dashboards に設定します。

たとえば、次のコードは、要素の高さを 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 クエリ パラメータの値を指定する必要があります。

type: looker_google_map の LookML ダッシュボード要素の場合は、dimensions または fields パラメータの値として、少なくとも 1 つの地理フィールドも指定する必要があります。地理フィールドは次のいずれかです。

• LookML で type: location のディメンションとして定義されている、緯度と経度のデータに基づくディメンション。
• 地図のレイヤが割り当てられたディメンション。LookML デベロッパーは map_layer_name パラメータを使用して、組み込みの地図レイヤまたはカスタムの地図レイヤをメジャーに追加できます。
• 郵便番号のディメンション。郵便番号領域は、2010 年の郵便番号集計エリア（ZCTA）に基づいています。郵便番号を視覚化している場合、郵便番号と地図の可視化に使用される ZCTA は 1 対 1 で対応していない場合があります。そのため、一部のポイントが地図上に表示されるとは限りません。

次に説明するその他のクエリ パラメータを使用して、ダッシュボード要素でのデータの表示方法を制御することもできます。Looker UI でインタラクティブなマップチャートを構築するための要件については、マップチャート オプションに関するドキュメント ページの Google マップチャートを作成するをご覧ください。

model

model パラメータは、要素クエリに使用するモデルを定義します。指定しない場合は、デフォルトでダッシュボードが存在するモデルになります。

- name: orders_by_date
  model: ecommerce

model パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を model の値として設定できます。定数を使用すると、1 つのモデル名を 1 か所で定義できます。これは、複数のダッシュボード要素で使用されるモデルの名前を更新する場合に特に便利です。

LookML ダッシュボードで定数の詳細と使用例については、constant パラメータのドキュメント ページをご覧ください。

explore

このセクションでは、ダッシュボード要素の一部である explore パラメータについて説明します。

explore は、モデルの一部として使用することもできます。詳しくは、explore パラメータのドキュメントをご覧ください。

explore はダッシュボード フィルタの一部として使用することもできます。詳しくは、ダッシュボード パラメータに関するドキュメント ページをご覧ください。

explore パラメータは、要素クエリに使用する Explore を定義します。

- name: orders_by_date
  explore: order

explore パラメータは、LookML 定数を受け入れます。プロジェクトのマニフェスト ファイルで定数を定義してから、構文 "@{constant_name}" を使用して定数を explore の値として設定できます。定数を使用すると、1 つの場所で Explore の名前を定義できます。これは、複数のダッシュボード要素で使用される 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 パラメータは、要素クエリに使用する並べ替えを定義します。1 番目、2 番目、3 と順に表示されます。構文 view_name.field_name は、ディメンションまたはメジャーを指定するときに使用します。Looker のデフォルトの並べ替え順を使用する場合は、sorts を含めないでください。降順にする場合、末尾には desc を付けます。昇順で並べ替える場合は、接尾辞は不要です。

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

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

pivots

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

ダッシュボードには、ユーザーがダッシュボード要素の背後にあるデータを変更できるフィルタを含めることができます。これらは、ダッシュボードの 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

たとえば、[日付] というフィルタを作成し、ユーザーが UI のフィルタ フィールドに日付を入力する必要があるとします。その後、ユーザーが入力した値を次のように orders_by_date 要素に適用できます。

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

このコンセプトの詳細については、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

プロット パラメータ

このセクションで説明するパラメータは、地図グラフのビジュアリゼーション エディタの [Plot] セクションのオプションに対応しています。

type: looker_google_map の要素で使用できるパラメータは、クエリに type: location のディメンションが含まれているか、またはマップレイヤが関連付けられているかによって異なります。

map_plot_mode

map_plot_mode パラメータは、type: location のディメンションに基づく type: looker_google_map 要素にデータをプロットする方法を定義します。このパラメータは、関連する地図レイヤを含むディメンションに基づく地図または郵便番号のディメンションでは使用できません。map_plot_mode パラメータは次の値を受け入れます。

• points
• automagic_heatmap
• heatmap
• lines
• areas

points

map_plot_mode を points に設定すると、基になるデータテーブルの各行が地図上に個別のポイントとしてプロットされます。

type: location のディメンションでは、サイズと色が統一されたポイントが地図上に配置されます。クエリにメジャーを追加すると、map_marker_radius_mode パラメータと map_marker_color_mode パラメータを使用してポイントを色またはサイズで調整できるようになります。

automagic_heatmap

map_plot_mode を automagic_heatmap に設定すると、基になるクエリのデータがヒートマップ グリッドとして表示されます。表示可能なマップを正方形に等分割し、データ内のどの正方形に収まるかを計算します。正方形は、選択したメジャーに応じて色付けされます。この地図をズームインまたはズームアウトすると、ズームレベルに適切な粒度が得られるように Looker がグリッドを再計算するようになります。

このプロットタイプが正しく動作するためには、クエリに type: location のディメンションとメジャーの両方が含まれている必要があります。

heatmap

map_plot_mode を heatmap に設定すると、多数のポイントが密集して表示される多数の位置情報を表示できる地図が生成されます。色強度とカラースケールは、各領域のデータポイントの濃度を伝達します。

クエリには、type: location のディメンションを含める必要があります。必要に応じてメジャーを追加できます。

lines

map_plot_mode を lines に設定すると、type: location の 2 つのディメンションがクエリから取得され、ビジュアリゼーションで結合されます。クエリにメジャーを追加すると、線にカラースケールを追加できます。

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 に設定され、定義された map_layer でデータをプロットする場合、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: 交通機関のネットワークと道路（現在の交通情報を含む）が強調された暗い色の地図
• minimal: ラベルや境界線のない明るい色のマップ

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 または heatmap に設定されている地図では、ポイントのオプションを使用できません。

map_marker_type

地域ディメンションに基づく地図で、map_plot_mode が points、lines、または areas に設定されている場合、map_marker_type パラメータは地図要素に表示されるポイントの種類を定義します。map_marker_type パラメータは次の値を受け入れます。

• circle
• icon
• circle_and_icon
• none

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 パラメータを使用して、すべての地図マーカーに使用する単色を設定できます。

map_marker_color

map_marker_color_mode が fixed に設定されている場合、map_marker_color_mode はすべての地図マーカーに使用する色を 1 つ設定します。色の値は、2ca6cd のような RGB 16 進文字列、または mediumblue のような CSS 色名として書式設定できます。

map_marker_color: [mediumblue]

値のパラメータ

これらのパラメータを使用すると、map_marker_color_mode が value に設定されている場合、基になるクエリの値に基づいてマーカーに動的に割り当てられる色を設定したり、map_plot_mode が automagic_heatmap、heatmap lines、または areas に設定された地図要素を設定したりできます。

map_value_colors

map_value_colors パラメータを使用してマップポイントの色を設定できます。また、メジャーによる色分けの場合は、使用する色の範囲を定義できます。16 進文字列のリスト（#2ca6cd など）または CSS の色名（mediumblue など）を入力できます。最初に指定した色は、最も低い値に関連付けられます。

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