Skip to content

Polygon ​

Polygon ​

构造多边形对象,通过PolygonOptions指定多边形样式以及属性

继承OverlayBase

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 ​

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 ​

  • height number 多边形离地高度,单位米

Returns this

setExtrusionHeight ​

设置立面体高度值

Parameters ​

  • extrusionHeight number 立面体高度值,单位米

Returns this

getExtrusionHeight ​

返回立面体高度值

Returns number 立面体高度值

contains ​

判断坐标是否在多边形内

Parameters ​

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设置多边形是否离地绘制,默认值为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>>>多个带孔多边形的路径,每个元素都是一个带孔多边形