您目前查看的是 Looker 26.14 的說明文件。按一下這個連結，即可查看最新說明文件。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

對應 LookML 資訊主頁的參數

本頁說明如何使用 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` (適用於元素)	定義 `tile_size` 單位中 `layout: tile` 和 `layout: static` 資訊主頁的元素高度
`width` (適用於元素)	以 `tile_size` 為單位，定義 `layout: tile` 和 `layout: static` 資訊主頁中元素的寬度
`top`	定義 `layout: static` 資訊主頁中，元素從上到下的位置 (以 `tile_size` 為單位)
`left`	定義 `layout: static` 資訊主頁中元素從左到右的位置，單位為 `tile_size`
`row`	定義 `layout: newspaper` 資訊主頁中元素的上下位置 (以列為單位)
`col`	定義 `layout: newspaper` 資訊主頁中元素的左右位置 (以欄為單位)
`refresh` (適用於元素)	設定元素自動重新整理的間隔時間
`note`	啟動某一個 LookML 區塊，定義元素的附註。此參數有子參數`text`、`state`和`display`。
查詢參數
`model`	定義要用於元素查詢的模型
`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`	將圓形半徑所用的單位設為 `meters` 或 `pixels`，適用於 `map_marker_type` 設為 `circle` 或 `circle_and_icon` 的元素
`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 參數會以 tile_size 為單位 (以像素為單位)，定義 layout: tile 和 layout: static 資訊主頁的元素高度。

舉例來說，下列程式碼會指定 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 個資料列。如果資訊主頁的 preferred viewer 參數設為 dashboards，則最低高度為 2 列。

舉例來說，以下程式碼會將元素設為 12 列高，或是設為預設值的其他元素高度的兩倍：

- dashboard: sales_overview
  layout: newspaper
  ...

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

`width`

本節是指屬於資訊主頁元素的 width 參數。

width 也可做為資訊主頁的一部分，詳情請參閱「資訊主頁參數」說明文件頁面。

width 參數會以 tile_size 為單位，定義 layout: tile 和 layout: static 資訊主頁中元素的寬度。

舉例來說，下列程式碼會指定 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 參數會以 tile_size 為單位，定義 layout: static 資訊主頁中元素的上下位置。

舉例來說，下列程式碼會指定 tile_size: 100 和 top: 4，將 orders_by_date 元素的頂端邊緣放置在距離資訊主頁頂端 400 像素的位置。

- dashboard: sales_overview
  tile_size: 100
  ...

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

`left`

left 參數會以 tile_size 為單位，定義 layout: static 資訊主頁中元素的左右位置。

舉例來說，下列程式碼會指定 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 像素。

舉例來說，假設元素設為預設高度，以下程式碼會將元素設為資訊主頁的第二列元素：

- dashboard: sales_overview
  layout: newspaper
  ...

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

`col`

如果是 layout: newspaper 資訊主頁，col 參數會定義元素左側邊緣所在的欄。

資訊主頁會分成 24 欄。資訊主頁的左側從第 0 欄開始。報紙版面配置的資訊主頁預設元素寬度為 8 欄，也就是說，資訊主頁左側的資訊主頁元素 (col: 0) 預設會佔用第 0 到第 7 欄。

舉例來說，下列程式碼會將元素設為資訊主頁元素第三欄中的元素：

- 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 子參數會決定附註是否要collapsed或expanded。如果您選擇 collapsed 且筆記過長，則筆記將以可點擊的省略號 (...) 結尾，點擊即可閱讀完整筆記。

`display`

display 子參數會決定附註在元素上的顯示位置。above 會將附註放在元素頂端，below 則會放在元素底部，而 hover 則會要求使用者將滑鼠游標懸停在元素上，才能看到附註。

查詢參數

定義 LookML 資訊主頁元素時，您必須至少為 model 和 explore 查詢參數指定值。

如果是 type: looker_map 的 LookML 資訊主頁元素，您也必須指定至少一個地理欄位，做為 dimensions 或 fields 參數的值。地理區域欄位可以是下列其中之一：

根據經緯度資料建立的維度，在 LookML 中定義為 type: location 維度。
已指派地圖圖層的維度。LookML 開發人員可以使用 map_layer_name 參數，將內建地圖圖層或自訂地圖圖層新增至指標。
郵遞區號維度。郵遞區號區域是以 2010 年的郵遞區號製表區域 (ZCTA) 為依據。如果您要顯示郵遞區號，郵遞區號與地圖視覺化使用的 ZCTA 可能不是一對一對應，因此地圖可能不會顯示所有點。

您可以使用其他查詢參數，控管資料在資訊主頁元素中的顯示方式。如要進一步瞭解使用 Looker UI 建構互動式地圖圖表的需求條件，請參閱「地圖圖表選項」說明文件頁面的「建構互動式地圖圖表」一節。

`model`

model 參數會定義要用於元素查詢的模型。如未指定，系統會預設為資訊主頁所在的模型。

- name: orders_by_date
  model: ecommerce

model 參數接受 LookML 常數。您可以在專案的資訊清單檔案中定義常數，然後使用 "@{constant_name}" 語法將常數設為 model 的值。使用常數可在單一位置定義模型名稱，如果您要更新多個資訊主頁元素使用的模型名稱，這項功能就特別實用。

如要進一步瞭解如何搭配使用常數和 LookML 資訊主頁，請參閱 constant 參數說明文件頁面。

`explore`

本節是指屬於資訊主頁元素的 explore 參數。

explore 也可做為模型的一部分，詳情請參閱 explore 參數說明文件頁面。

explore 也可做為資訊主頁篩選器的一部分，詳情請參閱「資訊主頁參數」說明文件頁面。

explore 參數會定義要用於元素查詢的探索。

- name: orders_by_date
  explore: order

explore 參數接受 LookML 常數。您可以在專案的資訊清單檔案中定義常數，然後使用 "@{constant_name}" 語法將常數設為 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 依資料列總和排序，這個索引代表含有兩個樞紐分析資料欄的查詢總和資料欄：

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

資訊主頁篩選器可讓檢視者互動式地篩選資訊主頁元素中顯示的資料。使用 filters 參數定義 LookML 資訊主頁的資訊主頁篩選條件。接著，使用 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
automagic_heatmap
lines
areas

`points`

將 map_plot_mode 設為 points，即可將基礎資料表中的每一列繪製為地圖上的離散點。

type: location 維度本身會在 Google 地圖上放置大小和顏色一致的點。在查詢中新增指標，即可使用 map_marker_radius_mode 和 map_marker_color_mode 參數，依顏色或大小縮放點。

`automagic_heatmap`

將 map_plot_mode 設為 automagic_heatmap，即可將基礎查詢中的資料顯示為熱視圖格線。這項功能會將可見地圖劃分為大小相等的方格，然後計算資料中哪些值符合每個方格。方塊會根據您選擇的指標著色。放大或縮小這張地圖時，Looker 會重新計算格線，確保細微程度符合縮放等級。

查詢必須同時包含 type: location 維度和測量指標，這類圖表才能正常運作。

`lines`

將 map_plot_mode 設為 lines 會從查詢中取得 type: location 的兩個維度，並在圖表中將兩者連結在一起。在查詢中新增指標，即可為線條新增色階。

`areas`

將 map_plot_mode 設為 areas 會取用 type: location 的其中一個維度，並依排序順序連接所有點。這會在 Google 地圖元素上形成區域界線。在查詢中加入指標，即可設定構成區域界線的個別地點點大小和顏色。

`heatmap_gridlines`

如果是熱視圖元素，將 heatmap_gridlines 設為 true 會在熱視圖使用的每個格線周圍新增邊框。當您繪製 type: location 維度，且 map_plot_mode 設為 automagic_heatmap 時，或繪製郵遞區號維度或具有相關聯地圖圖層的維度時，可以使用這個參數。


heatmap_gridlines: true | false

`heatmap_gridlines_empty`

如果將熱視圖元素的 heatmap_gridlines 設為 true，並將 heatmap_gridlines_empty 設為 true，系統就會在沒有相關聯資料的地圖區域周圍顯示輪廓。


heatmap_gridlines_empty: true | false

`heatmap_opacity`

對於熱圖元素，您可以使用 heatmap_opacity 來指定熱圖中使用的顏色的不透明度。將 0 到 1 之間的數字指定為 heatmap_opacity 的值，其中 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 參數來設定可見地圖的中心點和縮放等級。指定此位置有兩種方法：

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 參數接受下列值：

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 參數，為所有地圖標記設定單一顏色。顏色值可以格式化為 RGB 十六進位字串 (例如 2ca6cd)，或 CSS 顏色名稱 (例如 mediumblue)。

`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 參數設定地圖點的顏色，或根據指標定義要使用的顏色範圍 (如果採用顏色編碼)。您可以輸入十六進位字串清單 (例如 #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

對應 LookML 資訊主頁的參數 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

應用實例

參數定義

基本參數

name

title

type

height

適用於 tile 或 static 版面配置的資訊主頁

適用於 newspaper 版面配置的資訊主頁

width

top

left

row

col

refresh

note

text

state

display

查詢參數

model

explore

fields

dimensions

measures

sorts

pivots

limit

column_limit

filters

listen

query_timezone

繪圖參數

map_plot_mode

points

automagic_heatmap

lines

areas

heatmap_gridlines

heatmap_gridlines_empty

heatmap_opacity