进阶 docs.budibase.com 2026-11-12 08:33:37 · 19 阅读

第39章 内嵌地图(Embedded Map)

内嵌地图(Embedded Map)通过 Map 组件,你可以在任意界面中展示交互式地图。它能让你快速嵌入地图,并直接从你有权限访问的任何 Data Sources 中读取数据,在地图上快速显示数百个标记点。地图组件支持通过 Data Provider 创建带经纬度绑定的标记。在 UI 中添加地图要在 UI 中添加地图,你需要:添加一个 Data Provider将 Map 组件添加进去:点击 Component > Elements > Embedded Map

新的地图会立即显示伦敦的地图。

从现在开始,你可以按照自己的喜好来配置地图。 在地图上显示标记 要在地图上显示标记,只需将父级 Data Provider 与 Embed Map 关联即可。在 Settings Panel 中选择正确的 provider,然后在 Latitude key 设置中选择包含纬度的列,最后在 Longitude key 设置中选择包含经度的列。

完成这三项设置后,地图会重新渲染并显示标记,标记会直接呈现出来。

如果想为每个标记添加标题,可以在 Settings Panel 中选择 Title key 设置。点击标记时会显示这个标题。 启用标记点击 如果你想在用户点击标记时执行某些操作,可以点击 Settings Panel 中标有 On Click Marker 的 Define actions 按钮来定义 Actions。这会弹出一个 Actions 模态框,供你自定义操作。

其中一个可用的 Binding 是 Clicked marker 对象,它包含了你在 Data Provider 中所选表格对应行的数据。

从地图跳转到详情页的一个快捷方式,是在 actions 抽屉中配置一个 Navigate To 操作:

打开 On click marker 并选择 Add Action 选择操作类型 Navigate To 将 Destination 设置为 Screen 使用动态路由,例如 /station/{{ Clicked marker._id }} 可选:启用 Open screen in modal 点击 Save

启用创建标记 如果你希望用户能够直接在地图上创建新标记,可以在 Settings Panel 中启用 Enable creating markers 设置。

默认情况下,这个功能只是允许用户点击地图上没有标记的位置,点击后会添加一个新标记,并显示 New Marker 弹窗。

标记出现后,地图下方会出现两个按钮,用户可以点击 Create Marker 按钮。

请注意,只有点击地图后 Create Marker 按钮才会出现。

这个 Create Marker 按钮默认不会执行任何操作,但你可以在 Settings Panel 中 Enable creating marker 设置下方的 Define actions 按钮里配置点击后的操作。这会打开 Actions 面板,其中提供两个 binding:latitude 和 longitude。

快速创建标记的流程:

在设置中启用标记创建(Enable adding)。 在 On create marker 下添加操作。 使用标记点击返回的 latitude 和 longitude binding 来创建或更新记录。

更换地图瓦片集 地图渲染底层使用的是 LeafletJS。因此,关于其他瓦片集的用法可以参考 LeafletJS 的文档:https://leafletjs.com/reference.html#tilelayer

在 Leaflet-extra 的 GitHub 页面上可以找到更多瓦片集,还包括一个在线交互式演示。

瓦片集的 URL 可以在页面顶部的代码片段中找到。

可嵌入地图并不限于上述预览页面中的瓦片集,但仅限于那些无需 API key 或支持通过 URL 提供 API key 的服务。

找到合适的瓦片集后,将其粘贴到 Settings Panel 的 Tile URL 设置中。

👍LeafletJS 瓦片集 binding:LeafletJS 瓦片集的 URL 中包含一些特殊的 binding,比如 {x}、{y}、{z},这是 LeafletJS 自身格式的一部分,无需修改或替换。直接复制 URL 即可,剩下的交给 LeafletJS 处理。

其他设置 除了本文中提到的设置外,还有一些设置可能会用到,或者你需要了解其含义。完整的设置列表见下表。

设置说明Enable Fullscreen在右上角显示一个图标,点击后可全屏查看地图Enable location在右下角显示一个图标,用户点击后可在地图上显示自己的位置Enable zoom允许用户通过滚动、双击或右下角的 + 和 - 按钮来缩放地图Default location地图为空时的焦点位置。输入格式为 latitude,longitude,小数点用 . 表示。标记加载后此项会被自动计算Default Zoom Level标记加载前地图的默认缩放级别,取值范围为 1-100,100 为放大程度最高Map Attribution地图上显示的版权信息。使用地图服务商时通常要求填写更新于 6 个月前 此页面对你有帮助吗?

评论 (0)