您正在查看 Looker 26.20 的說明文件。請按一下這個連結，查看最新說明文件。

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

LookML 資訊主頁的 Google 地圖參數

本頁面說明如何使用 dashboard.lkml 檔案中的 LookML 資訊主頁參數，建立及編輯 type: looker_google_map 的 LookML 資訊主頁元素。

如要瞭解如何透過 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` (用於元素)	定義要用於元素查詢的探索
`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 參數中；將元素整理成圖塊群組 (type: group) 時，名稱則會出現在子元素的 group 參數中。

- 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 | button | group

如要概略瞭解不同類型的 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 參數會定義元素頂端邊緣所在的列。如果使用 group 參數將元素放置在圖塊群組中，row 會定義元素相對於群組容器頂端 (row: 0) 的列位置。

資訊主頁頂端為第 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 參數會定義元素左側邊緣所在的資料欄。如果使用 group 參數將元素放在圖塊群組中，col 會定義元素相對於群組容器左側邊緣 (col: 0) 的欄位置。

資訊主頁分為 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_google_map 的 LookML 資訊主頁元素，您也必須指定至少一個地理欄位，做為 dimensions 或 fields 參數的值。地理欄位可以是下列其中一種：

根據經緯度資料定義的維度，在 LookML 中定義為 type: location 維度。
已指派地圖圖層的維度。LookML 開發人員可以使用 map_layer_name 參數，在測量指標中加入內建地圖圖層或自訂地圖圖層。
郵遞區號維度。郵遞區號區域是根據 2010 年郵遞區號統計區域 (ZCTA) 劃分。如果您要以圖表呈現郵遞區號，郵遞區號與用於地圖圖表的 ZCTA 之間可能不會有一對一的對應關係，因此地圖可能不會顯示所有點。

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

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

檢視者可透過資訊主頁篩選器，以互動方式調整資訊主頁元素中顯示的資料。使用 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
    ...

如果監聽的篩選器已設定 vis_filter: true 參數，篩選器控制項會直接顯示在圖表圖塊頂端的篩選器列中，而非資訊主頁頂端的篩選器列。

如需更多範例，瞭解如何使用 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_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 的兩個維度，並在圖表中連結。在查詢中加入測量指標，即可為線條新增色階。

`areas`

將 map_plot_mode 設為 areas 會採用 type: location 的一個維度，並按照排序順序連接所有點。這會在地圖元素上形成區域邊界。在查詢中新增測量指標，即可設定構成區域邊界的個別位置點大小和顏色。

`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 指定熱視圖所用顏色的不透明度。請指定介於 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：深色地圖，強調大眾運輸網路和道路，包括目前路況資訊
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 參數，設定可見地圖的中心點和縮放等級。指定位置的方法有兩種：

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`

map_scale_indicator 參數預設為 'off'，可用來指定是否要顯示地圖比例尺，以及設定要顯示的單位類型。


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


map_marker_color: [mediumblue]

值參數

當 map_marker_color_mode 設為 value，或地圖元素的 map_plot_mode 設為 automagic_heatmap、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 資訊主頁的 Google 地圖參數 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

應用實例

參數定義

基本參數

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

heatmap

lines

areas

heatmap_gridlines

heatmap_gridlines_empty

heatmap_opacity