StreetDirectionsProperties (arcpy.na)

Краткая информация

Обеспечивает доступ на чтение и запись к свойствам направлений, позволяя настраивать выходные данные из слоев сетевого анализа. 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 (чтение и запись)	Указывает пространственную привязку, которая будет применяться к выходному классу направлений. Входными даными для этого атрибута должен быть объект spatial reference.	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)