# new MultiPoint(options)
多点几何对象
[ES5引入方式]:
Zondy.Geometry.MultiPoint() 
[ES6引入方式]:
import { MultiPoint } from "@mapgis/webclient-common" 
参数
| 名称 | 类型 | 默认值 | 描述 | 
|---|---|---|---|
| options | Object | 构造参数 | |
| coordinates | Array.<Number> | [] | 几何点的坐标,支持任意单位,参考示例:[多点几何对象] | 
| spatialReference | SpatialReference | new Zondy.SpatialReference('EPSG:4326') | 几何点的空间参考系,默认4326,当不是4326时请指定坐标系,方便进行投影转换,参考示例:[指定坐标系] | 
支持如下方法:
[1、添加点坐标][2、返回指定索引处的点]
[3、从多点中移除一个点]
[4、更新指定索引处的点]
[5、返回IGS所对应的GeometryModule型]
[6、返回igs1.0的几何对象]
[7、返回字符串]
[8、返回Dots对象,仅包括多边形的外圈] [9、通过传入的json构造并返回一个新的几何对象]
[10、导出为json对象]
11、克隆几何对象
    示例
创建几何对象
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
new MultiPoint({
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
})指定坐标系
// ES5引入方式
const { Point } = Zondy.Geometry
const { SpatialReference } = Zondy
// ES6引入方式
import { Point, SpatialReference } from "@mapgis/webclient-common"
new Point({
  // 现在为3857坐标系
  coordinates:[
    // 第一个点
    [12929863.44711455, 3934286.575385226],
    // 第二个点
    [12060733.232006868, 3377247.5680546067]
  ],
  // 当不是4326时请指定坐标系,方便进行投影转换
  spatialReference: new SpatialReference('EPSG:3857')
})继承关系
成员变量
成员变量概述
| 名称 | 类型 | 描述 | 
|---|---|---|
| coordinates | 
                                        
Array
                                     |  | 
| extent | 
                                        
Number
                                     |  | 
| hasZ | 
                                        
Boolean
                                     |  | 
| spatialReference | 
                                        
SpatialReference
                                     |  | 
成员变量详情
方法
方法概述
| 名称 | 返回值类型 | 描述 | 
|---|---|---|
| fromJSON | 
                                        
                                     |  | 
| addPoint | 
                                        
                                                
MultiPoint
                                            
                                     |  | 
| clone | 
                                        
                                                
Geometry
                                            
                                     |  | 
| contains | 
                                        
                                                
Boolean
                                            
                                     |  | 
| fromGeoJSON | 
                                        
                                     |  | 
| getGeometryType | 
                                        
                                                
String
                                            
                                     |  | 
| getIGSType | 
                                        
                                                
                                            
                                     |  | 
| getPoint | 
                                        
                                                
Point
                                            
                                     |  | 
| getType | 
                                        
                                                
String
                                            
                                     |  | 
| off | 
                                        
                                                
Object
                                            
                                     |  | 
| on | 
                                        
                                                
Object
                                            
                                     |  | 
| removePoint | 
                                        
                                                
Point
|
null
                                            
                                     |  | 
| setPoint | 
                                        
                                                
MultiPoint
                                            
                                     |  | 
| toDots | 
                                        
                                                
                                            
                                     |  | 
| toGeoJSON | 
                                        
                                                
Object
                                            
                                     |  | 
| toJSON | 
                                        
                                                
Object
                                            
                                     |  | 
| toOldIGSGeometry | 
                                        
                                                
                                            
                                     |  | 
| toString | 
                                        
                                                
                                            
                                     |  | 
| toXML | 
                                        
                                                
String
                                            
                                     |  | 
方法详情
# static fromJSON(jsonopt)
通过传入的json构造并返回一个新的几何对象
参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| json | Object | JSON对象 | 
示例
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
const json = {
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
}
const multiPoint = MultiPoint.fromJSON(json)# addPoint(point, modeopt)
添加点坐标,可以为Point对象、[x, y, z(可选)]数组、Point对象数组、[x, y, z(可选)]对象数组
参数
| 名称 | 类型 | 默认值 | 描述 | 
|---|---|---|---|
| point | Point | Array.<Number> | 可以是point,也可以是表示XY坐标的数字数组 | |
| mode | String | 'add' | 添加模式,add:正常添加,deduplication:去除重复点 | 
多点对象
示例
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
const multiPoint = new MultiPoint({
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
})
multiPoint.addPoint([102,2.0])# getPoint(index)
返回指定索引处的点
参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| index | Number | 点对象 | 
在指定下标处的点
示例
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
const multiPoint = new MultiPoint({
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
})
const point = multiPoint.getPoint(0)# off(typesopt, fnopt, contextopt)
移除事件
示例如下:
[1、移除一个事件的指定回调函数]
[2、移除一个事件的所有回调函数]
[3、移除多个事件的同一个指定的回调函数]
[4、移除多个指定事件的回调函数]
[5、删除时指定上下文 - types类型为字符串]
[6、删除时指定上下文 - types类型为对象]
参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| types | string | 移除指定事件类型上绑定的回调函数 | 
| fn | function | 事件回调函数,当types为字符串,且不指定要删除的回调函数时,删除该事件上的所有回调函数 | 
| context | Object | 事件回调函数的this关键字将指向的对象 | 
- Inherited From:
当前实例
示例
移除一个事件的指定回调函数
// 一个事件的回调函数
const clickFunction = function (event) {
  console.log("点击事件:", event)
}
// 调用MapView或SceneView的off方法移除一个事件的回调函数
view.off('click', clickFunction)移除一个事件的所有回调函数
// 一个事件的回调函数1
const clickFunction1 = function (event) {
  console.log("点击事件1:", event)
}
// 一个事件的回调函数2
const clickFunction2 = function (event) {
  console.log("点击事件2:", event)
}
// 调用MapView或SceneView的off方法移除一个事件的所有回调函数
// 不指定回调函数,则移除该事件上的所有绑定的回调函数
view.off('click')移除多个事件的同一个指定的回调函数
// 多个事件的同一个回调函数
const eventFunction = function (event) {
  console.log("事件:", event)
}
// 调用MapView或SceneView的off方法移除多个事件的同一个指定的回调函数
view.off('click double-click', eventFunction)移除多个指定事件的回调函数
// 一个事件的回调函数
const clickFunction = function (event) {
  console.log("click事件:", event)
}
// 调用MapView或SceneView的off方法移除多个指定事件的回调函数
view.off({
   // 移除click事件上一个指定的函数
  "click": clickFunction,
  // 移除double-click上所有指定的函数
  "double-click": undefined
})删除时指定上下文 - types类型为字符串
// 一个事件的回调函数
const clickFunction = function (event) {
  console.log("点击事件:", event)
}
// 调用MapView或SceneView的off方法移除一个事件的回调函数
view.off('click', clickFunction, view)
// 调用MapView或SceneView的off方法移除一个事件的所有回调函数
view.off('click', undefined, view)删除时指定上下文 - types类型为对象
// 一个事件的回调函数
const clickFunction = function (event) {
  console.log("click事件:", event)
}
// 调用MapView或SceneView的off方法移除多个指定事件的回调函数
view.off({
   // 移除click事件上一个指定的函数
  "click": clickFunction,
  // 移除double-click上所有指定的函数
  "double-click": undefined
}, view)# on(typesopt, fnopt, contextopt)
注册一个新的监听事件;
示例如下:
[1、注册一个事件]
[2、一次注册多个事件 - 同一个回调函数]
[3、一次注册多个事件 - 分别指回调应函数]
[4、当types为字符串时 - 指定上下文]
[5、当types为对象时 - 指定上下文]
参数
| 名称 | 类型 | 默认值 | 描述 | 
|---|---|---|---|
| types | String | Object | null | 事件类型 | 
| fn | function | null | 事件回调函数 | 
| context | Object | null | 事件回调函数的this关键字将指向的对象 | 
- Inherited From:
当前实例
示例
注册一个事件
// 初始化一个点击事件回调函数
const clickFunction = function (event) {
  console.log("点击事件:", event)
}
// 调用MapView或SceneView的on方法注册一个点击事件
view.on('click', clickFunction)一次注册多个事件 - 同一个回调函数
// 初始化一个事件回调函数
const eventFunction = function (event) {
  console.log("事件:", event)
}
// 调用MapView或SceneView的on方法注册多个事件
// 多个事件类型使用同一个回调函数
view.on('click right-click-down', eventFunction)一次注册多个事件 - 分别指回调应函数
// 初始化一个左键点击事件回调函数
const clickFunction = function (event) {
  console.log("click事件:", event)
}
// 初始化一个右键按下事件回调函数
const rightClickFunction = function (event) {
  console.log("right-click-down事件:", event)
}
// 调用MapView或SceneView的on方法注册多个事件
// 每一个事件类型,使用单独的回调函数
// 注意使用此种方式,一种类型的事件仅能指定一个回调函数
view.on({
  "click": clickFunction,
  "right-click-down": rightClickFunction
})指定上下文 - types类型为字符串
// 初始化一个点击事件回调函数
const clickFunction = function (event) {
  console.log("点击事件:", event)
  console.log("上下文对象:", this)
}
// 调用MapView或SceneView的on方法注册一个点击事件
// 指定view为回调函数的上下文对象
view.on('click', clickFunction, view)指定上下文 - types类型为对象
// 初始化一个点击事件回调函数
const clickFunction = function (event) {
  console.log("点击事件:", event)
  console.log("上下文对象:", this)
}
// 调用MapView或SceneView的on方法注册一个点击事件
// 指定view为回调函数的上下文对象
view.on({
  "click": clickFunction,
  "right-click-down": clickFunction
}, view)# removePoint(index)
从多点中移除一个点。索引指定要删除的点
参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| index | Number | 点对象 | 
返回被移除的点
示例
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
const multiPoint = new MultiPoint({
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
})
const point = multiPoint.removePoint(0)# setPoint(index, point)
更新指定索引处的点
参数
| 名称 | 类型 | 描述 | 
|---|---|---|
| index | Number | 点在points属性中的索引 | 
| point | Point | Array.<Number> | 在新位置指定的几何点 | 
返回更新后的多点
示例
// ES5引入方式
const { MultiPoint } = Zondy.Geometry
// ES6引入方式
import { MultiPoint } from "@mapgis/webclient-common"
const multiPoint = new MultiPoint({
  coordinates:[
    // 第一个点
    [100, 0.0],
    // 第二个点
    [101, 1.0]
  ]
})
multiPoint.setPoint(1, [103, 3.0])