geom - Documentation

几何分析API

成员列表

(static, readonly) relations :String

空间关系枚举值

Type:

String

Properties:

Name	Type	Description
`contains`	String
`crosses`	String
`disjoint`	String
`intersects`	String
`overlaps`	String
`touches`	String
`within`	String

方法列表

(static) area(geometries, options, onSuccess可选, onError可选)

测量面积

Parameters:

Name Type Attributes Description

geometries Array 需要量测的多边形数组

options

Object

选项

Properties

Name	Type	Attributes	Default	Description
`geodetic`	Boolean	<optional>	false	如果对象的坐标为经纬度坐标，可以通过指定geodetic参数为true使结果返回真实的球面面积
`inSR`	String	<optional>		需要测量的多边形数组的坐标系，如4326
`measureSR`	String	<optional>		计算多边形面积使用的坐标系，如3857

onSuccess function <optional> 请求成功的回调函数

onError function <optional> 请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.area(
    [[[[0,0],[3,0],[3,3],[0,3]],[[1,1],[2,1],[2,2],[1,2]]]],
    {
        geodetic: true
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) buffer(geometries, distances, options, onSuccess可选, onError可选)

缓冲区分析

Parameters:

Name Type Attributes Description

geometries Array 需要分析的几何图形数组

distances Array 缓冲区距离，通过指定距离数组可以对同一对象进行多次缓冲区分析

options

Object

选项

Properties

Name	Type	Attributes	Default	Description
`unionResults`	Boolean	<optional>	false	是否合并结果，如设为true则返回合并后的多边形
`inSR`	String	<optional>		输入坐标系
`outSR`	String	<optional>		输出坐标系
`bufferSR`	String	<optional>		计算缓冲区范围使用的坐标系
`quadSegs`	String	<optional>	8	缓冲区结果中拟合曲线时，组成四分之一圆弧的点的个数

onSuccess function <optional> 请求成功的回调函数

onError function <optional> 请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.buffer(
    [[0,0]],
    [10],
    {
        quadSegs: 10
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) centroid(geometries, onSuccess可选, onError可选)

求取质心

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.centroid(
    [[[0,0],[5,0],[5,5]]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) convexHull(geometries, onSuccess可选, onError可选)

凸包分析

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.convexHull(
    [[[0,0],[1,1],[0,1]]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) densify(geometries, maxSegLength, onSuccess可选, onError可选)

加密节点

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`maxSegLength`	Number		线段最大长度
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.densify(
    [[[0,0],[1,1],[2,2]]],
    1,
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) diff(geometries, geometry, onSuccess可选, onError可选)

求差异部分

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`geometry`	Array \| Object		用于比较的几何图形
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.diff(
    [[[0,0],[5,0]]],
    [[2,-5],[2,5]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) distance(geometries, geometry, onSuccess可选, onError可选)

求最短距离

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`geometry`	Array \| Object		用于比较的几何图形
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.distance(
    [[[0,0],[5,0]]],
    [[1,2],[2,3]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) intersect(geometries, geometry, onSuccess可选, onError可选)

求相交部分

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`geometry`	Array \| Object		用于比较的几何图形
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.intersect(
    [[[0,0],[5,0]]],
    [[2,-5],[2,5]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) length(geometries, options, onSuccess可选, onError可选)

测量长度

Parameters:

Name Type Attributes Description

geometries Array 需要测量的线段数组

options

Object

选项

Properties

Name	Type	Attributes	Default	Description
`geodetic`	Boolean	<optional>	false	如果对象的坐标为经纬度坐标，可以通过指定geodetic参数为true使结果返回真实的球面面积
`inSR`	String	<optional>		需要测量的多边形数组的坐标系，如4326
`measureSR`	String	<optional>		计算多边形面积使用的坐标系，如3857

onSuccess function <optional> 请求成功的回调函数

onError function <optional> 请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.length(
    [[[0,0],[5,0]],[[[0,0],[5,0],[5,5]]]],
    {
        geodetic: true
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) project(geometries, inSR, outSR, onSuccess可选, onError可选)

投影

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`inSR`	String		输入坐标系
`outSR`	String		输出坐标系
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.project(
    [[0,0],[1,1],[2,2]],
    4326,
    3857,
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) relation(geometries1, geometries2, relation, onSuccess可选, onError可选)

空间关系判断

Parameters:

Name	Type	Attributes	Description
`geometries1`	Array		需要分析的几何图形数组
`geometries2`	Array		需要分析的几何图形数组
`relation`	GAPI.geom.relations		需要满足的空间关系
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.relation(
    [[[[0,0],[1,1],[1,0]]]],
    [[0.3,0.1],[3,3]],
    GAPI.geom.relations.contains,
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) simplify(geometries, options, onSuccess可选, onError可选)

简化

Parameters:

Name Type Attributes Description

geometries Array 需要分析的几何图形数组

options

Object

选项

Properties

Name	Type	Attributes	Default	Description
`tolerance`	Number	<optional>	1e-6	化简使用的最小容差距离
`preserveTopo`	Boolean	<optional>	false	是否保持拓扑关系

onSuccess function <optional> 请求成功的回调函数

onError function <optional> 请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.simplify(
    [[[0,0],[0,10],[10,10]]],
    {
        tolerance: 8,
        preserveTopo: true
    },
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) symDiff(geometries, geometry, onSuccess可选, onError可选)

去除相交部分

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`geometry`	Array \| Object		用于比较的几何图形
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.symDiff(
    [[[[0,0],[0,10],[10,10],[10,0]]]],
    [[[0,0],[0,5],[5,10],[10,0]]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);

(static) union(geometries, onSuccess可选, onError可选)

合并

Parameters:

Name	Type	Attributes	Description
`geometries`	Array		需要分析的几何图形数组
`onSuccess`	function	<optional>	请求成功的回调函数
`onError`	function	<optional>	请求失败的回调函数

Returns:

GAPI

Example

GAPI.geom.union(
    [[0,0],[1,1]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);