對應 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 語法指定維度或指標。如要使用 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 參數定義 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

將 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

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 參數：


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