类名 Point

# new Point(options)

点几何对象

[ES5引入方式]:
Zondy.Geometry.Point()
[ES6引入方式]:
import { Point } from "@mapgis/webclient-common"

参数

名称 类型 默认值 描述
options Object

构造参数

coordinates Array []

几何点的坐标数组,支持任意单位,参考示例:[点几何对象]

spatialReference SpatialReference new Zondy.SpatialReference('EPSG:4326')

几何点的空间参考系,默认4326,当不是4326时请指定坐标系,方便进行投影转换,参考示例:[指定坐标系]

支持如下方法:
[1、获取坐标数组]
[2、将另一个点对象的所有值复制到当前点对象]
[3、计算与另一个点的距离]
[4、判断两个点是否相等]
[5、归一化计算]
[6、返回字符串]
[7、返回IGS所对应的GeometryModule型]
[8、返回igs1.0的几何对象] [9、通过传入的json构造并返回一个新的几何对象]
[10、导出为json对象]
11、克隆几何对象

示例

创建几何对象

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
new Point({
  coordinates: [100.0, 0.0]
})

指定坐标系

// ES5引入方式
const { Point } = Zondy.Geometry
const { SpatialReference } = Zondy
// ES6引入方式
import { Point, SpatialReference } from "@mapgis/webclient-common"
new Point({
  // 现在为3857坐标系
  coordinates: [12929863.44711455, 3377247.5680546067],
  // 当不是4326时请指定坐标系,方便进行投影转换
  spatialReference: new SpatialReference('EPSG:3857')
})

继承关系

成员变量

成员变量概述

名称 类型 描述
coordinates Array

几何点的坐标数组

extent Number

外包盒

hasZ Boolean

是否含有z坐标

spatialReference SpatialReference

几何点的空间参考系

type GeometryType

几何类型

成员变量详情

Array

# coordinates

几何点的坐标数组

Number

# extent

外包盒

Overrides:
Boolean

# readonly hasZ

是否含有z坐标

Overrides:
SpatialReference

# spatialReference

几何点的空间参考系

Inherited From:
GeometryType

# type

几何类型

方法

方法概述

名称 返回值类型 描述
fromJSON

通过传入的json构造并返回一个新的几何对象

toCoordinates Array.<Number>
clone Geometry

克隆几何对象

copy Point

将另一个点对象的所有值复制到当前点对象

distance Number

计算与另一个点的距离

equals Boolean

判断两个点是否相等

fromGeoJSON

导入GeoJSON

getGeometryType String

获取GeometryModule型

getIGSType

返回IGS所对应的GeometryModule型

getType String

返回所对应的GeometryModule型

normalize Point

归一化计算

off Object

移除事件
示例如下:
[1、移除一个事件的指定回调函数]
[2、移除一个事件的所有回调函数]
[3、移除多个事件的同一个指定的回调函数]
[4、移除多个指定事件的回调函数]
[5、删除时指定上下文 - types类型为字符串]
[6、删除时指定上下文 - types类型为对象]

on Object

注册一个新的监听事件;
示例如下:
[1、注册一个事件]
[2、一次注册多个事件 - 同一个回调函数]
[3、一次注册多个事件 - 分别指回调应函数]
[4、当types为字符串时 - 指定上下文]
[5、当types为对象时 - 指定上下文]

toGeoJSON Object

导出为GeoJSON

toJSON Object

导出为json对象

toOldIGSGeometry

返回igs1.0的几何对象

toString String

返回如下格式的字符串:"x,y",如果有z,则返回"x,y,z"

toXML String

导出为OGC服务要求的xml字符串,子类实现

方法详情

# static fromJSON(jsonopt)

通过传入的json构造并返回一个新的几何对象

参数

名称 类型 描述
json Object

JSON对象

示例

通过传入的json构造并返回一个新的几何对象

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const json = {
  coordinates: [100.0, 0.0]
}
const point = new Point.fromJSON(json)

# static toCoordinates(point)

参数

名称 类型 描述
point Point | Array.<Number>

输入坐标信息

坐标数组

Array.<Number>
示例

获取坐标数组

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point = new Point({
  coordinates: [100.0, 0.0]
})
const coordinates = Point.toCoordinates(point)

# clone()

克隆几何对象

Overrides:

克隆后的几何对象

Geometry

# copy(point)

将另一个点对象的所有值复制到当前点对象

参数

名称 类型 描述
point Point

被复制的点对象

修改后的Point

Point
示例

将另一个点对象的所有值复制到当前点对象

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point1 = new Point({
  coordinates: [100.0, 0.0]
})
const point2 = new Point({
  coordinates: [200.0, 10.0]
})
point1.copy(point2)

# distance(point)

计算与另一个点的距离

参数

名称 类型 描述
point Point | Array.<Number>

用于计算距离的点

距离

Number
示例

计算与另一个点的距离

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point1 = new Point({
  coordinates: [100.0, 0.0]
})
const point2 = new Point({
  coordinates: [200.0, 10.0]
})
const distance = point1.distance(point2)

# equals(pointopt)

判断两个点是否相等

参数

名称 类型 默认值 描述
point Point | Array.<Number> null

点对象或坐标数组

两个点是否相等

Boolean
示例

判断两个点是否相等

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point1 = new Point({
  coordinates: [100.0, 0.0]
})
const point2 = new Point({
  coordinates: [200.0, 10.0]
})
const equal = point1.equals(point2)

# fromGeoJSON(GeoJSON)

导入GeoJSON

参数

名称 类型 描述
GeoJSON Object

Object

Inherited From:

# getGeometryType()

获取GeometryModule型

Inherited From:

GeometryModuleåž‹

String

# getIGSType()

返回IGS所对应的GeometryModule型

Overrides:

string GeometryModuleåž‹

# getType()

返回所对应的GeometryModule型

Inherited From:

GeometryModuleåž‹

String

# normalize()

归一化计算

归一化后的点对象

Point
示例

归一化计算

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point1 = new Point({
  coordinates: [100.0, 0.0]
})
const normalize = point1.normalize()

# off(typesopt, fnopt, contextopt)

参数

名称 类型 描述
types string

移除指定事件类型上绑定的回调函数
当类型为字符串时,可以移除单个或多个事件类型绑定的回调函数,单个事件:"click",多个事件:以空格分割:"click double-click";
当types为对象时,使用如下方式移除事件:{'click': onClickFun, 'mouse-move': onMouseMoveFun}

fn function

事件回调函数,当types为字符串,且不指定要删除的回调函数时,删除该事件上的所有回调函数

context Object

事件回调函数的this关键字将指向的对象

Inherited From:

当前实例

Object
示例

移除一个事件的指定回调函数

// 一个事件的回调函数
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)

参数

名称 类型 默认值 描述
types String | Object null

事件类型
当types为字符串时,可以定义单个或多个事件,单个事件:"click",多个事件:以空格分割:"click double-click";
当types为对象时,使用如下方式指定事件:{'click': onClickFun, 'mouse-move': onMouseMoveFun}

fn function null

事件回调函数

context Object null

事件回调函数的this关键字将指向的对象

Inherited From:

当前实例

Object
示例

注册一个事件

// 初始化一个点击事件回调函数
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)

# toGeoJSON()

导出为GeoJSON

Inherited From:

GeoJSON对象

Object

# toJSON()

导出为json对象

Overrides:

json对象

Object

# toOldIGSGeometry()

返回igs1.0的几何对象

Object igs1.0的几何对象

# toString()

返回如下格式的字符串:"x,y",如果有z,则返回"x,y,z"

Overrides:

字符串

String
示例

返回字符串

// ES5引入方式
const { Point } = Zondy.Geometry
// ES6引入方式
import { Point } from "@mapgis/webclient-common"
const point1 = new Point({
  coordinates: [100.0, 0.0]
})
const str = point1.toString()

# toXML()

导出为OGC服务要求的xml字符串,子类实现

Inherited From:

字符串

String