map_layer_name

用法

view: view_name {
  dimension: field_name {
    map_layer_name: name_of_map_layer
  }
}
层次结构
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 - 接受完整的州名或两个字母的州名缩写。在底层数据列中使用单一一致的格式;如果一列中混合了州/省/自治区/直辖市的全称和两个字母的缩写(例如,California 和 CA),则这些值不会在地图上归为一组。

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

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

    邮政编码区域基于 2010 年邮政编码统计区域 (ZCTA),因此该地图图层不包含许多邮政编码,例如分配给邮政信箱的邮政编码,这些邮政编码不会直接映射到区域。

示例

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