Appearance
Polygon
Polygon
构造多边形对象,通过PolygonOptions指定多边形样式以及属性
Examples
javascript
const polygon = new DiMap.Polygon({
map: map,
path: [
[116.403322, 39.920255],
[116.410703, 39.897555],
[116.402292, 39.892353],
[116.389846, 39.891365],
[116.375250, 39.904843],
[116.384765, 39.916092],
[116.403322, 39.920255]
],
strokeColor: '#FF33FF',
strokeOpacity: 1,
strokeWeight: 3,
fillColor: '#1791fc',
fillOpacity: 0.4,
height: 100,
extrusionHeight: 100,
strokeStyle: 'solid',
strokeDasharray: [10, 10],
userData: {
name: 'polygon'
}
})
polygon.show()
polygon.setOptions({
strokeColor: '#FF33FF',
strokeOpacity: 1,
strokeWeight: 3
})constructor
Parameters
optionsPolygonOptions 多边形参数
setPath
设置path
Parameters
| 参数名 | 必选 | 类型 | 描述 |
|---|---|---|---|
path | 是 | PolygonOptionsPath | 多边形轮廓线的节点坐标数组。支持单个普通多边形LngLatLike[]、单个带孔多边形LngLatLike[][]、多个带孔多边形LngLatLike[][][] |
immediate | 否 | boolean | 是否立即更新,默认值为 false |
Returns this
getPath
获取path
Returns PolygonOptionsPath
getBounds
获取多边形矩形范围对象
Examples
javascript
const bounds = polygon.getBounds()
map.fitBounds(bounds, {
padding: 100
})Returns LngLatBounds
setHeight
设置多边形离地高度
Parameters
heightnumber 多边形离地高度,单位米
Returns this
setExtrusionHeight
设置立面体高度值
Parameters
extrusionHeightnumber 立面体高度值,单位米
Returns this
getExtrusionHeight
返回立体面高度值
Returns number 立体面高度值
contains
判断坐标是否在多边形内
Parameters
originPointLngLatLike
Returns boolean true 包含,false 不包含
getArea
多边形面积
Returns number
PolygonOptions
多边形属性
Properties
| 参数名 | 必选 | 类型 | 描述 |
|---|---|---|---|
map | 是 | Map | 地图实例对象 |
path | 是 | PolygonOptionsPath | 多边形轮廓线的节点坐标数组。支持单个普通多边形LngLatLike[]、单个带孔多边形LngLatLike[][]、多个带孔多边形LngLatLike[][][] |
zIndex | 否 | number | 多边形覆盖物的叠加顺序 |
strokeColor | 否 | string | 线条颜色,默认值为#00D3FC |
strokeOpacity | 否 | number | 轮廓线透明度,取值范围[0,1],默认为0.9 |
strokeWeight | 否 | number | 轮廓线宽度 |
fillColor | 否 | string | 多边形填充颜色,使用16进制颜色代码赋值,如:#00B2D5 |
fillOpacity | 否 | number | 多边形填充透明度,取值范围[0,1],默认为0.5 |
height | 否 | number | 设置polygon是否离地绘制,默认值为0(需配合extrusionHeight一起使用,且只能≤extrusionHeight) |
extrusionHeight | 否 | number | 设置多边形是否拉伸为的立面体高度值,默认值为0 |
strokeStyle | 否 | string | 轮廓线样式,实线:solid,虚线:dashed |
strokeDasharray | 否 | Array<number> | 虚线样式,仅在strokeStyle为dashed时有效(IE9+)。取值示例:[0,0,0]实线、[10,10]虚线、[10,2,10]点画线 |
userData | 否 | Record<string, any> | 用户自定义数据对象 |
PolygonOptionsPath
多边形路径参数
| 形式 | 类型 | 描述 |
|---|---|---|
| 单个普通多边形 | Array<LngLatLike> | 单个普通多边形的路径,由一系列坐标点组成 |
| 单个带孔多边形 | Array<Array<LngLatLike>> | 单个带孔多边形的路径,第一个元素为外多边形,其余为孔多边形 |
| 多个带孔多边形 | Array<Array<Array<LngLatLike>>> | 多个带孔多边形的路径,每个元素都是一个带孔多边形 |