底图 map-tile

XYZ 栅格瓦片底图（{z}/{x}/{y} 模板）。

放在 map-2d 的 pieces 里；enabled 写在节点顶层。数据来源 data-input：bind-fields（绑工程连接）或 source（引用数据源）。

在线演示

标准 OSM 底图：tile-url 填 XYZ 模板，配瓦片尺寸 / 不透明度 / 切片渐隐时间。联网即可出图；可拖拽缩放。

变体：Carto 暗色底图 + 影像调节（降饱和 / 压亮度 / 提对比），适合深色大屏底座；同一页面可叠多个 map-tile 做注记 / 影像叠加。

属性

属性	名称	类型	默认	说明
tile-url	瓦片地址	string	—
tile-size	瓦片尺寸	number(unit=px,min=128)	256
tile-opacity	不透明度	slider(min=0,max=100,step=1,unit=%)	100
tile-saturation	饱和度	slider(min=-100,max=100,step=1,unit=%)	0
tile-hue	色相旋转	slider(min=0,max=360,step=1,unit=°)	0
tile-brightness	亮度	slider(min=-100,max=100,step=1,unit=%)	0
tile-contrast	对比度	slider(min=-100,max=100,step=1,unit=%)	0
tile-resampling	采样方式	select	linear	可选：linear / nearest
tile-fade-duration	渐隐时间	number(unit=ms,min=0,step=50)	300
row-row-filter-mode-id	选择数据规则	select(condition)	—

事件

触发器	名称	配在哪	payload
marker-click	点击点要素	map-2d 组件的 options.interactions（运行态按命中图层分流）	命中要素属性行，公式 {:name} / {:value} 取值
region-click	点击面要素	同上	同上
map-select / map-unselect	选中 / 取消	同上	选中项数据

事件写在地图组件上而非图层上。图层还支持 feature-panel-uid（点击要素弹锚定窗口）与 tooltip-enable（悬停浮层），见属性表。动作端可用 mapLayerVisible / mapSetLayerStyle / mapRefreshData 等 17 个地图动作，见 2D 地图 · 事件。

示例

{
  "type": "map-tile",
  "uid": "ly_x",
  "enabled": true,
  "options": {
    "tile-url": "https://tile.openstreetmap.org/{z}/{x}/{y}.png"
  }
}

延伸阅读：2D 地图子系统 · 地图数据源 · 地图图层总览。