ArcMap

Найти ближайшие пункты обслуживания

Сводка

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

При поиске ближайших пунктов обслуживания можно указать, сколько пунктов необходимо найти, и в каком направлении нужно передвигаться – к ним или от них. Если набор сетевых данных содержит сведения о трафике, можно также указать Время дня, чтобы при вычислении времени езды учесть условия дорожного движения в конкретный час и день. Например, вы можете использовать этот инструмент для поиска больниц в пределах 15 минут езды от места происшествия в данное Время дня. Больницы, находящиеся более чем в 15 минутах езды с учетом условий дорожного движения, не будут включены в результаты поиска.

Более подробно о выходных данных инструмента Найти ближайшие пункты обслуживания

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

  • В диалоговом окне инструмента есть разнообразные дополнительные параметры, сгруппированные для удобства работы в следующие шесть категорий:

    • Расширенный анализ
    • Барьеры
    • Пользовательский режим передвижения
    • Набор сетевых данных
    • Сетевые положения
    • Выходные данные
    • Возможности сервиса

Синтаксис

arcpy.na.FindClosestFacilities(Incidents, Facilities, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Directions_Name, Output_Closest_Facilities_Name, {Number_of_Facilities_to_Find}, {Default_Cutoff}, {Travel_Direction}, {Time_of_Day}, {Time_of_Day_Usage}, {Time_Zone_for_Time_of_Day}, {UTurn_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Facilities}, {Maximum_Facilities_to_Find}, {Maximum_Incidents}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode}, {Overrides}, {Save_Route_Data})
ПараметрОбъяснениеТип данных
Incidents

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

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

OBJECTID – Управляемое системой поле ID.

SHAPE – Поле геометрии, указывающее географическое местоположение инцидента.

Name - Имя инцидента. Имя используется в путевом листе. Если имя не указано, в выходных маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location.

ID – Уникальный идентификатор инцидента. Идентификатор включается в выходные маршруты (как поле IncidentID) и помогает присоединить дополнительную информацию из выходных маршрутов, такую как общее время езды или общее расстояние, к атрибутам из ваших инцидентов и наоборот. Если ID не указан, сервис автоматически создает уникальный идентификатор для каждого инцидента.

AdditionalTime – Время, затраченное на месте инцидента, которое добавляется к общему времени маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0.

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

AdditionalDistance – Дополнительное расстояние, пройденное машинами на месте инцидента, которое добавляется к общей протяженности маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0.

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

CurbApproach – Указывает направление, в котором транспортное средство может подъехать или отъехать от инцидента. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):

  • 0 (Любая сторона транспортного средства) – Транспортное средство может подъезжать и отъезжать от инцидента в любом направлении, поэтому в месте инцидента разрешен разворот. Данный параметр можно выбрать, если для транспортного средства возможно и желательно развернуться в месте инцидента. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия на месте инцидента стоянки, где транспортное средство может выполнить разворот.
  • 1 ( Правая сторона транспортного средства) – Когда транспортное средство подъезжает или отъезжает от инцидента, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа.
  • 2 (Левая сторона транспортного средства) – Когда транспортное средство подъезжает и отъезжает от инцидента, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева.
  • 3 (Без разворота) – При подъезде транспортного средства к инциденту бордюр может располагаться с любой стороны транспортного средства. Но при отправлении транспортное средство не должно выполнять разворот.

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда инцидент находится с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к инциденту, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к инциденту так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Feature Set
Facilities

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

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

Name – имя пункта обслуживания. Имя используется в путевом листе. Если имя не указано, в выходных маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location.

ID – уникальный идентификатор пункта обслуживания. Идентификатор включается в выходные данные маршрутов (как поле FacilityID) и выходные ближайших пунктов обслуживания, как поля FacilityID. Поле FacilityID можно использовать для присоединения дополнительной информации из выходных маршрутов, такой как общее время езды или общее расстояние, к атрибутам из ваших пунктов обслуживания. Если ID не указан, сервис автоматически создает уникальный идентификатор для каждого инцидента.

AdditionalTime – Время, затраченное на месте инцидента, которое добавляется к общему времени маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0.

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

AdditionalDistance – Дополнительное расстояние, пройденное машинами на месте пункта обслуживания, которое добавляется к общей протяженности маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0.

Как правило, такие объекты, как пожарная часть, находятся не совсем на улице, а несколько в стороне от дороги. AdditionalDistance может моделировать расстояние между фактическим местоположением объекта и его расположением на улице, если важно включить это расстояние в общую протяженность пути.

CurbApproach – Указывает направление, в котором транспортное средство может подъехать и отъехать от пункта обслуживания. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):

  • 0 (Любая сторона транспортного средства) – транспортное средство может подъезжать и отъезжать от пункта обслуживания в любом направлении, поэтому в пункте обслуживания разрешен разворот. Данный параметр можно выбрать, если для транспортного средства возможно и желательно развернуться в пункте обслуживания. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в пункте обслуживания места для стоянки, где транспортное средство может выполнить разворот.
  • 1 ( Правая сторона транспортного средства) – когда транспортное средство подъезжает или отъезжает от пункта обслуживания, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа.
  • 2 (Левая сторона транспортного средства) – когда транспортное средство подъезжает и отъезжает от пункта обслуживания, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева.
  • 3 (Без разворота) – при подъезде транспортного средства к пункту обслуживания бордюр может располагаться с любой стороны транспортного средства. Но при отправлении транспортное средство не должно выполнять разворот.

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда пункт обслуживания располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к пункту обслуживания, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к пункту обслуживания так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Feature Set
Measurement_Units

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

Единицы, выбранные для этого параметра, определяют, будет ли инструмент измерять протяженность или продолжительность пути для нахождения ближайшего пункта обслуживания. Выберите единицу времени для измерения продолжительности пути. Для измерения протяженности пути выберите единицу расстояния. Выбранные вами единицы инструмент будет использовать также для указания общей продолжительности или протяженности пути в результатах. Можно выбрать следующие варианты:

  • Meters
  • Kilometers
  • Feet
  • Yards
  • Miles
  • NauticalMiles
  • Seconds
  • Minutes
  • Hours
  • Days

Инструмент использует сетевой атрибут стоимости, заданный параметром Атрибут времени или параметром Атрибут расстояния, в зависимости от того, какие единицы измерения выбраны: времени или расстояния.

Инструмент выполняет необходимые преобразования единиц в том случае, если значение параметра Единицы измерения отличается от единиц соответствующего атрибута стоимости времени или расстояния.

String
Network_Dataset

Набор сетевых данных, который будет анализироваться. Наборы сетевых данных чаще всего представляют улично-дорожные сети, но могут представлять и другие типы транспортных сетей. Набор сетевых данных должен содержать хотя бы один атрибут стоимости, основанный на времени, и один, основанный на расстоянии.

Network Dataset Layer
Output_Geodatabase

Выходная рабочая область. Рабочая область должна существовать. Выходная рабочая область по умолчанию – in_memory.

Workspace
Output_Routes_Name

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

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

String
Output_Directions_Name

Имя выходного класса пространственных объектов, содержащего путевой лист.

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

String
Output_Closest_Facilities_Name

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

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

String
Number_of_Facilities_to_Find
(Дополнительный)

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

Если вы создаете с помощью этого инструмента сервис и хотите ограничить использование ресурсов сервера, например, время обработки, используйте параметр Максимальное число выходных пунктов обслуживания для ограничения максимального числа пунктов обслуживания, которое пользователь может указать в поле Число выходных пунктов обслуживания. .

Long
Default_Cutoff
(Дополнительный)

Укажите продолжительность или протяженность пути, при которых следует прекратить поиск пунктов обслуживания для данного инцидента. Например, при нахождении ближайших к месту происшествия больниц, значение отсечки 15 минут означает, что инструмент выполнит поиск ближайшей больницы в пределах 15 минутах езды от инцидента. Если ближайшая больница находится в 17 минутах езды, поиск ближайшего пункта обслуживания не даст никаких результатов. Предельное значение особенно полезно для поиска нескольких пунктов обслуживания.

Единицы измерения этого свойства задаются параметром Единицы измерения.

Double
Travel_Direction
(Дополнительный)

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

  • TRAVEL_FROM —Направление движения от пункта обслуживания к инциденту. Пожарные части, как правило, используют этот параметр, поскольку их интересует, как быстро они смогут доехать от пожарной части (пункт обслуживания) к месту вызова (инцидент).
  • TRAVEL_TO —Направление движения от инцидента к пункту обслуживания. Обычно этот параметр используют магазины розничной торговли, так как их интересует, насколько быстро покупатели (инциденты) смогут доехать до магазина (пункт обслуживания).

В зависимости от того, какое значение параметра используется, найденные пункты обслуживания могут различаться, поскольку время езды по некоторым улицам может зависеть от направления движения и односторонних ограничений. Например, объект может располагаться в 10 минутах езды по направлению от инцидента к пункту обслуживания, но в 15 минутах езды при движении от пункта обслуживания до инцидента из-за другого времени в пути в обратном направлении. Если вы указываете значение для Времени суток, опции От пункта обслуживания к инциденту и От инцидента к пункту обслуживания также могут дать различные результаты из-за разницы в условиях дорожного движения.

String
Time_of_Day
(Дополнительный)

Указывает время и дату начала или окончания маршрутов. Значение обозначает время начала или время окончания маршрута в зависимости от значения параметра Использование времени суток. Если вы указываете в качестве значения этого параметра текущие дату и время, инструмент будет использовать при нахождении ближайших пунктов обслуживания текущие условия дорожного движения, и общее время пути будет учитывать условия дорожного движения.

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

Параметр Часовой пояс для времени суток определяет, как будут указываться время и дата, в UTC или в часовом поясе, в котором находятся пункт обслуживания или инцидент.

Независимо от значения параметра Часовой пояс для времени суток, в случае если ваши пункты обслуживания и инциденты находятся в нескольких часовых поясах, инструмент использует следующие правила:

  • Все инциденты должны быть в одном и том же часовом поясе для выполнения следующего:

    • при указании начального времени и перемещении от места инцидента к пункту обслуживания;
    • при указании конечного времени и перемещении от пункта обслуживания к месту инцидента.

  • Все пункты обслуживания должны быть в одном и том же часовом поясе для выполнения следующего:

    • при указании начального времени и перемещении от пункта обслуживания к месту инцидента;
    • при указании конечного времени и перемещении от места инцидента к пункту обслуживания.

Date
Time_of_Day_Usage
(Дополнительный)

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

  • START_TIME — Когда выбрана эта опция, инструмент находит лучший маршрут, принимая значение параметра Время дня в качестве времени отправления из пункта обслуживания или с места инцидента.
  • END_TIME — Когда выбрана эта опция, инструмент принимает значение параметра Время дня в качестве времени прибытия в пункт обслуживания или на место инцидента. Эта опция полезна, если необходимо знать время отправления из местоположения, чтобы успеть в пункт назначения ко времени, заданному в параметре Время дня.
  • NOT_USED —Когда выбрана эта опция, инструмент не использует параметр Время дня для нахождения ближайших пунктов обслуживания. Текущие и исторические данные трафика не будут использоваться.
String
Time_Zone_for_Time_of_Day
(Дополнительный)

Указывает часовой пояс параметра Время дня.

  • GEO_LOCAL —Параметр Time_of_Day обращается к часовому поясу, в котором расположены пункты обслуживания или инциденты.
    • Если Time_of_Day_Usage задан как START_TIME, а Travel_Direction – как TRAVEL_FROM, то это будет часовой пояс пунктов обслуживания.
    • ЕслиTime_of_Day_Usage задан как START_TIME, а Travel_Direction – как TRAVEL_TO, то это будет часовой пояс инцидентов.
    • ЕслиTime_of_Day_Usage задан как END_TIME, а Travel_Direction – как TRAVEL_FROM, то это будет часовой пояс инцидентов.
    • Если Time_of_Day_Usage задан как END_TIME, а Travel_Direction – как TRAVEL_TO, то это будет часовой пояс пунктов обслуживания.
  • UTC —Значения параметра Time_of_Day определяются в формате Всемирного координированного времени (UTC). Используйте эту опцию, если хотите найти ближайшие пункты обслуживания для конкретного момента времени, например, текущего, но не знаете, в каком часовом поясе будут находиться пункты обслуживания или инциденты.

Независимо от значения параметра Часовой пояс для времени суток, в случае если ваши пункты обслуживания и инциденты находятся в нескольких часовых поясах, инструмент использует следующие правила:

  • Все инциденты должны быть в одном и том же часовом поясе для выполнения следующего:

    • при указании начального времени и перемещении от места инцидента к пункту обслуживания;
    • при указании конечного времени и перемещении от пункта обслуживания к месту инцидента.

  • Все пункты обслуживания должны быть в одном и том же часовом поясе для выполнения следующего:

    • при указании начального времени и перемещении от пункта обслуживания к месту инцидента;
    • при указании конечного времени и перемещении от места инцидента к пункту обслуживания.

String
UTurn_Policy
(Дополнительный)

Правила разворота на соединениях. При разрешении U-образных разворотов неявно предполагается, что механизм расчета позволяет разворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Для соответствия, параметр правил разворотов в неявном виде указывает количество ребер, участвующих в соединении, что представляет собой валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения.

  • ALLOW_UTURNS —Развороты разрешены в соединениях с любым количеством смежных ребер. Это значение используется по умолчанию.
  • NO_UTURNS —Развороты запрещены во всех соединениях, вне зависимости от их валентности. Обратите внимание, что, даже при выборе этой опции развороты в сетевых положениях по-прежнему разрешены. Запретить развороты в отдельных сетевых положениях можно с помощью свойства местоположения CurbApproach.
  • ALLOW_DEAD_ENDS_ONLY —Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский..

String
Point_Barriers
(Дополнительный)

Определяет точечные барьеры, которые разделены на два типа: ограничения и дополнительной стоимости. Они временно ограничивают прохождение по сети или добавляют импеданс к точкам сети. Точечные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для точечных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов с описанием.

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

BarrierType:

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

  • Ограничение (0) – запрещает перемещение через барьер. Это значение используется по умолчанию.
  • Дополнительная стоимость (2) – Прохождение через барьер увеличивает сетевую стоимость на значение, указанное в полях Additional_Time и Additional_Distance.

Используйте значение 0 для Ограничения и 2 для Дополнительной стоимости.

Additional_Time:

указывает, какое время поездки добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения времени. Значение этого поля должно быть больше или равно нулю, а его единицы измерения должны быть такими же, как в параметре Единицы измерения.

Additional_Distance:

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

Feature Set
Line_Barriers
(Дополнительный)

Определяет линейные барьеры, которые временно ограничивают прохождение через них. Линейные барьеры определяются набором объектов. Ниже приведены поля в таблице атрибутов с описанием.

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

Feature Set
Polygon_Barriers
(Дополнительный)

Определяет полигональные барьеры, которые разделены на два типа: ограничения и полигональные барьеры масштабированной стоимости. Они временно ограничивают перемещение или масштабируют импеданс в покрываемых ими частях сети. Полигональные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для полигональных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов с описанием.

ObjectID:

Управляемое системой поле ID.

Shape:

Поле геометрии, показывающее географическое положение объекта сетевого анализа.

Name:

Имя барьера.

BarrierType:

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

  • Ограничение (0) – запрещает прохождение через любую часть барьера. Это значение используется по умолчанию.
  • Масштабированная стоимость (1) – Масштабирует импеданс исходных ребер, умножая его на значение свойства ScaledCostFactor. Если ребра частично перекрыты барьером, будет умножаться пропорциональная доля импеданса.

Используйте значение 0 для Ограничения и 1 для Масштабированной стоимости.

ScaledTimeFactor:

Это коэффициент, на который умножается время поездки по улицам, пересекающимся с барьером. Это поле действительно только для барьеров с масштабированной стоимостью, и только если используются единицы измерения времени. Значение поля должно быть больше нуля.

ScaledDistanceFactor:

Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Этот атрибут действителен только для барьеров с масштабированной стоимостью, и только если используются единицы измерения расстояния. Значение атрибута должно быть больше нуля.

Feature Set
Time_Attribute
(Дополнительный)

Определяет, какой сетевой атрибут стоимости используется, когда в качестве единиц измерения выбраны единицы времени.

Инструмент выполняет необходимые преобразования единиц времени в том случае, если значение параметра Единицы измерения отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы времени параметра отсечки по умолчанию и сетевого атрибута стоимости не обязательно должны быть одинаковыми.

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский.

String
Time_Attribute_Units
(Дополнительный)

Единицы атрибута времени. Вы можете явно задать единицы атрибута времени, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы.

Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM.

String
Distance_Attribute
(Дополнительный)

Определяет, какой сетевой атрибут стоимости используется, когда значением параметра Единицы измерения является единица расстояния.

Инструмент выполняет необходимые преобразования единиц расстояния в том случае, если значение параметра Единицы измерения отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы измерения и единицы расстояния сетевого атрибута стоимости не обязательно должны быть одинаковыми.

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский.

String
Distance_Attribute_Units
(Дополнительный)

Единицы атрибута расстояния. Вы можете явно задать единицы атрибута расстояния, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы.

Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM.

String
Use_Hierarchy_in_Analysis
(Дополнительный)

Укажите, должна ли использоваться иерархия при нахождении кратчайшего маршрута между точками.

  • USE_HIERARCHY — Использовать иерархию при нахождении маршрутов. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка (такие как скоростные автострады) улицам более низкого порядка (таким как местные дороги) и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным пунктам обслуживания, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае междугородних поездок, поскольку инструмент выбирает лучший маршрут из сравнительно небольшого поднабора улиц.
  • NO_HIERARCHY — Не использовать иерархию при нахождении маршрутов. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города.

Параметр не используется, если в наборе сетевых данных, используемом для выполнения анализа, не задан атрибут иерархии. В таких случаях используйте в качестве значения параметра "#".

Можно использовать параметр Force_Hierarchy_Beyond_Distance , чтобы механизм расчета принудительно применял иерархию, даже если параметр Use_Hierarchy_in_Analysis задан как False.

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

Boolean
Restrictions
[restriction,...]
(Дополнительный)

Определяет, какие сетевые атрибуты ограничения будут учитываться во время расчета.

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский.

String
Attribute_Parameter_Values
(Дополнительный)

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский..

Набор записей значений параметра атрибута имеет связанные атрибуты. Ниже приведены поля в таблице атрибутов с описанием.

ObjectID:

Управляемое системой поле ID.

AttributeName:

Имя сетевого атрибута, чей параметр атрибута задан строкой таблицы.

ParameterName:

Имя параметра атрибута, чье значение задано строкой таблицы. (Параметры типа объекта не могут быть обновлены с помощью данного инструмента.)

ParameterValue:

Значение, которое вы хотите задать для параметра атрибута. Если значение не указано, для параметра атрибута устанавливается значение NULL.

Record Set
Accumulate_Attributes
[attribute,...]
(Дополнительный)

Список атрибутов стоимости, который будет суммироваться во время анализа. Эти атрибуты накопления служат исключительно для справки; механизм расчета использует только атрибут стоимости, определенный параметром Атрибут времени (Time_Attribute в Python) или Атрибут расстояния (Distance_Attribute в Python), для вычисления кратчайшего пути.

Для каждого кумулятивного атрибута стоимости к выходным маршрутам механизма расчета добавляется свойство Total_[attribute].

String
Maximum_Snap_Tolerance
(Дополнительный)

Максимальный допуск замыкания представляет собой самое дальнее расстояние, которое Network Analyst находится при размещении или повторном размещении точки в сети. Выполняется поиск подходящих ребер или соединений, далее выполняется замыкание точки на ближайший объект. Если подходящее положение не было найдено в пределах максимального допуска замыкания, то объект обозначается, как неразмещенный.

Linear Unit
Feature_Locator_WHERE_Clause
(Дополнительный)

Выражение SQL, используемое для создания поднабора исходных пространственных объектов, определяющего элементы сети, на которых могут быть расположены пункты обслуживания. Синтаксис данного параметра состоит их двух частей: первая – имя источника класса пространственных объектов (после которого имеется пробел), вторая – выражение SQL. Чтобы записать выражение SQL для двух или более классов пространственных объектов, их необходимо разделить точкой с запятой.

Чтобы пункты обслуживания не располагались на шоссе с ограниченным доступом, например, напишите выражение SQL, аналогичное следующему, с целью исключить такие источники объектов: "Streets" "FUNC_CLASS not in('1', '2')".

Обратите внимание, что барьеры игнорируют Условие Where локатора объектов во время загрузки.

String
Route_Shape
(Дополнительный)

Укажите тип объектов маршрута, получаемых на выходе инструмента. Параметр может быть задан с помощью одного из следующих значений:

  • TRUE_LINES_WITH_MEASURES — Возвратить точную геометрию выходного маршрута на основе исходных улиц. Кроме того, создать измерения, чтобы геометрию можно было использовать для линейной привязки.
  • TRUE_LINES_WITHOUT_MEASURES — Возвратить точную геометрию выходного маршрута на основе исходных улиц.
  • STRAIGHT_LINES — Возвратить прямую линию между инцидентом и пунктом обслуживания.
  • NO_LINES — Не возвращать геометрию маршрутов. Это значение можно использовать в тех случаях, когда нужно определить только общую продолжительность или протяженность пути между ближайшим пунктом обслуживания и инцидентом.

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

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

String
Route_Line_Simplification_Tolerance
(Дополнительный)

Определяет степень упрощения геометрии маршрута.

Инструмент игнорирует этот параметр, если для параметра Route_Shape не было указано TRUE_LINES_WITH_MEASURES или TRUE_LINES_WITHOUT_MEASURES.

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

Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский..

Linear Unit
Populate_Directions
(Дополнительный)

Укажите, должен ли инструмент создавать путевой лист для каждого маршрута.

  • DIRECTIONS —Будет создан путевой лист, настроенный в соответствии со значениями параметров Язык путевого листа, Имя стиля путевого листа и Единицы расстояния путевого листа.
  • NO_DIRECTIONS —Путевой лист не создается, инструмент возвращает пустой слой Directions.
Boolean
Directions_Language
(Дополнительный)

Укажите язык, на котором должен создаваться путевой лист.

Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True.

Список возможных языков для путевого листа зависит от установленных на вашем компьютере языковых пакетов ArcGIS. Значения имеют вид двух– или пятисимвольных кодов языка, например en для английского языка или zh-CN для упрощенного китайского.

Если указан неподдерживаемый код языка, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию.

String
Directions_Distance_Units
(Дополнительный)

Укажите единицы измерения для отображения расстояний в путевом листе. Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True.

  • Miles
  • Kilometers
  • Meters
  • Feet
  • Yards
  • NauticalMiles
String
Directions_Style_Name
(Дополнительный)

Укажите имя стиля форматирования для путевого листа. Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True. Параметр может принимать следующие значения:

  • NA Desktop — Создает готовый для печати путевой лист от поворота к повороту.
  • NA Navigation — Создает путевой лист со всеми поворотами для автомобильного навигационного устройства.
  • NA Campus —Создает путевой лист для пешеходов, включающий тротуары и проходы внутри зданий.
String
Maximum_Features_Affected_by_Point_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют точечные барьеры

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Features_Affected_by_Line_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют линейные барьеры

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Features_Affected_by_Polygon_Barriers
(Дополнительный)

Ограничивает количество объектов, на которые влияют полигональные барьеры.

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Facilities
(Дополнительный)

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

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Facilities_to_Find
(Дополнительный)

Ограничивает число ближайших пунктов обслуживания, которые ищет сервис.

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

NULL соответствует отсутствию ограничений.

Long
Maximum_Incidents
(Дополнительный)

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

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

NULL соответствует отсутствию ограничений.

Long
Force_Hierarchy_Beyond_Distance
(Дополнительный)

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

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

Значение NULL определяет отсутствие иерархии, при этом всегда будет учитываться значение параметра Использовать иерархию в анализе. Если входной набор сетевых данных не поддерживает иерархию, то указание значения для данного параметра приведет к ошибке. В этом случае необходимо использовать значение NULL.

Double
Save_Output_Network_Analysis_Layer
(Дополнительный)
  • NO_SAVE_OUTPUT_LAYER —Слой сетевого анализа не включается в выходные данные.
  • SAVE_OUTPUT_LAYER —В выходные данные включается слой сетевого анализа с результатами.

В любом случае возвращаются классы пространственных объектов с маршрутами и путевым листами. Однако администратор сервера может также выбрать вывод и слоя сетевого анализа, чтобы настройку и результаты работы инструмента можно было отладить с использованием средств управления Network Analyst в среде ArcGIS Desktop. Это намного упрощает процесс отладки.

В ArcGIS Desktop выходное местоположение слоя сетевого анализа по умолчанию – это временная папка. Вы можете определить местоположение временной папки по значению arcpy.env.scratchFolder среды геообработки. Выходной слой сетевого анализа хранится в виде LYR-файла, имя которого начинается с _ags_gpna, а затем следует буквенно-числовое значение GUID.

Boolean
Travel_Mode
(Дополнительный)

Выберите режим передвижения для анализа. CUSTOM можно выбрать всегда. Чтобы появились другие режимы, они должны быть представлены в наборе сетевых данных в параметре Network_Dataset. (Функция arcpy.na.GetTravelModes содержит словарь объектов режима движения для класса сетевых объектов, а свойство name возвращает имя объекта режима передвижения.)

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

  • UTurn_Policy

  • Time_Attribute

  • Time_Attribute_Units

  • Distance_Attribute

  • Distance_Attribute_Units

  • Use_Hierarchy_in_Analysis

  • Restrictions

  • Attribute_Parameter_Values

  • Route_Line_Simplification_Tolerance

  • CUSTOM —Определите режим, соответствующий вашим нуждам. При выборе режима CUSTOM инструмент не перезаписывает параметры режима, перечисленные выше. Это значение используется по умолчанию.
String
Overrides
(Дополнительный)

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

Для этого параметра должно быть задано значение в формате JavaScript Object Notation (JSON). К примеру, допустимое значение имеет следующий вид: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми.

Значение по умолчанию является пустым, что означает отсутствие замещения каких-либо настроек механизма расчета.

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

String
Save_Route_Data
(Дополнительный)

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

В ArcGIS Desktop выходное местоположение данного выходного файла – это временная папка. Вы можете определить местоположение временной папки, используя значение arcpy.env.scratchFolder среды геообработки.

  • SAVE_ROUTE_DATA — Если отмечено, то инструмент записывает zip-архив, содержащий рабочую область файловой базы геоданных, в которой хранятся входные и выходные данные анализа.
  • NO_SAVE_ROUTE_DATA —Данные маршрута не сохранены. Используется по умолчанию.
Boolean

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

ИмяОбъяснениеТип данных
Output_Routes

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

Набор объектов
Output_Directions

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

Набор объектов
Solve_Succeeded

Означает, был ли анализ ближайшего пункта обслуживания успешен.

Логические
Output_Closest_Facilities

Пункты обслуживания, ближайшие к инциденту.

Набор объектов
Output_Network_Analysis_layer

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

Файл
Output_Route_Data

Файл zip, содержащий всю информацию об определенном маршруте.

Файл

Пример кода

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

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

import arcpy
incidents = arcpy.FeatureSet()
incidents.load("Stores")
facilities = arcpy.FeatureSet()
facilities.load("Warehouses")
arcpy.na.FindClosestFacilities(incidents, facilities, "Minutes",
                                "Streets_ND", "in_memory", "Routes",
                                "Directions", "CLosestFacilities",
                                Number_of_Facilities_to_Find=1)
FindClosestFacilities, пример 2 (автономный скрипт)

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

# Name: FindClosestFacilities_Workflow.py
# Description: For each store, find the closest warehouse. The output will show
#              the routes between stores and warehouses, driving directions,
#              and the subset of warehouses that were closest to stores.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension("Network")

    #Set environment settings
    env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Paris.gdb'
    env.overwriteOutput = True

    #Set local variables
    inNetworkDataset = r'Transportation\ParisMultimodal_ND'
    inIncidents = r'Analysis\Stores'
    inFacilities = r'Analysis\Warehouses'
    outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
    outRoutes = "Routes"
    outDirections = "Directions"
    outClosestFacilities = "ClosestFacilities"
    measurement_units = "Minutes"

    # Run FindClosestFacilities. Choose to find only the closest facility.
    arcpy.na.FindClosestFacilities(inIncidents, inFacilities, measurement_units,
                                    inNetworkDataset, outGeodatabase, outRoutes,
                                    outDirections, outClosestFacilities,
                                    Number_of_Facilities_to_Find=1)

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

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

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

  • Basic: Требуется Network Analyst
  • Standard: Требуется Network Analyst
  • Advanced: Требуется Network Analyst

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