【一起学习Arcade】(2)：Geometry函数

第二篇记录下Geometry函数，相对于其它语言，Arcade对Geometry的支持是一大亮点，这使得它的上限被大大提高了。

---

**三、**Geometry函数

1、Angle【角度】

单位为度（0-360），正北为90度，只考虑x-y平面。忽略任何z坐标。

// 返回点和要素之间的角度【两点之间的角度】
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
Angle(pointA, $feature)
// 三点之间的角度
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
var pointC = Point({ "x":308654, "y":9005421, "spatialReference": { "wkid": 3857 } });
Angle(pointA, $feature, pointC)

连接的字符串间可以添加符号：

Concatenate([$feature.DLBM,$feature.DLMC,$feature.QSDWMC],"/")
return "0307/其他林地/小村村"

2、Area【面积】

第二个参数是面积单位，可以不输入。

Area($feature, 'square-meters')

**3、**AreaGeodetic【大地测量面积】

盲猜应该就是椭球面积，待验证。

AreaGeodetic($feature, 'square-meters')

4、 Buffer【缓冲区】

和缓冲工具生成的结果差不多。

Buffer($feature, 0.5, 'miles')

5、 BufferGeodetic【Geodetic缓冲区**】**

也是缓冲区，不过是大地测量的，不知道用在什么地方...

BufferGeodetic($feature, 0.5, 'miles')

6、 Centroid【质心点**】**

返回输入几何体的质心。

// 可以返回要素的质心
Centroid($feature)
// 也可以返回环（Geometry）的质心
var ringPoints = Geometry($feature).rings[0];
Centroid(ringPoints);

7、 Clip【裁剪**】**

跟裁剪工具差不多，参数1是输入要素，参数2是裁剪要素。

var envelope = Extent({ ... });
Clip($feature, envelope)

8、 Contains【图形包含**】**

判断一个几何图形是否包含另一个几何图形。Contains返回值有2个情况，一种是布尔值，一种是返回包含在内部的要素集 FeatureSet。

// 参数2是feature的话，返回布尔值
var container = Polygon({ ... });
Contains(containerGeometry, $feature);
// 参数2是features的话，返回features
var parcels = FeatureSetByName($map, 'parcels')
var projectArea = $feature;
Count(Contains(projectArea, parcels));

9、 ConvexHull【凸包**】**

计算几何体的凸包。凸包是包围几何体的最小凸多边形。

var pacman_like_shape = Polygon({
       "rings": [[[1, 2], [2, 0], [1, -2], [-1, -2], [-2, -1], [-1, -1.5], [0, -1.5], [-2, 1], [-1, 2]]],
       "spatialReference": { "wkid": 3857 }
});
return ConvexHull(pacman_like_shape).rings[0];
// Returns the geometry [[1,2],[2,0],[1,-2],[-1,-2],[-2,-1],[-2,1],[-1,2],[1,2]]

10、 Crosses【相交**】**

判断一个几何图形是否与另一个几何图元相交。

var geom2 = Polygon({ ... });
Crosses($feature, geom2);

11、 Cut【剪切**】**

包括线线剪切，线面剪切等。

var cutter = Polyline({ ... });
Cut($feature, cutter));

12、 DefaultValue【获取值**】**

如果几何体中不存在关键点，或者指定关键点处的值为null或为空文本值，则返回指定的默认值。

找一个要素的Z值的情况：

// 如果有Z值的话返回Z值，没有的话就返回1000
DefaultValue(Geometry($feature), "z", 1000)

如果是找多层的值就麻烦一点，这里找第一个环的第一个点的"z"值，值为100，就返回100。

var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",0,0,"z"], 1000)

如果是去找第3个环，然而不存在这个对象，则返回默认值1000。

var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",2,0,"z"], 1000)

环找到，但是对应的M值没有的情况，一样返回默认值1000。

var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",0,0,"m"], 100)

13、 Densify【加密**】**

通过插入顶点以创建不超过指定间隔的线段来加密几何体。

// 按最大间隔10米来加密线段
var maxLength = 10;
Densify($feature, maxLength, 'meters');

14、 DensifyGeodetic【Geodetic加密**】**

DensifyGeodetic($feature, 10000, 'meters');

15、 Difference【擦除**】**

类似擦除工具。

var subtractor = Polygon({ ... });
Difference($feature, subtractor);

16、 Disjoint【不相交判断**】**

判断2个要素是否不相交，返回布尔值。

var geom2 = Polygon({ ... });
Disjoint($feature, geom2);

17、 Distance【距离**】**

以给定单位返回两个几何图形之间的平面距离。

var geom2 = Point({ ... });
Distance($feature, geom2, 'meters')

18、 DistanceToCoordinate【沿线移动得到的坐标**】**

返回基于给定距离沿输入线的坐标。返回值为Dictionary，里面含有一个coordinate属性，即坐标点。

var result = DistanceToCoordinate($feature, 1038);
return result.coordinate;

19、 EnvelopeIntersects【包络线相交**】**

判断一个几何图形的包络线（或范围）是否与另一个几何图元的包络线相交。。

var geom2 = Polygon({ ... });
EnvelopeIntersects($feature, geom2);

20、 Equals【相等**】**

在给定数据的空间参考和容差的情况下，判断两个几何图形是否相等。

var geom2 = Point({ ... });
Equals($feature, geom2);

21、 Extent【范围**】**

从字典中构造一个【Extent】对象。

Extent({
  xMax: -95.34,
  xMin: -97.06138,
  yMax: 32.837,
  yMin: 12.003,
  hasM: false,
  hasZ: false,
  spatialReference: { wkid: 3857 }
});

或者从Geometry构造一个【Extent】对象。

Extent($feature);

或者从序列化的JSON文本构造Extent对象。

var extentJSON = '{"xmin": -109.55, "ymin": 25.76, "xmax": -86.39, "ymax": 49.94, "spatialReference": { "wkid": 3857 }}';
Extent(extentJSON);

22、 Generalize【概化**】**

和编辑里的概化是一样的作用。

例如：删除顶点，使线段距离原始几何体不超过100米

Generalize($feature, 100, true, 'meters')

23、 Geometry【构造Geometry**】**

从要素、序列化的JSON文本或字典构造Geometry对象。

// 从要素
Geometry($feature)
// 从Json文本
var pointJSON = {"x": -118.15, "y": 33.80, "spatialReference": { "wkid": 3857 } };
Geometry(pointJSON);

24、 HasValue【判断是否有值**】**

判断几何图形在给定键或索引处是否具有值。

if( TypeOf(Geometry($feature)) == "Point"){
  return HasValue(Geometry($feature), "z")
  // returns true
}

if( TypeOf(Geometry($feature)) == "Polygon"){
  return HasValue(Geometry($feature), "verticalCoordinateSystem")
  // returns false
}

多层查找：

var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

if(HasValue(shape, ["rings",0,0,"x"])){
  return shape.rings[0][0].x;
  // returns -97.06138
}

25、 Intersection【相交**】**

和相交工具一样。

var geom2 = Polygon({ ... });
Area(Intersection($feature, geom2), 'square-miles');

26、 Intersects【相交判断**】**

判断2个要素是否相交，返回布尔值。

var geom2 = Polygon({ ... });
Intersects($feature, geom2);

27、 IsSelfIntersecting【自相交判断**】**

判断Geometry是否存在自相交。

var polyline = Polyline({ ... });
IsSelfIntersecting(polyline);

28、 IsSimple【单部件判断**】**

判断要素是否是单部件，返回布尔值。

IsSimple($feature);

29、 MultiPartToSinglePart【多部件转单部件**】**

和多部件转单部件作用相同。

var allParts = MultiPartToSinglePart($feature)

30、 Multipoint【多点**】**

从点坐标、Json文本构造多点对象。

// 从属性定义构造
Multipoint({
  hasM: true,
  hasZ: true,
  points: [
    [-97.06138,32.837,1000,0],
    [-97.06133,32.836,1500,15],
    [-97.06124,32.834,1000,30],
    [-97.06127,32.832,500,50],
    [-97.06138,32.837,1000,0]
  ],
  spatialReference: { wkid: 3857 }
});
// 从Json文本构造
var multipointJSON = '{"points": [[-97.06138,32.837],[-97.06133,32.836],[-97.06124,32.834],[-97.06127,32.832]],"spatialReference" : { "wkid": 3857 }}';
Multipoint(multipointJSON);

31、 NearestCoordinate【最近点**】**

返回输入几何体与搜索点最近的坐标（而非顶点）。返回的字典还包括从搜索点到最近坐标的最短平面距离。如果搜索点与输入几何体相交，则搜索点将作为距离为零的结果返回。

var buildings = FeatureSetByPortalItem(
  Portal('https://www.arcgis.com'),
  '7b1fb95ab77f40bf8aa09c8b59045449',
  0,
  ['*'],
  true
);
var nearestBuilding = First(Intersects(buildings, BufferGeodetic($feature, 100, "feet")));
var result = NearestCoordinate(nearestBuilding, $feature);
return result.distance;
// or
return result.coordinate;

32、 Offset【偏移**】**

和编辑里的偏移作用相同。

Offset($feature, 10, 'meters', 'square');

33、 Overlaps【长度**】**

判断一个几何图形是否与另一个几何图元重叠。

var geom2 = Polygon({ ... });
Overlaps($feature, geom2);

34、 Point【构造点**】**

// 从字典构造Point对象
Point({
  hasM: true,
  hasZ: true,
  x: -97.06138,
  y: 32.837,
  z: 1500,
  m: 15,
  spatialReference: { wkid: 3857 }
});
// 从JSON文本构造Point对象
var pointJSON = '{ "x": -118.15, "y": 33.80, "spatialReference": { "wkid": 3857 }}';
Point(pointJSON)

35、 PointToCoordinate【点到Geometry的距离**】**

例如：根据单击的位置返回到输入多段线上最近坐标的距离。

var result;

if (TypeOf($userInput) == "Point"){
  result = PointToCoordinate(Geometry($feature), $userInput);
}

return result.distanceAlong;

36、 Polygon【构建面**】**

// 从字典构造，有内环的情况
Polygon({
  rings: [
    [
      [-97.06138,32.837],
      [-97.06133,32.836],
      [-97.06124,32.834],
      [-97.06127,32.832],
      [-97.06138,32.837]
    ],
    [
      [-97.06326,32.759],
      [-97.06298,32.755],
      [-97.06326,32.759]
    ]
  ],
  spatialReference: { wkid: 3857 }
});
// 从json构造
var polygonJSON = '{"rings": [[[-97.06138,32.837],[-97.06133,32.836],[-97.06124,32.834],[-97.06127,32.832], [-97.06138,32.837]],[[-97.06326,32.759],[-97.06298,32.755],[-97.06153,32.749], [-97.06326,32.759]]],"spatialReference": { "wkid": 3857 }}';
Polygon(polygonJSON);

37、 Polyline【构造线**】**

// 从字典构造，多部件的线
Polyline({
  hasM: true,
  hasZ: true,
  paths: [
    [
      [-97.06138,32.837],
      [-97.06133,32.836],
      [-97.06124,32.834],
      [-97.06127,32.832]
    ],
    [
      [-97.06326,32.759],
      [-97.06298,32.755]
    ]
  ],
  spatialReference: { wkid: 3857 }
});
// 从json构造
var polylineJSON = '{"paths": [[[-97.06138,32.837],[-97.06133,32.836],[-97.06124,32.834],[-97.06127,32.832]], [[-97.06326,32.759],[-97.06298,32.755]]], "spatialReference": { "wkid": 3857 } }'
Polyline(polylineJSON);

38、 RingIsClockwise【顺时针**】**

判断多边形环中的点是否按顺时针方向排列。

var polygonRings = Geometry($feature).rings;
IIf(RingIsClockwise(polygonRings[0]), 'correct polygon', 'incorrect direction')

39、 Rotate【旋转**】**

按几何体的质心、指定的度数将几何体逆时针旋转。

Rotate($feature, 90)

40、 SetGeometry【设置或替换Geometry**】**

var pointFeature = Feature(Point( ... ), 'name', 'buffer centroid');
var mileBuffer = BufferGeodetic(Geometry(pointFeature), 1, 'mile');
SetGeometry(pointFeature, mileBuffer);

41、 Simplify【简化**】**

对几何图形执行简化操作。

Simplify($feature);

42、 SymmetricDifference【交集取反**】**

和交集取反工具效果相同。

var geom2 = Polygon({ ... });
SymmetricDifference($feature, geom2);

43、 Union【联合**】**

和联合工具效果相同。

var geom2 = Polygon({ ... });
Union([ $feature, geom2 ]);

44、 Within【包含**】**

判断一个几何体是否在另一个几何体内。

var outerGeom = Polygon({ ... });
Within($feature, outerGeom);