GAPI. geom

几何分析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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
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:
Example
GAPI.geom.union(
    [[0,0],[1,1]],
    function(data){console.log(data)},
    function(error){console.error(error)}
);