本页介绍了在 dashboard.lkml
文件中通过 LookML 信息中心参数创建和修改 type: looker_map
的 LookML 信息中心元素的参数。
如需了解如何通过 Looker 界面构建互动式地图图表,请参阅地图图表选项文档页面。如需了解构建互动式地图图表所需的字段类型,请参阅下方的查询参数部分。
用法示例
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 (适用于元素) |
为 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
参数有时会引用名称。
- 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
信息中心的元素高度(以 row 为单位)。
报纸版式的信息中心的默认元素高度为 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
形参定义了 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 像素。
例如,以下代码假定要设置在元素第二行的元素,假设元素设置为默认高度:
- 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 界面构建互动式地图图表的要求,请参阅地图图表选项文档页面中的构建互动式地图图表部分。
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
液体变量来设置灵活的过滤条件值。
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
例如,您可以创建一个名为 Date 的过滤条件,要求用户在界面中的过滤条件字段中输入日期。然后,您可以将用户输入的值应用到 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
绘制参数
本部分中介绍的参数对应于地图图表可视化编辑器的图表部分中的选项。
您可对 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
会在地图上分别放置尺寸和颜色相同的点。向查询中添加测量值后,系统会使用 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
的一个维度,并按照这些点的排列顺序连接所有点。这构成了地图元素上某个区域的边界。通过向查询添加测量,可以设置组成区域边界的各个位置点的大小和颜色的格式。
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