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

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

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

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

Этот инструмент обычно используется как первый шаг в процессе сетевого анализа. После создания слоя вы можете добавить в него входные данные с помощью инструмента Добавить положения и выполнить анализ с помощью инструмента Расчет.

Более подробно о рабочих процессах слоя сетевого анализа
При использовании портала ArcGIS Online или ArcGIS Enterprise, сервисы маршрутизации которого настроены с использованием ArcGIS Online в качестве входного источника сетевых данных, при выполнении анализа будут потребляться кредиты и присутствовать определенные ограничения, такие как количество допустимых входных данных.

Подробнее о потреблении кредитов и ограничениях при выполнении сетевого анализа
По умолчанию данные нового слоя анализа будут созданы в новом, автоматически именуемом наборе классов объектов в среде геообработки Текущая рабочая область, которая обычно представляет собой базу геоданных проекта. Табличные данные будут созданы на корневом уровне той же базы геоданных, поскольку таблицы не могут храниться в наборе пространственных объектов. Вы можете переопределить это поведение с помощью параметров База геоданных анализа и Имя набора классов объектов анализа.
Хотя этот инструмент можно использовать в скриптах Python, рекомендуется для сетевого анализа в Python использовать классы механизма расчета из модуля arcpy.nax.

Более подробно о выполнении сетевого анализа в Python.

Подпись	Объяснение	Тип данных
Источник сетевых данных	Набор сетевых данных или сервис, для которого выполняется сетевой анализ. Параметр можно указать, используя следующее: Путь к каталогу набора сетевых данных. Слой набора сетевых данных URL-адрес для ArcGIS Online или портала ArcGIS Enterprise, настроенного со стандартными сервисами маршрутизации Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию. Более подробно о сетевом анализе с помощью сервисов маршрутизации При использовании портала ArcGIS Online или ArcGIS Enterprise, сервисы маршрутизации которого настроены с использованием ArcGIS Online в качестве входной сети, при выполнении анализа будут потребляться кредиты и присутствовать определенные ограничения, такие как количество допустимых входных данных. Подробнее о потреблении кредитов и ограничениях при выполнении сетевого анализа	Network Dataset Layer; String
Имя слоя (Дополнительный)	Имя слоя сетевого анализа, который будет создан.	String
Режим передвижения (Дополнительный)	Имя режима передвижения для выполнения анализа. Режим движения представляет собой набор сетевых настроек, например, ограничений передвижения и правил разворотов, определяющих, как пешеход, легковой или грузовой автомобиль или другое средство транспорта передвигается по сети. Режимы передвижения определяются вашим источником сетевых данных. Объект `arcpy.na.TravelMode` и строка, содержащая действительное представление JSON режима перемещения, также могут использоваться как ввод для этого параметра.	String
Направление движения (Дополнительный)	Указывает направление движения между пунктами обслуживания и инцидентами. Направление движения может повлиять на пункты обслуживания, найденные в случае, если сеть содержит односторонние улицы или импедансы, основанные на направлении движения. Например, поезда от места вызова до конкретного пункта обслуживания может занимать 10 минут, но проезд в обратном направлении – от пункта обслуживания до места вызова – займет 15 минут из-за наличия односторонних улиц или условий трафика. К пунктам обслуживания–Направление движения от инцидента к пункту обслуживания. Обычно этот параметр используют магазины розничной торговли, т.к. их интересует, насколько быстро покупатели (инциденты) смогут доехать до магазина (пункт обслуживания). Используется по умолчанию. От пунктов обслуживания–Направление движения от пункта обслуживания к инциденту. Пожарные части, как правило, используют эту настройку, поскольку их интересует, как быстро они смогут доехать от пожарной части к месту вызова.	String
Предельное значение (Дополнительный)	Импеданс, при котором механизм расчета прекратит поиск пунктов обслуживания для данного инцидента, в единицах атрибута импеданса, используемых для Режима передвижения. Это предельное значение может быть перезаписано на основе каждого инцидента путем задания отдельных предельных значений в подслое инцидентов, при установке параметра Направления движения - К пунктам обслуживания либо на основе каждого пункта обслуживания путем задания отдельных предельных значений в подслое пунктов, при установке параметра Направления движения - От пунктов обслуживания. По умолчанию для анализа предельное значение не используется.	Double
Число пунктов обслуживания для поиска (Дополнительный)	Число ближайших пунктов обслуживания, которые нужно найти для каждого инцидента. Это значение по умолчанию можно изменить, задав значение для свойства `TargetFacilityCount` в подслое инцидентов. Число пунктов обслуживания по умолчанию для поиска – один.	Long
Время суток (Дополнительный)	Время и дата начала или окончания маршрутов. Значение обозначает время начала или время окончания маршрута в зависимости от значения параметра Использование времени суток. Если выбран атрибут импеданса на основе трафика, то решение будет создано с учетом заданных динамических условий трафика в указанное время суток. Дату и время можно указать в виде 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 Узнать подробнее о том, как дата и время используется и интерпретируется в сетевом анализеs	Date
Часовой пояс (Дополнительный)	Часовой пояс параметра Время суток. Локальное время в местоположениях–Значение параметра Время суток относится к часовому поясу, в котором находятся пункты обслуживания или инциденты. Используется по умолчанию. Если для параметра Использование времени суток задано Время начала, а в качестве Направления движения – От пунктов обслуживания, то это будет часовой пояс пунктов обслуживания. Если для параметра Использование времени суток задано Время начала, а для Направления движения задано К пунктам обслуживания, то это будет часовой пояс инцидентов. Если для параметра Использование времени суток установлено Время окончания, а в качестве Направления движения – От пунктов обслуживания, то это будет часовой пояс инцидентов. Если для параметра Использование времени суток задано Время окончания, а в качестве Направления движения – К пунктам обслуживания, то это будет часовой пояс пунктов обслуживания. UTC–Значения параметра Время суток указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если хотите найти ближайшие пункты обслуживания для конкретного момента времени, например, текущего, но не знаете, в каком часовом поясе будут находиться пункты обслуживания или инциденты.	String
Использование времени дня (Дополнительный)	Указывает, является ли значение параметра Время суток временем отправления или временем прибытия для маршрутов или маршрута. Начальное время–Значение параметра Время суток интерпретируется как время отправления из пункта обслуживания или с места инцидента. Используется по умолчанию. Если выбрана эта опция, то параметр Время суток указывает на то, что метод расчета должен выбрать лучший маршрут с учетом времени отправления. Конечное время–Значения параметра Время суток интерпретируется как время прибытия в пункт обслуживания или на место инцидента. Эта опция полезна, если необходимо знать время отправления из местоположения, чтобы успеть в пункт назначения ко времени, заданному в параметре Время суток.	String
Линейная геометрия (Дополнительный)	Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа. Независимо от выбранного выходного типа формы, наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети. По сети–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. В состав результатов будут входить также измерения маршрута в системе линейных координат. Измерения увеличиваются с момента первой остановки и сохраняют накопительный импенданс для достижения заданного положения. Без линий–Для выходных маршрутов форма не создается. Прямые линии–Выходной формой маршрута будет прямая линия между остановками.	String
Атрибуты накопления (Дополнительный)	Список атрибутов стоимости, которые будут суммироваться во время анализа. Эти накопленные атрибуты могут использоваться только для сведения; алгоритм решения при выполнении анализа использует только атрибут стоимости в соответствии с используемым режимом передвижения. Для каждого накопленного атрибута стоимости в выходных объектах сетевого анализа заполняется свойство `Total_` [Impedance]. Этот параметр недоступен, если источником сетевых данных является сервис ArcGIS Online или сервис в версии Portal for ArcGIS, не поддерживающей накопление.	String
Построить путевой лист при расчете (Дополнительный)	Определяет, будут ли создаваться путевые листы в процессе анализа. Для анализа, в котором не требуется создавать пошаговый путевой лист, отключение опции создания путевого листа сократит время, необходимое для анализа. Отмечено–Во время расчета будут создаваться пошаговые направления. Не отмечено–Во время расчета не будут создаваться пошаговые направления. Используется по умолчанию.	Boolean
Игнорировать некорректные местоположения во время расчета (Дополнительный)	Указывает, будут ли игнорироваться неверные входные местоположения. Обычно местоположения недействительны, если они не могут быть обнаружены в сети. Когда недопустимые местоположения игнорируются, решатель пропустит их и попытается выполнить анализ, используя оставшиеся местоположения. Отмечено–Неверные входные местоположения будут игнорироваться, а использоваться будут только допустимые местоположения. Используется по умолчанию. Не отмечено–Будут использоваться все входные местоположения. Неверные местоположения приведут к сбою анализа.	Boolean
База геоданных анализа (Дополнительный)	Рабочая область базы геоданных, где будут храниться данные подслоя нового слоя сетевого анализа. Если этот параметр не указан, данные подслоя будут созданы в среде геообработки Текущей рабочей области, которая обычно является базой геоданных проекта. Узнайте больше об источнике данных анализа для слоя сетевого анализа	Workspace
Имя набора классов объектов анализа (Дополнительный)	Имя для нового набора классов объектов, который этот инструмент создаст в базе геоданных анализа для хранения данных подслоёв сетевого анализа. Если не указано, набор классов объектов будет создан с уникальным случайным именем. Узнайте больше об источнике данных анализа для слоя сетевого анализа	String

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

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

arcpy.na.MakeClosestFacilityAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {travel_direction}, {cutoff}, {number_of_facilities_to_find}, {time_of_day}, {time_zone}, {time_of_day_usage}, {line_shape}, {accumulate_attributes}, {generate_directions_on_solve}, {ignore_invalid_locations}, {analysis_geodatabase}, {analysis_feature_dataset_name})

Имя	Объяснение	Тип данных
network_data_source	Набор сетевых данных или сервис, для которого выполняется сетевой анализ. Параметр может быть задан с помощью одного из следующих: Путь к каталогу набора сетевых данных Объект слоя набора сетевых данных Строковое имя слоя набора сетевых данных URL-адрес для ArcGIS Online или портала ArcGIS Enterprise, настроенного со стандартными сервисами маршрутизации Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию. Более подробно о том, как можно войти на портал в Python Более подробно о сетевом анализе с помощью сервисов маршрутизации При использовании портала ArcGIS Online или ArcGIS Enterprise, сервисы маршрутизации которого настроены с использованием ArcGIS Online в качестве входной сети, при выполнении анализа будут потребляться кредиты и присутствовать определенные ограничения, такие как количество допустимых входных данных. Подробнее о потреблении кредитов и ограничениях при выполнении сетевого анализа	Network Dataset Layer; String
layer_name (Дополнительный)	Имя слоя сетевого анализа, который будет создан.	String
travel_mode (Дополнительный)	Имя режима передвижения для выполнения анализа. Режим движения представляет собой набор сетевых настроек, например, ограничений передвижения и правил разворотов, определяющих, как пешеход, легковой или грузовой автомобиль или другое средство транспорта передвигается по сети. Режимы передвижения определяются вашим источником сетевых данных. Объект `arcpy.na.TravelMode` и строка, содержащая действительное представление JSON режима перемещения, также могут использоваться как ввод для этого параметра.	String
travel_direction (Дополнительный)	Указывает направление движения между пунктами обслуживания и инцидентами. Направление движения может повлиять на пункты обслуживания, найденные в случае, если сеть содержит односторонние улицы или импедансы, основанные на направлении движения. Например, поезда от места вызова до конкретного пункта обслуживания может занимать 10 минут, но проезд в обратном направлении – от пункта обслуживания до места вызова – займет 15 минут из-за наличия односторонних улиц или условий трафика. `TO_FACILITIES`–Направление движения от инцидента к пункту обслуживания. Обычно этот параметр используют магазины розничной торговли, т.к. их интересует, насколько быстро покупатели (инциденты) смогут доехать до магазина (пункт обслуживания). Используется по умолчанию. `FROM_FACILITIES`–Направление движения от пункта обслуживания к инциденту. Пожарные части, как правило, используют эту настройку, поскольку их интересует, как быстро они смогут доехать от пожарной части к месту вызова.	String
cutoff (Дополнительный)	Импеданс, при котором механизм расчета прекратит поиск пунктов обслуживания для данного инцидента, в единицах атрибута импеданса, используемых для `travel_mode`. Это предельное значение может быть перезаписано на основе каждого инцидента путем задания отдельных предельных значений в подслое инцидентов, если параметр `travel_direction` установлен в значение `TO_FACILITIES`, либо на основе каждого пункта обслуживания путем задания отдельных предельных значений в подслое пунктов, если параметр `travel_direction` установлен в значение `FROM_FACILITIES`. По умолчанию для анализа предельное значение не используется.	Double
number_of_facilities_to_find (Дополнительный)	Число ближайших пунктов обслуживания, которые нужно найти для каждого инцидента. Это значение по умолчанию можно изменить, задав значение для свойства `TargetFacilityCount` в подслое инцидентов. Число пунктов обслуживания по умолчанию для поиска – один.	Long
time_of_day (Дополнительный)	Время и дата начала или окончания маршрутов. Интерпретация этого значения зависит от того, обозначает ли `time_of_day_usage` время начала или время окончания маршрута. Если выбран атрибут импеданса на основе трафика, то решение будет создано с учетом заданных динамических условий трафика в указанное время суток. Дату и время можно указать в виде 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 Узнать подробнее о том, как дата и время используется и интерпретируется в сетевом анализеs	Date
time_zone (Дополнительный)	Указывает часовой пояс параметра `time_of_day`. `LOCAL_TIME_AT_LOCATIONS`–Параметр `time_of_day` обращается к часовому поясу, в котором расположены пункты обслуживания или инциденты. Используется по умолчанию. Если `time_of_day_usage` установлен на `START_TIME`, а `travel_direction` – `FROM_FACILITIES`, то это будет часовой пояс пунктов обслуживания. Если `time_of_day_usage` установлен на `START_TIME`, а `travel_direction` - `TO_FACILITIES`, то это будет часовой пояс инцидентов. Если `time_of_day_usage` установлен на `END_TIME`, а `travel_direction` - `FROM_FACILITIES`, то это будет часовой пояс инцидентов. Если `time_of_day_usage` установлен на `END_TIME`, а `travel_direction` – `TO_FACILITIES`, то это будет часовой пояс пунктов обслуживания. `UTC`–Значения параметра `time_of_day` определяются в формате Всемирного координированного времени (UTC). Используйте эту опцию, если хотите найти ближайшие пункты обслуживания для конкретного момента времени, например, текущего, но не знаете, в каком часовом поясе будут находиться пункты обслуживания или инциденты.	String
time_of_day_usage (Дополнительный)	Определяет, на что указывает параметр `time_of_day` – на прибытие или на отправление для маршрутов или маршрута. `START_TIME`–Значение параметра `time_of_day` интерпретируется как время отправления из пункта обслуживания или с места инцидента. Используется по умолчанию. Если выбрана эта опция, то параметр `time_of_day` указывает на то, что метод расчета должен выбрать лучший маршрут с учетом времени отправления. `END_TIME`–Значения параметра `time_of_day` интерпретируется как время прибытия в пункт обслуживания или на место инцидента. Этот параметр можно использовать для того, чтобы узнать, в какое время необходимо выехать, чтобы прибыть в пункт назначения в момент времени, заданный параметром `time_of_day`.	String
line_shape (Дополнительный)	Определяет тип формы, который будет использоваться для объектов маршрута, получаемых в результате анализа. Независимо от выбранного выходного типа формы, наилучший маршрут всегда определяется по сетевому импедансу, а не по евклидовому расстоянию. Это значит, что различаются только формы маршрута, а не соответствующее им прохождение сети. `ALONG_NETWORK`–Полученные маршруты будут иметь точную форму лежащих ниже источников сети. В состав результатов будут входить также измерения маршрута в системе линейных координат. Измерения увеличиваются с момента первой остановки и сохраняют накопительный импенданс для достижения заданного положения. `NO_LINES`–Для выходных маршрутов форма не создается. `STRAIGHT_LINES`–Выходной формой маршрута будет прямая линия между остановками.	String
accumulate_attributes [accumulate_attributes,...] (Дополнительный)	Список атрибутов стоимости, которые будут суммироваться во время анализа. Эти накопленные атрибуты могут использоваться только для сведения; алгоритм решения при выполнении анализа использует только атрибут стоимости в соответствии с используемым режимом передвижения. Для каждого накопленного атрибута стоимости в выходных объектах сетевого анализа заполняется свойство `Total_` [Impedance]. Этот параметр недоступен, если источником сетевых данных является сервис ArcGIS Online или сервис в версии Portal for ArcGIS, не поддерживающей накопление.	String
generate_directions_on_solve (Дополнительный)	Определяет, будут ли создаваться путевые листы в процессе анализа. Для анализа, в котором не требуется создавать пошаговый путевой лист, отключение опции создания путевого листа сократит время, необходимое для анализа. `DIRECTIONS`–Во время расчета будут создаваться пошаговые направления. `NO_DIRECTIONS`–Во время расчета не будут создаваться пошаговые направления. Используется по умолчанию.	Boolean
ignore_invalid_locations (Дополнительный)	Указывает, будут ли игнорироваться неверные входные местоположения. Обычно местоположения недействительны, если они не могут быть обнаружены в сети. Когда недопустимые местоположения игнорируются, решатель пропустит их и попытается выполнить анализ, используя оставшиеся местоположения. `SKIP`–Неверные входные местоположения будут игнорироваться, а использоваться будут только допустимые местоположения. Используется по умолчанию. `HALT`–Будут использоваться все входные местоположения. Неверные местоположения приведут к сбою анализа.	Boolean
analysis_geodatabase (Дополнительный)	Рабочая область базы геоданных, где будут храниться данные подслоя нового слоя сетевого анализа. Если этот параметр не указан, данные подслоя будут созданы в среде геообработки Текущей рабочей области, которая обычно является базой геоданных проекта. Узнайте больше об источнике данных анализа для слоя сетевого анализа	Workspace
analysis_feature_dataset_name (Дополнительный)	Имя для нового набора классов объектов, который этот инструмент создаст в базе геоданных анализа для хранения данных подслоёв сетевого анализа. Если не указано, набор классов объектов будет создан с уникальным случайным именем. Узнайте больше об источнике данных анализа для слоя сетевого анализа	String

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

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

Пример кода

Подсказка:

Хотя этот инструмент можно использовать в скриптах Python, рекомендуется для сетевого анализа в Python использовать классы механизма расчета из модуля arcpy.nax. Более подробно о выполнении сетевого анализа в Python.

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

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

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

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

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

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityAnalysisLayer(network, "ClosestHospitals",
                                "Driving Time", "TO_FACILITIES", 5, 3,
                                "1/1/1900 9:00 AM", "UTC", "START_TIME",
                                "ALONG_NETWORK", ["Meters", "TravelTime"])

MakeClosestFacilityAnalysisLayer, пример 3 (автономный скрипт)

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

# Name: MakeClosestFacilityAnalysisLayer_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"
    travel_mode = "Driving Time"
    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.
    result_object = arcpy.na.MakeClosestFacilityAnalysisLayer(network,
                                    layer_name, travel_mode, "TO_FACILITIES",
                                    number_of_facilities_to_find=1)

    #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)

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

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

Параметры

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

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

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

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