摘要
为街道方向属性提供读写访问,使您可自定义网络分析图层的方向输出。StreetDirectionsProperties 可通过 SolverProperties 对象读取和设置,后者则可通过 GetSolverProperties 函数获取。
讨论
StreetDirectionsProperties 对象可为街道方向属性提供读写访问,使您可自定义网络分析图层的方向输出。
可以读取和设置的属性包括 language、lengthUnits、styleName、timeAttribute、outputSpatialReference。
StreetDirectionsProperties 对象仅可用于“路径”、“最近设施点”和“车辆配送”网络分析图层。其他网络分析图层类型不支持输出方向。此外,在不支持方向的网络数据集上构建的网络分析图层上也不支持使用 StreetDirectionsProperties 对象。如果该图层不受支持,将返回一个 Python None 对象。
修改 StreetDirectionsProperties 对象的属性后,相应的图层可立即与其他函数和地理处理工具配合使用。无需刷新或更新图层,通过上述对象进行的修改便可生效。
属性
属性 | 说明 | 数据类型 |
language (读写) | 指定写入输出文本方向时所采用的语言。具体的可用语言取决于您机器上安装的语言,可使用 ListDirectionsLanguages 函数进行查看。 | String |
lengthUnits (读写) | 指定输出文本方向中用于测量长度的距离单位。这些单位必须是以下字符串值中的一个:
| String |
styleName (读写) | 指定输出文本方向的样式。对于打印、在导航设备上使用或查找步行路径等不同的应用,提供的样式也不同。具体的可用样式取决于您机器上安装的样式,可使用 ListDirectionsStyleNames 函数进行查看。 | String |
timeAttribute (读写) | 指定基于时间的网络数据集成本属性,从而支持计算输出方向上的行驶时间。可用的 timeAttribute 值是网络数据集的一个属性。您可使用网络数据集 describe 对象来在网络数据集中列出各个成本属性。 | String |
outputSpatialReference (读写) | 指示输出方向要素类的空间参考。此属性的输入必须是一个空间参考对象。 | SpatialReference |
代码实例
StreetDirectionsProperties 示例(工作流)
读取路径图层,将其长度单位设置为千米并生成方向要素。
import arcpy
try:
arcpy.CheckOutExtension("network")
#Get the route layer object from a layer named "Route" in
#the table of contents.
RouteLayer = arcpy.mapping.Layer(r'C:\Data\Route.lyr')
# Get the solver properties of the layer.
SolverProps = arcpy.na.GetSolverProperties(RouteLayer)
# Get the street directions properties
DirectionsProps = SolverProps.streetDirectionsProperties
# Set the lengthUnits to Kilometers
DirectionsProps.lengthUnits = "Kilometers"
# Set the outputSpatialReference to web mercator
sr = arcpy.SpatialReference(3785)
DirectionsProps.outputSpatialReference = sr
# Get the time attribute used for directions for use later
timeAttribute = DirectionsProps.timeAttribute
#Generate directions features and save them to disk.
arcpy.na.GenerateDirectionsFeatures(RouteLayer,
r'C:\Data\Directions.gdb\RouteDirections')
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)