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

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` (適用於元素)	定義 `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 參數會以 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 像素。

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

- 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_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，依據第一個樞紐分析表欄排序：

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

如果正在監聽的篩選器已設定 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，即可在 Google 地圖上將基礎資料表中的每一列繪製為個別點。

單獨使用 type: location 維度會在 Google 地圖上放置大小和顏色一致的點。在查詢中新增測量指標，即可使用 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 的其中一個維度，並依排序順序連接所有點。這會在 Google 地圖元素上形成區域界線。在查詢中加入測量值，即可設定構成區域界線的個別地點點大小和顏色。

`heatmap_gridlines`

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


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