Polyline

属性列表

属性详细说明

cache Objectreadonly inherited

缓存用于存储从几何图形中计算的值，这些几何图形需要在突变时清除或重新计算。 例如多边形的范围。

declaredClass Stringreadonly inherited

起始版本: GeoScene API for JavaScript 4.22

类名。类的名称声明格式为 geoscene.folder.className。

extent Extentreadonly inherited

几何的范围。 对于一个点，范围为空。

hasM Boolean inherited

指示几何是否具有 M 值。

hasZ Boolean inherited

指示几何是否具有 z 值（高程）。

在地理或公制坐标系中定义的

Z 值是 以米单位。 但是，在使用投影坐标系的局部场景中，假定垂直单位与服务指定的水平单位相同。

paths Number[][][]

构成线的路径或线段数组。每个路径都是一个二维数字数组，表示视图空间参考中路径中每个折点的坐标。每个折点表示为一个由两个、三个或四个数字组成的数组。下表显示了折点数组的各种结构。

实例	折点数组
无 z 值且无 m 值	[x, y]
无 z 值且具有 m 值	[x, y, m]
具有 z 值且无 m 值	[x, y, z]
具有 z 值且具有 m 值	[x, y, z, m]

示例代码：

// 具有 m 值的路径的二维线（请注意，第二条路径没有定义 m 值）
let paths = [
 [  // 第一路径
  [-97.06138,32.837,5],
  [-97.06133,32.836,6],
  [-97.06124,32.834,7]
 ], [  // 第二路径
  [-97.06326,32.759],
  [-97.06298,32.755]
 ]
];

let line = new Polyline({
  hasZ: false,
  hasM: true,
  paths: paths,
  spatialReference: { wkid: 4326 }
});

spatialReference SpatialReferenceautocast inherited

几何的空间参考。

 

默认值:WGS84 (wkid: 4326)

type Stringreadonly

对于 Polyline 类型始终为 "polyline"。

方法列表

方法详细说明

addPath(points){Polyline}

将路径或线段添加到线。添加时，路径的索引将递增 1。

参数：

points Point[]|Number[][] 线路径。这可以定义为点几何数组或 XY 坐标数组。

返回值：

类型	描述
Polyline	返回包含新路径的线。

clone(){Polyline}

创建 Polyline 对象的深度克隆。

返回值：

类型	描述
Polyline	Polyline 对象的新实例，该对象等于用于调用 .clone() 的对象。

fromJSON(json){*}static

创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象的值对其进行初始化。传递给输入 json 参数的对象通常来自对 REST API 中的查询操作的响应，或者来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用此函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。

参数：

json Object GeoScene 格式的实例的 JSON 表示形式。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。

返回值：

类型	描述
*	返回一个该类的新实例。

getPoint(pathIndex, pointIndex){Point}

返回由路径和路径中的点指定的点。

参数：

pathIndex Number 线中路径的索引。

pointIndex Number 路径中点的索引。

返回值：

类型	描述
Point	返回位于给定路径和点索引中的 Polyline 沿线的点。

insertPoint(pathIndex, pointIndex, point){Polyline}

将新点插入到线中。

参数：

pathIndex Number 要在其中插入点的路径的索引。

pointIndex Number 路径中插入点的索引。

point Point|Number[] 要插入的点。

返回值：

类型	描述
Polyline	返回更新的线。

removePath(index){Point[]}

从 Polyline 中删除路径。索引指定要删除的路径。

参数：

index Number 要从线中删除的路径的索引。

返回值：

类型	描述
Point[]	返回一个表示已删除路径的点数组。

removePoint(pathIndex, pointIndex){Point}

在给定 pathIndex 标识的路径内的给定 pointIndex 处从线上移除一个点。

参数：

pathIndex Number 包含要移除的点的路径的索引。

pointIndex Number 路径中要删除的点的索引。

返回值：

类型	描述
Point	返回已删除的点。

setPoint(pathIndex, pointIndex, point){Polyline}

更新线中的点。

参数：

pathIndex Number 包含要更新的点的路径的索引。

pointIndex Number 路径中要更新的点的索引。

point Point|Number[] 要在路径中更新的点几何。

返回值：

类型	描述
Polyline	返回更新的线。

toJSON(){Object}inherited

将此类的实例转换为其 GeoScene portal JSON 表示形式。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回值：

类型	描述
Object	实例的 GeoScene portal JSON 表示形式。