注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

三维几何仿射变换

支持于: 批处理, 流式处理

对输入几何体应用三维仿射变换。此变换发生在用户提供的投影坐标系中，结果投影回WGS84。二维几何体在应用仿射变换之前，其z坐标将被设置为0。返回的几何体是三维的，对于每个坐标[x,y,z]，表示矩阵乘法[[x0, x1, x2, x-offset], [y0, y1, y2, y-offset], [z0, z1, z2, z-offset], [0, 0, 0, 1]] * [x, y, z, 1]，结果的前三个坐标值将被返回。

表达式类别: 地理空间

声明的参数

Geometry列 - 进行仿射变换的几何体。
Expression<字符串>
投影坐标系 - 格式为"authority"的坐标系标识符。例如，UTM 18N带可以通过EPSG:32618来标识。几何体将被转换为源坐标系，进行仿射变换，然后重新转换为WGS84。
Literal<字符串>
非必填 X偏移量 - 矩阵的(0,3)值，默认值为0.0。此参数表示几何体将在投影坐标中向正x方向平移的距离。
Literal<Double>
非必填 X0 - 矩阵的(0,0)值，默认值为1.0。
Literal<Double>
非必填 X1 - 矩阵的(0,1)值，默认值为0.0。
Literal<Double>
非必填 X2 - 矩阵的(0,2)值，默认值为0.0。
Literal<Double>
非必填 Y偏移量 - 矩阵的(1,3)值，默认值为0.0。此参数表示几何体将在投影坐标中向正y方向平移的距离。
Literal<Double>
非必填 Y0 - 矩阵的(1,0)值，默认值为0.0。
Literal<Double>
非必填 Y1 - 矩阵的(1,1)值，默认值为1.0。
Literal<Double>
非必填 Y2 - 矩阵的(1,2)值，默认值为0.0。
Literal<Double>
非必填 Z偏移量 - 矩阵的(2,3)值，默认值为0.0。此参数表示几何体将在投影坐标中向正z方向平移的距离。
Literal<Double>
非必填 Z0 - 矩阵的(2,0)值，默认值为0.0。
Literal<Double>
非必填 Z1 - 矩阵的(2,1)值，默认值为0.0。
Literal<Double>
非必填 Z2 - 矩阵的(2,2)值，默认值为1.0。
Literal<Double>

输出类型: Geometry

示例

示例 1: 基本案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:4326
X偏移量: 0.0
X0: 0.0
X1: -1.0
X2: 0.0
Y偏移量: 0.0
Y0: 1.0
Y1: 0.0
Y2: 0.0
Z偏移量: 0.0
Z0: 0.0
Z1: 0.0
Z2: 0.0

geometry	输出
{"type":"Polygon","coordinates":[[[0.0, 0.0],[1.0, 0.0],[1.0, 1.0],[0.0, 1.0],[0.0, 0.0]]]}	{"type":"Polygon","coordinates":[[[0.0, 0.0, 0.0],[0.0, 1.0, 0.0],[-1.0, 1.0, 0.0],[-1.0, 0.0, 0.0],[0.0, 0.0, 0.0]]]}

示例 2: 基本案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:4326
X偏移量: 1.0
X0: 0.0
X1: -3.0
X2: 0.0
Y偏移量: 2.0
Y0: 0.0
Y1: 2.0
Y2: 0.0
Z偏移量: 3.0
Z0: 0.0
Z1: 0.0
Z2: 1.0

geometry	输出
{"type":"Polygon","coordinates":[[[0.0, 0.0, 1.0],[1.0, 0.0, 2.0],[1.0, 1.0, 3.0],[0.0, 1.0, 2.0],[0.0, 0.0, 1.0]]]}	{"type":"Polygon","coordinates":[[[1.0, 2.0, 4.0],[1.0, 2.0, 5.0],[-2.0, 4.0, 6.0],[-2.0, 4.0, 5.0],[1.0, 2.0, 4.0]]]}

示例 3: 基本案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:4326
X偏移量: 0.0
X0: 2.0
X1: 0.0
X2: 0.0
Y偏移量: 0.0
Y0: 0.0
Y1: 3.0
Y2: 0.0
Z偏移量: 0.0
Z0: 0.0
Z1: 0.0
Z2: 4.0

geometry	输出
{"type":"Point","coordinates":[1.0, 2.0, 3.0]}	{"type":"Point","coordinates":[2.0, 6.0, 12.0]}
{"type":"LineString","coordinates":[[0.0, 1.0, 1.0], [1.0, 2.0, 3.0]]}	{"type":"LineString","coordinates":[[0.0, 3.0, 4.0],[2.0, 6.0, 12.0]]}
{"type":"Polygon","coordinates":[[[0.0, 0.0],[1.0, 0.0],[1.0, 1.0],[0.0, 1.0],[0.0, 0.0]]]}	{"type":"Polygon","coordinates":[[[0.0, 0.0, 0.0],[2.0, 0.0, 0.0],[2.0, 3.0, 0.0],[0.0, 3.0, 0.0],[0.0, 0.0, 0.0]]]}

示例 4: 基本案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:4326
X偏移量: 0.0
X0: 1.0
X1: 1.0
X2: 0.0
Y偏移量: 0.0
Y0: 0.0
Y1: 1.0
Y2: 0.0
Z偏移量: 0.0
Z0: 0.0
Z1: 0.0
Z2: 0.0

geometry	输出
{"type":"Polygon","coordinates":[[[0.0, 0.0],[1.0, 0.0],[1.0, 1.0],[0.0, 1.0],[0.0, 0.0]]]}	{"type":"Polygon","coordinates":[[[0.0, 0.0, 0.0],[1.0, 0.0, 0.0],[2.0, 1.0, 0.0],[1.0, 1.0, 0.0],[0.0, 0.0, 0.0]]]}

示例 5: 基本案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:4326
X偏移量: 1.0
X0: 1.0
X1: 0.0
X2: 0.0
Y偏移量: 1.0
Y0: 0.0
Y1: 1.0
Y2: 0.0
Z偏移量: 1.0
Z0: 0.0
Z1: 0.0
Z2: 1.0

geometry	输出
{"type":"Point","coordinates":[1.0, 2.0, 3.0]}	{"type":"Point","coordinates":[2.0, 3.0, 4.0]}
{"type":"LineString","coordinates":[[0.0, 1.0, 2.0], [1.0, 2.0, 3.0]]}	{"type":"LineString","coordinates":[[1.0, 2.0, 3.0],[2.0, 3.0, 4.0]]}
{"type":"Polygon","coordinates":[[[0.0, 0.0],[1.0, 0.0],[1.0, 1.0],[0.0, 1.0],[0.0, 0.0]]]}	{"type":"Polygon","coordinates":[[[1.0, 1.0, 1.0],[2.0, 1.0, 1.0],[2.0, 2.0, 1.0],[1.0, 2.0, 1.0],[1.0, 1.0, 1.0]]]}

示例 6: 空案例

参数值:

Geometry列: geometry
投影坐标系: EPSG:32618
X偏移量: 0.0
X0: 2.0
X1: 0.0
X2: 0.0
Y偏移量: 0.0
Y0: 3.0
Y1: 0.0
Y2: 0.0
Z偏移量: 0.0
Z0: 4.0
Z1: 0.0
Z2: 0.0

geometry	输出
null	null