创建自定义地图区域

注意：在 Looker 22.14 中，map_layer 参数添加了对 GeoJSON 文件的支持。

Looker 包含多个内置地图图层，但您也可以定义自定义地图区域来显示地理数据。假设您有以下三个社区的平均年龄表格：

客户邻域	客户平均年龄
市中心	19.5292
eastside	54.4626
Westside	34.9534

您可能需要将客户邻域映射到特定地理区域，以便在地图上直观呈现。为此，请按照本页中所述的步骤操作。

准备地区数据

如需准备地区数据，您需要一个数据文件，其中包含每个地区的地理形状，还包含将该地区与数据库中的数据相关联的元数据。

Looker 使用一种名为 TopoJSON 的格式以紧凑的方式存储此类数据。您可以使用许多常见的 Shapefile 格式轻松创建 TopoJSON 文件，也可以使用在线工具自行绘制 TopoJSON 文件，如 将 Shapefile 转换为 TopoJSON 社区帖子中所详述。

在本例中，我们已经准备好了提供此映射的 TopoJSON 文件。TopoJSON 文件中的每个区域都有一个名为 neighborhood 的属性，该属性与“客户邻域”字段的值相匹配，该字段在 LookML 项目中定义为名为 neighborhood 的维度。

上传地区数据

如需将区域数据导入 Looker，您可以将 TopoJSON 文件拖放到项目的文件浏览器部分。这些数据将与 LookML 代码一起提交，并像 LookML 项目中的任何其他代码一样进行更新。

创建地图图层

现在，您已在项目中添加了地区数据，接下来需要在 LookML 模型中创建地图图层。

您可以使用 map_layer 参数在模型文件中添加定义：

map_layer: my_neighborhood_layer {
  file: "neighborhoods.topojson"
  property_key: "neighborhood"
}

file 参数引用项目中包含地区数据的文件的名称，property_key 是您要在 Looker 中公开的数据集的属性。如果您不确定键是什么，只需省略媒体资源键，Looker 会尝试选择适当的键。

提示：您还可以使用托管在其他在线位置的 TopoJSON 文件，只需在图层定义中指定 url 而不是 file 即可：

map_layer: my_neighborhood_layer {
  url: "https://raw.githubusercontent.com/cooluser/JSON_Stuff/master/Neighborhoods.topoJSON"
  property_key: "neighborhood"
}

将地图图层与数据相关联

接下来只需通过应用 map_layer_name 参数将视图中的维度 neighborhood 与新创建的地图图层相关联即可。

dimension: neighborhood {
  sql: ${TABLE}.neighborhood ;;
  map_layer_name: my_neighborhood_layer
}
  

这会告知 Looker 此维度的值与地图图层公开的 property_key 相关联。它还会告知 Looker 可以在地图上显示此类数据。

查看地图

现在，使用 neighborhood 维度的查询可以在“探索”页面中显示在地图上：