map_layer_name

用法

view: view_name {
  dimension: field_name {
    map_layer_name: name_of_map_layer
  }
}
层次结构
view
字段类型
map_layer_name
可能的字段类型
维度

接受
模型级 map_layer 参数中指定的地图名称

基础知识

借助 map_layer_name 参数，您可以将维度与 TopoJSON 或 GeoJSON 地图图层相关联。这样一来，用户便可以通过在地图图层上绘制维度中的值来创建地图图表。例如，为了能够按美国各州绘制数据图表，您可以将名为“州”的维度与内置地图图层 us_states 相关联。您还可以将“社区”维度中的数据绘制到纽约市社区的自定义地图中。

如果您使用的是自定义 TopoJSON 或 GeoJSON 地图，则必须使用 map_layer 参数在 LookML 模型中指定地图层。

维度为 type: zipcode 的广告系列会自动获得 us_zipcode_tabulation_areas 的 map_layer_name。

内置地图图层

Looker 包含以下内置地图图层：

  • countries - 接受完整的国家/地区名称、ISO 3166-1 alpha-3 三字母国家/地区代码和 ISO 3166-1 alpha-2 双字母国家/地区代码。如果您的数据包含 ISO 3166-1 alpha-2 国家/地区代码，建议您将 map_layer_name 与 countries 地图搭配使用，以确保 Looker 将您的数据解读为国家/地区代码，而不是州代码。

  • uk_postcode_areas - 接受英国邮政编码区（例如，L 表示利物浦，RH 表示雷德希尔，EH 表示爱丁堡）。

  • us_states - 接受完整的州名和两个字母的州名缩写。

  • us_counties_fips - 适用于美国县的五字符 FIPS 县代码字符串字段。此图层仅适用于互动式地图。

  • us_zipcode_tabulation_areas - 适用于包含 5 位数美国邮政编码的字符串字段。type: zipcode 的维度会自动使用 us_zipcode_tabulation_areas 地图图层。

    邮政编码区域基于 2010 年的邮政编码汇总区域 (ZCTA)，因此此地图图层不包含许多无法直接映射到区域的邮政编码，例如分配给邮政信箱的邮政编码。

示例

dimension: state {
  map_layer_name: us_states
  sql: ${TABLE}.state ;;
}