注意：在 Looker 22.14 中，map_layer 参数新增了对 GeoJSON 文件的支持。
Looker 包含多个内置地图图层，但您也可以定义自定义地图区域来显示地理数据。假设您有一个包含三个社区的平均年龄的表格，如下所示：
| 客户社区 | 客户平均年龄 |
|---|---|
| 市中心 | 19.5292 |
| eastside | 54.4626 |
| Westside | 34.9534 |
您可能需要将客户邻域映射到特定地理区域，以便在地图上直观呈现。为此，请遵循 执行本页所述步骤。
准备地区数据
如需准备地区数据，您需要一个数据文件，其中包含每个地区的地理形状，还包含将该地区与数据库中的数据相关联的元数据。
Looker 使用一种名为 TopoJSON 的格式以紧凑的方式存储此类数据。可以通过许多常见的 Shapefile 文件轻松创建 TopoJSON 文件 也可以使用在线工具自己绘制一个 将 Shapefile 转换为 TopoJSON 社区帖子。
就本示例而言，已经准备好了提供此映射的 TopoJSON 文件。TopoJSON 文件中的每个区域都有一个名为 neighborhood 的属性，该属性与
Customer 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 维度的查询可以在“探索”页面中显示在地图上：
