Создать слой ближайшего пункта обслуживания (Инструменты Network Analyst)

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

Создает слой ближайшего пункта обслуживания и задает свойства анализа. Слой ближайшего пункта обслуживания необходим для определения ближайшего к инциденту пункта обслуживания на основе заданных сетевых затрат.

Прежние версии:

Это устаревший инструмент. Эта функция была передана инструменту Создать слой анализа ближайшего пункта обслуживания.

Использование

После создания слоя анализа при помощи данного инструмента, вы можете добавлять в него объекты сетевого анализа при помощи инструмента Добавить положения, выполнять анализ при помощи инструмента Расчет и сохранять результаты на диске при помощи инструмента Сохранить в файл слоя.
При использовании данного инструмента в моделях геообработки, если модель запускается как инструмент, то выходной слой сетевого анализа должен быть задан в качестве параметра модели, в противном случае слой не добавится в содержание карты.

Подпись	Объяснение	Тип данных
Входная сеть анализа	Набор сетевых данных, для которого выполняется анализ ближайшего пункта обслуживания.	Network Dataset Layer
Имя выходного слоя	Имя создаваемого слоя ближайшего пункта обслуживания.	String
Атрибут импеданса	Стоимостный атрибут, который будет использован в качестве импеданса в анализе.	String
Перемещение от пункта обслуживания или к нему (Дополнительный)	Указывает направление движения между пунктами обслуживания и инцидентами. Этот параметр позволяет найти различные пункты обслуживания в сети с односторонними ограничениями и различными импедансами на основе направления движения. Например, объект может располагаться в 10 минутах езды по направлению от инцидента к пункту обслуживания, но в 15 минутах езды при движении от пункта обслуживания до инцидента из-за другого времени в пути в обратном направлении. От пунктов обслуживания к инцидентам–Направление движения от пункта обслуживания к инциденту. Пожарные части, как правило, используют этот параметр, поскольку их интересует, как быстро они смогут доехать от пожарной части (пункт обслуживания) к месту вызова (инцидент). От инцидентов к пунктам обслуживания–Направление движения от инцидента к пункту обслуживания. Обычно этот параметр используют магазины розничной торговли, т.к. их интересует, насколько быстро покупатели (инциденты) смогут доехать до магазина (пункт обслуживания).	String
Предельное значение по умолчанию (Дополнительный)	Значение импеданса по умолчанию, при котором следует прекратить поиск пунктов обслуживания для данного инцидента. Значение по умолчанию можно переопределить с помощью ограничения импеданса для инцидентов при поиске маршрутов от инцидентов к пунктам обслуживания или с помощью ограничения импеданса для пунктов обслуживания при поиске маршрутов от пунктов обслуживания к инцидентам.	Double
Число пунктов обслуживания для поиска (Дополнительный)	Количество ближайших пунктов обслуживания для инцидента, которые необходимо найти. Значение по умолчанию можно переопределить путем задания значения свойству TargetFacilityCount для инцидентов.	Long
Накопители (Дополнительный)	Список атрибутов стоимости, которые будут суммироваться во время анализа. Эти атрибуты суммирования предназначены только для справки: механизм расчета использует только атрибут стоимости, указанный параметром Атрибут импеданса, для вычисления маршрута. Для каждого суммируемого атрибута стоимости к маршрутам, являющимися выходными для механизма расчета, добавляется свойство [Impedance] `Total_`.	String
Правила разворотов (Дополнительный)	Определяет правила разворота, используемые в соединениях. При разрешении разворотов неявно предполагается, что механизм расчета позволяет поворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Чтобы приспособиться к этому, параметр правила разворота неявно определяется количеством ребер, которые участвуют в соединении, что известно как валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения. Для более точного определения правил разворота можно добавить глобальный параметр задержки на повороте в сетевой атрибут стоимости или настроить его, если он уже существует, а также уделить особое внимание конфигурации обратных поворотов. Можно также задать для сетевых положений свойство `CurbApproach`. Разрешено–Развороты разрешены в соединениях с любым количеством смежных ребер. Это значение используется по умолчанию. Не разрешено–Развороты запрещены во всех соединениях, вне зависимости от их валентности. Но даже при выборе этой опции развороты в сетевых положениях по-прежнему разрешены. Запретить развороты в отдельных сетевых положениях можно с помощью свойства положения `CurbApproach`. Разрешено только в тупиках–Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик). Разрешено только на пересечениях и в тупиках–Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.	String
Ограничения (Дополнительный)	Список атрибутов ограничений, которые будут применены во время анализа.	String
Использовать иерархию в анализе (Дополнительный)	Параметр не используется, если в наборе сетевых данных, используемом для выполнения анализа, не задан атрибут иерархии. Отмечено–Для анализа будет использоваться атрибут иерархии. Применение иерархии приводит при расчете к предпочтению ребер высшего порядка по сравнению с ребрами низшего порядка. Расчеты с иерархией выполняются быстрее, и они могут использоваться для моделирования предпочтений водителя, который скорее выберет для проезда автостраду, нежели местную дорогу – даже если это приведет к увеличению длины пути. Данная опция доступна, если входной набор сетевых данных имеет атрибут иерархии. Не отмечено–Атрибут иерархии не будет использован для анализа, результатом будет точный маршрут для набора сетевых данных.	Boolean
Настройки рангов иерархии (Дополнительный)	Прежние версии: До версии 10 данный параметр позволял изменять ранги иерархии для анализа, относительно рангов по умолчанию, установленных в наборе сетевых данных. В версии 10 данный параметр больше не поддерживается. Чтобы изменить ранги иерархии для анализа, обновите ранги иерархии по умолчанию в наборе сетевых данных.	Network Analyst Hierarchy Settings
Форма выходного пути (Дополнительный)	Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа. Независимо от выбранного выходного типа формы, наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети. Истинные линии с измерениями–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. В состав результатов будут входить также измерения маршрута в системе линейных координат. Измерения увеличиваются с момента первой остановки и сохраняют накопительный импенданс для достижения заданного положения. Истинные линии без измерений–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. Прямые линии–Выходной формой маршрута будет прямая линия, соединяющая каждую пару инцидента и пункта обслуживания. Без линий–Для выходных маршрутов форма не создается.	String
Время суток (Дополнительный)	Указывает время и дату начала или окончания маршрутов. Значение обозначает время начала или время окончания маршрута в зависимости от значения параметра Использование времени суток. Если выбран атрибут импеданса на основе трафика, то решение будет создано с учетом заданных динамических условий трафика в указанное время суток. Дату и время можно указать в виде 5/14/2012 10:30 AM. Вместо конкретной даты может быть задан день недели, при помощи следующих условных дат. Today—30.12.1899 Sunday—31.12.1899 Monday—01.01.1900 Tuesday—02.01.1900 Wednesday—03.01.1900 Thursday—04.01.1900 Friday—05.01.1900 Saturday—06.01.1900 Например, чтобы указать, что маршрут должен начинаться в 17:00 во вторник, следует указать значение параметра, равное 02.01.1900 17:00.	Date
Использование времени дня (Дополнительный)	Определяет, что указывает параметр Время суток – прибытие или отправление. Начальное время–Время суток интерпретируется как время отправления из пункта обслуживания или с места инцидента. Если выбрана эта опция, то параметр Время суток указывает на то, что метод расчета должен выбрать лучший маршрут с учетом времени отправления. Конечное время–Время суток интерпретируется как время прибытия в пункт обслуживания или на место инцидента. Этот параметр можно использовать для того, чтобы узнать, в какое время необходимо выехать, чтобы прибыть в пункт назначения в момент времени, заданный параметром Время дня. Неиспользованные–Если для параметра Время дня не указано значение, то будет доступна только эта опция. Если для параметра Время дня было указано значение, то эта опция будет недоступна.	String

Производные выходные данные

Подпись	Объяснение	Тип данных
Слой Network Analyst	Только что созданный слой сетевого анализа.	Network Analyst Layer

arcpy.na.MakeClosestFacilityLayer(in_network_dataset, out_network_analysis_layer, impedance_attribute, {travel_from_to}, {default_cutoff}, {default_number_facilities_to_find}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {hierarchy}, {hierarchy_settings}, {output_path_shape}, {time_of_day}, {time_of_day_usage})

Имя	Объяснение	Тип данных
in_network_dataset	Набор сетевых данных, для которого выполняется анализ ближайшего пункта обслуживания.	Network Dataset Layer
out_network_analysis_layer	Имя создаваемого слоя ближайшего пункта обслуживания.	String
impedance_attribute	Стоимостный атрибут, который будет использован в качестве импеданса в анализе.	String
travel_from_to (Дополнительный)	Указывает направление движения между пунктами обслуживания и инцидентами. Этот параметр позволяет найти различные пункты обслуживания в сети с односторонними ограничениями и различными импедансами на основе направления движения. Например, объект может располагаться в 10 минутах езды по направлению от инцидента к пункту обслуживания, но в 15 минутах езды при движении от пункта обслуживания до инцидента из-за другого времени в пути в обратном направлении. `TRAVEL_FROM`–Направление движения от пункта обслуживания к инциденту. Пожарные части, как правило, используют этот параметр, поскольку их интересует, как быстро они смогут доехать от пожарной части (пункт обслуживания) к месту вызова (инцидент). `TRAVEL_TO`–Направление движения от инцидента к пункту обслуживания. Обычно этот параметр используют магазины розничной торговли, т.к. их интересует, насколько быстро покупатели (инциденты) смогут доехать до магазина (пункт обслуживания).	String
default_cutoff (Дополнительный)	Значение импеданса по умолчанию, при котором следует прекратить поиск пунктов обслуживания для данного инцидента. Значение по умолчанию можно переопределить с помощью ограничения импеданса для инцидентов при поиске маршрутов от инцидентов к пунктам обслуживания или с помощью ограничения импеданса для пунктов обслуживания при поиске маршрутов от пунктов обслуживания к инцидентам.	Double
default_number_facilities_to_find (Дополнительный)	Количество ближайших пунктов обслуживания для инцидента, которые необходимо найти. Значение по умолчанию можно переопределить путем задания значения свойству TargetFacilityCount для инцидентов.	Long
accumulate_attribute_name [accumulate_attribute_name,...] (Дополнительный)	Список атрибутов стоимости, которые будут суммироваться во время анализа. Эти атрибуты суммирования предназначены только для справки: механизм расчета использует только атрибут стоимости, указанный параметром Атрибут импеданса, для вычисления маршрута. Для каждого суммируемого атрибута стоимости к маршрутам, являющимися выходными для механизма расчета, добавляется свойство [Impedance] `Total_`.	String
UTurn_policy (Дополнительный)	Определяет правила разворота, используемые в соединениях. При разрешении разворотов неявно предполагается, что механизм расчета позволяет поворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Чтобы приспособиться к этому, параметр правила разворота неявно определяется количеством ребер, которые участвуют в соединении, что известно как валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения. Для более точного определения правил разворота можно добавить глобальный параметр задержки на повороте в сетевой атрибут стоимости или настроить его, если он уже существует, а также уделить особое внимание конфигурации обратных поворотов. Можно также задать для сетевых положений свойство `CurbApproach`. `ALLOW_UTURNS`–Развороты разрешены в соединениях с любым количеством смежных ребер. Это значение используется по умолчанию. `NO_UTURNS`–Развороты запрещены во всех соединениях, вне зависимости от их валентности. Но даже при выборе этой опции развороты в сетевых положениях по-прежнему разрешены. Запретить развороты в отдельных сетевых положениях можно с помощью свойства положения `CurbApproach`. `ALLOW_DEAD_ENDS_ONLY`–Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик). `ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY`–Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.	String
restriction_attribute_name [restriction_attribute_name,...] (Дополнительный)	Список атрибутов ограничений, которые будут применены во время анализа.	String
hierarchy (Дополнительный)	Параметр не используется, если в наборе сетевых данных, используемом для выполнения анализа, не задан атрибут иерархии. `USE_HIERARCHY`–Для анализа будет использоваться атрибут иерархии. Применение иерархии приводит при расчете к предпочтению ребер высшего порядка по сравнению с ребрами низшего порядка. Расчеты с иерархией выполняются быстрее, и они могут использоваться для моделирования предпочтений водителя, который скорее выберет для проезда автостраду, нежели местную дорогу – даже если это приведет к увеличению длины пути. Данная опция доступна, если входной набор сетевых данных имеет атрибут иерархии. `NO_HIERARCHY`–Атрибут иерархии не будет использован для анализа, результатом будет точный маршрут для набора сетевых данных.	Boolean
hierarchy_settings (Дополнительный)	Прежние версии: До версии 10 данный параметр позволял изменять ранги иерархии для анализа, относительно рангов по умолчанию, установленных в наборе сетевых данных. В версии 10 данный параметр больше не поддерживается и должен быть указан в виде пустой строки. Чтобы изменить ранги иерархии для анализа, обновите ранги иерархии по умолчанию в наборе сетевых данных.	Network Analyst Hierarchy Settings
output_path_shape (Дополнительный)	Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа. Независимо от выбранного выходного типа формы, наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети. `TRUE_LINES_WITH_MEASURES`–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. В состав результатов будут входить также измерения маршрута в системе линейных координат. Измерения увеличиваются с момента первой остановки и сохраняют накопительный импенданс для достижения заданного положения. `TRUE_LINES_WITHOUT_MEASURES`–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. `STRAIGHT_LINES`–Выходной формой маршрута будет прямая линия, соединяющая каждую пару инцидента и пункта обслуживания. `NO_LINES`–Для выходных маршрутов форма не создается.	String
time_of_day (Дополнительный)	Указывает время и дату начала или окончания маршрутов. Значение обозначает время начала или время окончания маршрута в зависимости от значения параметра Использование времени суток. Если выбран атрибут импеданса на основе трафика, то решение будет создано с учетом заданных динамических условий трафика в указанное время суток. Дату и время можно указать в виде 5/14/2012 10:30 AM. Вместо конкретной даты может быть задан день недели, при помощи следующих условных дат. Today—30.12.1899 Sunday—31.12.1899 Monday—01.01.1900 Tuesday—02.01.1900 Wednesday—03.01.1900 Thursday—04.01.1900 Friday—05.01.1900 Saturday—06.01.1900 Например, чтобы указать, что маршрут должен начинаться в 17:00 во вторник, следует указать значение параметра, равное 02.01.1900 17:00.	Date
time_of_day_usage (Дополнительный)	Определяет, что указывает параметр Время суток – прибытие или отправление. `START_TIME`–Время суток интерпретируется как время отправления из пункта обслуживания или с места инцидента. Если выбрана эта опция, то параметр Время суток указывает на то, что метод расчета должен выбрать лучший маршрут с учетом времени отправления. `END_TIME`–Время суток интерпретируется как время прибытия в пункт обслуживания или на место инцидента. Этот параметр можно использовать для того, чтобы узнать, в какое время необходимо выехать, чтобы прибыть в пункт назначения в момент времени, заданный параметром Время дня. `NOT_USED`–Если для параметра Время дня не указано значение, то будет доступна только эта опция. Если для параметра Время дня было указано значение, то эта опция будет недоступна.	String

Производные выходные данные

Имя	Объяснение	Тип данных
output_layer	Только что созданный слой сетевого анализа.	Network Analyst Layer

Пример кода

MakeClosestFacilityLayer, пример 1 (окно Python)

Выполнить инструмент с использованием только обязательных параметров.

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityLayer(network, "ClosestFireStations", "TravelTime")

MakeClosestFacilityLayer, пример 2 (окно Python)

Выполните инструмент с использованием всех параметров.

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityLayer(network, "ClosestHospitals", "TravelTime",
                                    "TRAVEL_TO", 5 ,3, ["Meters", "TravelTime"],
                                    "ALLOW_UTURNS", ["Oneway"], "USE_HIERARCHY",
                                    "", "TRUE_LINES_WITH_MEASURES")

MakeClosestFacilityLayer, пример 3 (рабочий процесс)

В следующем автономном скрипте Python показано, как с помощью функции MakeClosestFacilityLayer можно выполнять поиск ближайшего склада относительно местоположений магазинов.

# Name: MakeClosestFacilityLayer_Workflow.py
# Description: Find the closest warehouse from the store locations and save the
#              results to a layer file on disk.
# Requirements: Network Analyst extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/Paris.gdb"
    network = os.path.join(input_gdb, "Transportation", "ParisMultimodal_ND")
    layer_name = "ClosestWarehouse"
    impedance = "DriveTime"
    accumulate_attributes = ["Meters"]
    facilities = os.path.join(input_gdb, "Analysis", "Warehouses")
    incidents = os.path.join(input_gdb, "Analysis", "Stores")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new closest facility analysis layer. Apart from finding the drive
    #time to the closest warehouse, we also want to find the total distance, so
    #we will accumulate the "Meters" impedance attribute.
    result_object = arcpy.na.MakeClosestFacilityLayer(network, layer_name,
                                                   impedance, "TRAVEL_TO",
                                                   "", 1, accumulate_attributes,
                                                   "NO_UTURNS")

    #Get the layer object from the result object. The closest facility layer can
    #now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the closest facility layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    incidents_layer_name = sublayer_names["Incidents"]

    #Load the warehouses as Facilities using the default field mappings and
    #search tolerance
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            facilities, "", "")

    #Load the stores as Incidents. Map the Name property from the NOM field
    #using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    incidents_layer_name)
    field_mappings["Name"].mappedFieldName = "NOM"
    arcpy.na.AddLocations(layer_object, incidents_layer_name, incidents,
                          field_mappings, "")

    #Solve the closest facility layer
    arcpy.na.Solve(layer_object)

    #Save the solved closest facility layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    print("Script completed successfully")

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 occurred on line %i" % tb.tb_lineno)
    print(str(e))

Параметры среды

Текущая рабочая область

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да

Создать слой ближайшего пункта обслуживания (Инструменты Network Analyst)

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

Прежние версии:

Использование

Параметры

Прежние версии:

Производные выходные данные

Параметры среды

Информация о лицензировании

Связанные разделы