Python ArcGIS offset用法及代码示例

本文简要介绍 python 语言中 arcgis.geometry.offset 的用法。

用法:

arcgis.geometry.offset(geometries, offset_distance, offset_unit, offset_how='esriGeometryOffsetRounded', bevel_ratio=10, simplify_result=False, spatial_ref=None, gis=None, future=False)

返回：

Geometry 对象的列表，或 GeometryJob 对象。如果 future = True ，则结果是 Future 对象。调用 result() 获取响应。

offset 函数在Geometry 服务资源上执行。该函数构造与给定输入几何图形偏移的几何图形。如果偏移参数为正，则构造的偏移将位于几何体的右侧。左侧偏移是用负参数构造的。

注意：

从第一个顶点到最后一个顶点跟踪几何图形将为您提供沿几何图形的方向。正向和负向参数将决定偏移的构造位置，正是该方向的左右视角。在这些术语中，很容易推断将在何处构造水平几何形状的偏移量。

Keys	Description
geometries	Point 、 MultiPoint 、 Polyline 或 Polygon 对象的数组。数组中每个几何图形的结构与ArcGIS REST API 返回的 JSON 几何对象的结构相同。
offset_distance	指定基于输入几何构造偏移的距离。 注意： 如果offset_distance 参数为正，则构造的偏移量将位于曲线的右侧。 Left-side 偏移量是用负值构造的。
offset_unit	偏移距离的单位。如果未指定单位，则单位派生自 spatial_ref 。
offset_how	offset_how 参数确定如何处理段之间的外角。三个选项如下： esriGeometryOffsetRounded - Rounds the corner between extended offsets. esriGeometryOffsetBevelled - Squares off the corner after a given ratio distance. 3. esriGeometryOffsetMitered - Attempts to allow extended offsets to naturally intersect, but if that intersection occurs too far from the corner, the corner is eventually bevelled off at a fixed distance.
bevel_ratio	bevel_ratio 乘以 offset_distance ，结果确定斜接偏移交叉点在斜切之前可以定位多远。指定斜接时，bevel_ratio 将被忽略，内部使用 10。指定斜角时，如果未指定bevel_ratio，将使用1.1。 bevel_ratio 对于舍入偏移被忽略。
simplify_result	如果 simplify_result 设置为 true，则自相交循环将从结果偏移几何图形中删除。默认值为假。
spatial_ref	输入几何图形的 SpatialReference 众所周知的 ID 或 JSON 对象
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。如果将 future 设置为 True，则一次调用中可以处理的几何图形数量限制为 6500 个。

>>> new_job = offset( geometries = [geom1,geom2,...],
                      offset_distance = 100,
                      offset_unit = "esriMeters",
                      offset_how = "esriGeometryOffsetRounded",
                      bevel_ratio = 0,
                      simplify_result = True
                      spatial_ref = "wkid",
                      future = True)