BusineDataLayer

new mars3d.layer.BusineDataLayer(options)

业务数据(通过API接口获取)图层, 主要是为了封装后简化使用,或直接配置到config.json,也可以自行构造Graphic矢量对象加到GraphicLayer。

样式信息:通过symbol配置graphic类型和样式
坐标信息:建议接口返回中有规范的坐标字段lat\lng\alt或用formatPosition方法自定义解析

参数名称 类型 描述信息
options object 可选

参数对象,包括以下:

参数名称 类型 默认值 描述信息
url string 可选

geojson文件或服务url地址

data object 可选

geojson格式规范数据对象,与url二选一即可。

dataColumn string 可选

接口返回数据中,对应的业务数据数组所在的读取字段名称,支持多级(用.分割);如果数据直接返回数组时可以不配置。

formatData function 可选

可以对加载的数据进行格式化或转换操作

formatPosition function 可选

可以对加载的坐标进行格式化或转换操作,优先级高于lngColumn、latColumn、altColumn

lngColumn string "lng" 可选

点坐标时,经度值对应的字段名称, 如果数据内有position字段,position的优先级高于lngColumn

latColumn string "lat" 可选

点坐标时,纬度值对应的字段名称

altColumn string "alt" 可选

点坐标时,高度值对应的字段名称

onCreateGraphic function 可选

解析geojson后,外部自定义方法来创建Graphic对象

allowDrillPick boolean | function 可选

是否允许鼠标穿透拾取

opacity number 1.0 可选

透明度(部分图层),取值范围:0.0-1.0

zIndex number 可选

控制图层的叠加层次(部分图层),默认按加载的顺序进行叠加,但也可以自定义叠加顺序,数字大的在上面。

symbol object | function 可选

矢量数据的style样式,为Function时是完全自定义的回调处理 symbol(attr, style, feature)

参数名称 类型 描述信息
type GraphicType | string 可选

标识数据类型,默认是根据数据生成 point、polyline、polygon

styleOptions object

Style样式,每种不同类型数据都有不同的样式,具体见各GraphicType矢量数据的style参数。

styleField string 可选

按 styleField 属性设置不同样式。

styleFieldOptions object 可选

按styleField值与对应style样式的键值对象。

merge boolean 可选

是否合并并覆盖json中已有的style,默认不合并。

callback function 可选

自定义判断处理返回style ,示例:callback: function (attr, styleOpt){ return { color: "#ff0000" }; }

graphicOptions object 可选

默认的graphic的构造参数,每种不同类型数据都有不同的属性,具体见各GraphicType矢量数据的构造参数。

clustering object 可选

设置聚合相关参数(仅对Label、Point、Billboard 3种对象有效):

参数名称 类型 默认值 描述信息
enabled boolean false 可选

是否开启聚合

pixelRange number 20 可选

多少像素矩形范围内聚合

minimumClusterSize number 2 可选

可以聚集的屏幕空间对象的最小数量

clampToGround boolean true 可选

是否贴地

style BillboardEntity.StyleOptions | PointEntity.StyleOptions | object 可选

聚合点的样式参数

radius number 26 可选

内置样式时,圆形图标的半径大小(单位:像素)

fontColor string '#ffffff' 可选

内置样式时,数字的颜色

color string 'rgba(181, 226, 140, 0.6)' 可选

内置样式时,圆形图标的背景颜色

opacity number 0.5