创建用于 模型构建器 的空间参考。
可使用已设置的坐标系、空间域和精度创建空间参考。要进一步修改输出空间参考的空间域和精度，可使用 XY 值域、Z 值域、M 值域、XY 值域模板和 XY 值域增长百分比参数。
XY、Z 和 M 范围与空间参考域有所不同。空间参考中的 XY、Z 和 M 域用于定义可存储在要素类中的坐标值的有效范围。要素类范围反映了存在于要素类中的坐标值的实际范围。这些范围不能大于域。
XY 值域模板参数所在的坐标系不必与空间参考或空间参考模板中所指定的坐标系相同。如果两个坐标系不同，则会对范围进行投影以使其相互匹配。
如果空间参考和空间参考模板参数均已设置，则空间参考参数具有较高的优先级。
此工具的所有参数均为可选设置。如果未指定任何参数，则空间参考将被定义为“未知”，而 XY 值域则将采用标准默认设置。
在 模型构建器 中，可使用空间参考参数（如创建要素类、创建要素数据集和创建 XY 事件图层）将此工具的输出用作工具的输入。
在 Python 中，还可使用 SpatialReference 类创建空间参考。
| 标注 | 说明 | 数据类型 |
空间参考 (可选) | 要创建的空间参考的名称。 | Spatial Reference |
XY 值域 (可选) | 允许的 x,y 坐标的坐标范围。 | Envelope |
Z 值域(最小值，最大值) (可选) | 允许的 z 值的坐标范围。 | String |
M 值域(最小值，最大值) (可选) | 允许的 m 值的坐标范围。 | String |
XY 值域模板 (可选) | 可用于定义 XY 值域的要素类或图层。 | Feature Layer |
XY 值域增长百分比 (可选) | 展开 XY 值域时使用的百分比。 | Double |
| 标注 | 说明 | 数据类型 |
| 输出空间参考 | 输出空间参考。 在 模型构建器 中，可使用空间参考参数（如创建要素类、创建要素数据集和创建 XY 事件图层）将此工具的输出用作工具的输入。 | 空间参考 |
arcpy.management.CreateSpatialReference({spatial_reference}, {xy_domain}, {z_domain}, {m_domain}, {template}, {expand_ratio})| 名称 | 说明 | 数据类型 |
spatial_reference (可选) | 要创建的空间参考的名称。 | Spatial Reference |
xy_domain (可选) | 允许的 x,y 坐标的坐标范围。 | Envelope |
z_domain (可选) | 允许的 z 值的坐标范围。 | String |
m_domain (可选) | 允许的 m 值的坐标范围。 | String |
template [template,...] (可选) | 可用于定义 XY 值域的要素类或图层。 | Feature Layer |
expand_ratio (可选) | 展开 XY 值域时使用的百分比。 | Double |
| 名称 | 说明 | 数据类型 |
| out_spatial_reference | 输出空间参考。 在 模型构建器 中，可使用空间参考参数（如创建要素类、创建要素数据集和创建 XY 事件图层）将此工具的输出用作工具的输入。 | 空间参考 |
以下独立脚本将 CreateSpatialReference 函数用作工作流的一部分，该工作流在文件夹中进行循环、查找所有以 ST 结尾的 shapefile、创建空间参考，并将其追加到地理数据库要素类中。
# This script reprojects a shapefile in Redlands folder
# from NAD 1983 UTM Zone 11N
# to NAD 1983 StatePlane California V FIPS 0405 (US Feet)
# import system modules
import arcpy
try:
# set the workspace environment
arcpy.env.workspace = r"C:\data\Redlands"
# create a spatial reference object to be used as output coordinate system
out_sr = arcpy.management.CreateSpatialReference("NAD 1983 StatePlane California V FIPS 0405 (US Feet)")
# use the output of CreateSpatialReference as input to Project tool
# to reproject the shapefile
arcpy.management.Project("citylimit_Project1.shp", "city_CA_FIPS0405", out_sr)
except arcpy.ExecuteError:
# print geoprocessing message
print(arcpy.GetMessages(2))
except Exception as ex:
# print the exception message
print(ex.args[0])