地理圆/扇形 map-geocircle
2026年7月20日大约 4 分钟
地理圆/扇形 map-geocircle
地理圆 / 扇形（真实米半径）。
放在
map-2d的pieces里；enabled写在节点顶层。数据来源data-input：bind-fields（绑工程连接）或source（引用数据源）。
在线演示
预览使用内置公开演示服务 / 互联网底图，联网即可出图；可拖拽缩放。数据来自内联 GeoJSON 演示源。
属性
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
enable-zoom | 限制缩放区间 | boolean | false | |
min-zoom | 最小级别 | number(min=0,max=24,step=0.1) | 0 | |
max-zoom | 最大级别 | number(min=0,max=24,step=0.1) | 24 | |
geocircle-fill-color-mode | 填充色·取值 | select(radioGroup) | const | 可选：const / field / zoom |
geocircle-fill-color-field | 填充色·字段 | string | — | |
geocircle-fill-color-stops | 填充色·映射 | string(textarea,rows=3) | — | |
geocircle-fill-opacity-mode | 填充不透明度·取值 | select(radioGroup) | const | 可选：const / field / zoom |
geocircle-fill-opacity-field | 填充不透明度·字段 | string | — | |
geocircle-fill-opacity-stops | 填充不透明度·映射 | string(textarea,rows=3) | — | |
geocircle-line-color-mode | 边线颜色·取值 | select(radioGroup) | const | 可选：const / field / zoom |
geocircle-line-color-field | 边线颜色·字段 | string | — | |
geocircle-line-color-stops | 边线颜色·映射 | string(textarea,rows=3) | — | |
geocircle-line-width-mode | 边线宽·取值 | select(radioGroup) | const | 可选：const / field / zoom |
geocircle-line-width-field | 边线宽·字段 | string | — | |
geocircle-line-width-stops | 边线宽·映射 | string(textarea,rows=3) | — | |
geocircle-shape | 形状 | select(radioGroup) | circle | 可选：circle / sector |
geocircle-radius-mode | 半径来源 | select(radioGroup) | fixed | 可选：fixed / value |
geocircle-radius | 半径(公里) | number(min=0,step=1) | 50 | |
geocircle-radius-factor | 半径系数(×数值，公里) | number(min=0,step=0.1) | 1 | |
geocircle-start | 起始角(°) | number(min=0,max=360) | 0 | |
geocircle-end | 结束角(°) | number(min=0,max=360) | 90 | |
geocircle-steps | 平滑度 | number(min=8,max=180) | 64 | |
geocircle-fill-color | 填充色 | color | #3aa1ff | |
geocircle-fill-opacity | 填充不透明度 | slider(min=0,max=100,step=1,unit=%) | 25 | |
geocircle-line-color | 边线颜色 | color | #3aa1ff | |
geocircle-line-width | 边线宽 | number(unit=px,min=0,step=0.5) | 1.5 | |
geocircle-hover-color | 悬停颜色 | color | #36cfc9 | |
geocircle-selected-color | 选中颜色 | color | #ff7875 | |
row-row-filter-mode-id | 选择数据规则 | select(condition) | — | |
filter-expr | 过滤条件 | string(textarea,rows=4) | — | |
filter-combine | 组合方式 | select(radioGroup) | all | 可选：all / any |
tooltip-enable | 启用悬停提示 | boolean | false | |
tooltip-fields | 显示字段 | string | — | |
tooltip-title-field | 标题字段 | string | — | |
feature-panel-uid | 点击弹出画面 | window | [] | |
feature-panel-offset | 弹窗偏移(px) | vector<水平,垂直> | [0,0] | |
data-input | 来源方式 | select(radioGroup) | bind-fields | 可选：bind-fields / source |
data-source-uid | 选择数据源 | map-source | [] | |
src-lng-field | 经度/X 字段 | string | — | |
src-lat-field | 纬度/Y 字段 | string | — | |
src-name-prop | 名称属性 | string | — | |
src-value-prop | 数值属性 | string | — | |
src-key-field | 唯一键字段 | string | — | |
marker-lng | 经度/横坐标 | field(recommend=number,min=1,max=1) | — | |
marker-lat | 纬度/纵坐标 | field(recommend=number,min=1,max=1) | — | |
marker-name | 名称 | field(min=0,max=1) | — | |
marker-value | 数值 | field(recommend=number,min=0,max=1) | — | |
marker-points | 坐标点 | string | 0,0;10,0;-10,5;20,-10 |
数据绑定（bind-fields 档）
| 字段槽 | 类型 / 约束 | 说明 |
|---|---|---|
marker-lng | field(recommend=number,min=1,max=1) | 经度/横坐标 |
marker-lat | field(recommend=number,min=1,max=1) | 纬度/纵坐标 |
marker-name | field(min=0,max=1) | 名称 |
marker-value | field(recommend=number,min=0,max=1) | 数值 |
事件
| 触发器 | 名称 | 配在哪 | 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-geocircle",
"uid": "ly_x",
"enabled": true,
"options": {
"data-input": "source",
"data-source-uid": [{ "refType": "element", "targetPath": ["src_x"] }]
}
}