ArcMap

FindClosestFacilities

Сводка

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

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

Более подробно о выходных данных инструмента FindClosestFacilities

Иллюстрация

Результаты работы FindClosestFacilities

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

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

  • Необходимо указать как минимум один пункт обслуживания и один инцидент. Вы можете загрузить до 5 000 пунктов обслуживания и 5 000 инцидентов, и вы можете найти до 100 ближайших пунктов обслуживания для каждого инцидента. Таким образом, при каждом запуске инструмента можно будет найти до 500 000 ближайших пунктов обслуживания.

  • Вы можете добавить до 250 точечных барьеров. Вы можете добавить любое количество линейных или полигональных барьеров, но линейные барьеры не могут пересекать более 500 объектов-улиц, а полигональные – более 2 000 объектов.

  • Вы можете использовать иерархию дорог, что позволит быстрее получить результаты, но полученное решение может быть менее оптимальным.

  • Независимо от того, включен ли параметр Использовать иерархию (True), иерархия всегда используется, если прямолинейное расстояние между любой парой объектов, соответствующим инцидентам или пунктам обслуживания, составляет более 50 миль (80,46 км).

  • Евклидово расстояние между любой парой объектов, представляющих инциденты или пункты обслуживания, не может быть больше, чем 27 миль (43,45 километров), если для параметра Режим передвижения задано значение Пешком, или если задано значение Пользовательский и используется ограничение Пешком.

  • Если расстояние между входной точкой и ближайшей проезжей улицей больше 12,42 миль (20 км), точка исключается из анализа.

  • При использовании этого сервиса расходуются кредиты. Подробнее см. в разделе Обзор сервисных кредитов.

  • Данный инструмент предназначен для работы в , ArcGIS Pro, ArcMap, ArcGlobe и ArcScene, но не в ArcCatalog.

Синтаксис

arcpy.naagol.FindClosestFacilities(Incidents, Facilities, Measurement_Units, {Analysis_Region}, {Number_of_Facilities_to_Find}, {Cutoff}, {Travel_Direction}, {Use_Hierarchy}, {Time_of_Day}, {Time_of_Day_Usage}, {UTurn_at_Junctions}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Save_Route_Data}, {Time_Impedance}, {Distance_Impedance}, {Output_Format}, {Ignore_Invalid_Locations})
ПараметрОбъяснениеТип данных
Incidents

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

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

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

Name

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

ID

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

AdditionalTime

Количество времени, затраченное на месте инцидента, которое добавляется к общему времени маршрута. По умолчанию значение равно 0.

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

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

AdditionalDistance

Дополнительное расстояние, пройденное машинами на месте происшествия, которое добавляется к общей протяженности маршрута. По умолчанию значение равно 0.

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

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

AdditionalCost

Дополнительная стоимость, потраченная на месте происшествия, которая добавляется к общей стоимости маршрута. По умолчанию значение равно 0.

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

TargetFacilityCount

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

Cutoff

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

CurbApproach

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

  • 0 (Either side of vehicle)—The vehicle can approach and depart the incident in either direction, so a U-turn is allowed at the incident. This setting can be chosen if it is possible and practical for a vehicle to turn around at the incident. This decision may depend on the width of the road and the amount of traffic or whether the incident has a parking lot where vehicles can pull in and turn around.
  • 1 (Right side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side.
  • 2 (Left side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the left side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side.
  • 3 (No U-Turn)—When the vehicle approaches the incident, the curb can be on either side of the vehicle; however, the vehicle must depart without turning around.

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

Bearing

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

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

Данное поле используется при расчете только, если для Bearing и BearingTol также введены значения; при этом ввод значения NavLatency является необязательным, даже если для Bearing и BearingTol заданы значения. NavLatency показывает, сколько, предположительно, проходит времени между отправкой данных GPS от движущегося транспортного средства на сервер и моментом, когда обработанный маршрут поступает на навигационное устройство транспортного средства.

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

Feature Set
Facilities

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

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

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

Name

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

ID

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

AdditionalTime

Время, затраченное в пункте обслуживания, которое добавляется к общему времени маршрута. По умолчанию значение равно 0.

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

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

AdditionalDistance

Дополнительное расстояние, пройденное машинами в пункте обслуживания, которое добавляется к общей протяженности маршрута. По умолчанию значение равно 0.

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

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

AdditionalCost

Дополнительная стоимость, потраченная в пункте обслуживания, которая добавляется к общей стоимости маршрута. По умолчанию значение равно 0.

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

Cutoff

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

CurbApproach

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

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

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

Bearing

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

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

Данное поле используется при расчете только, если для Bearing и BearingTol также введены значения; при этом ввод значения NavLatency является необязательным, даже если для Bearing и BearingTol заданы значения. NavLatency показывает, сколько, предположительно, проходит времени между отправкой данных GPS от движущегося транспортного средства на сервер и моментом, когда обработанный маршрут поступает на навигационное устройство транспортного средства.

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

Feature Set
Measurement_Units

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

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

  • Meters —Единицы расстояния – метры.
  • Kilometers —Единицы расстояния – километры.
  • Feet —Единицы расстояния – футы.
  • Yards —Единицы расстояния – ярды.
  • Miles —Единицы расстояния – мили.
  • NauticalMiles —Единицы расстояния – морские мили.
  • Seconds —Единица времени – секунды.
  • Minutes —Единица времени – минуты.
  • Hours —Единица времени – часы.
  • Days —Единица времени – дни.
String
Analysis_Region
(Дополнительный)

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

Чтобы задать регион используйте одно из следующих значений:

  • Europe —Регион анализа - Европа.
  • Japan —Регион анализа - Япония.
  • Korea —Регион анализа - Корея.
  • MiddleEastAndAfrica —Регион анализа - Ближний Восток и Африка.
  • NorthAmerica —Регион анализа - Северная Америка.
  • SouthAmerica —Регион анализа - Южная Америка.
  • SouthAsia —Регион анализа - Южная Азия.
  • Thailand —Регион анализа - Таиланд.
String
Number_of_Facilities_to_Find
(Дополнительный)

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

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

Инструмент может находить до 100 пунктов обслуживания для каждого инцидента.

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

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

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

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

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

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

  • Facility to Incident —Направление движения – от пункта обслуживания к инциденту.
  • Incident to Facility —Направление движения – от инцидента к пункту обслуживания.

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

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

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

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

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

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

Инструмент автоматически начинает использовать иерархию, если расстояние по прямой между пунктами обслуживания и инцидентами превышает 50 миль, даже если параметр задан как Не отмечено (False в Python).

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

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

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

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

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

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

  • Start Time —Инструмент рассматривает значение параметра Время дня как время отправления с пункта обслуживания или инцидента, чтобы найти лучший маршрут.
  • End Time —Инструмент рассматривает значение параметра Время дня как время прибытия в пункт обслуживания или инцидента, чтобы найти лучший маршрут. Этот параметр можно использовать для того, чтобы узнать, в какое время необходимо выехать, чтобы прибыть в пункт назначения в момент времени, заданный параметром Время суток.
String
UTurn_at_Junctions
(Дополнительный)

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

  • Allowed —Развороты разрешены в соединениях с любым количеством смежных ребер. Это значение используется по умолчанию.
  • Not Allowed —Развороты запрещены во всех соединениях, вне зависимости от их валентности. Обратите внимание, однако, что развороты по-прежнему разрешены в сетевых местоположениях, даже если выбран этот параметр; однако вы можете установить атрибут CurbApproach отдельных сетевых местоположений, чтобы запретить развороты и там.
  • Allowed Only at Dead Ends —Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик).
  • Allowed Only at Intersections and Dead Ends —Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Часто сети имеют избыточные соединения в середине сегмента дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.

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

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

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

Инструмент может накладывать до 250 ограничений, точек, добавленных в качестве барьеров.

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

Name

Имя барьера.

BarrierType

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

  • 0 (Restriction) – запрещает прохождение через барьер. Барьер, действующий как запрещающий, рассматривается как ограничительный точечный барьер.

  • 2 (Added Cost) – прохождение через барьер увеличивает время в пути или расстояние на значение, указанное в полях Additional_Time, Additional_Distance или AdditionalCost. Этот тип барьера называется барьером дополнительной стоимости.

Additional_Time

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

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

Additional_Distance

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

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

AdditionalCost

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

FullEdge

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

  • (0) False – разрешает путь по ребру до барьера, но не через него. Это значение используется по умолчанию.
  • 1 (True) – Запрещает путь повсюду в связанном ребре.

CurbApproach

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

  • 0 (Любая сторона транспортного средства) – Барьер влияет на перемещение по ребру в обоих направлениях.
  • 1 (Правая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с правой стороны по ходу движения. Барьер не влияет на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится слева от них.
  • 2 (Левая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с левой стороны по ходу движения. Барьер не распространяется на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится справа от них.

Так как соединения являются точками и не имеют сторон, барьеры на соединениях влияют на все транспортные средства независимо от стороны подъезда.

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

Bearing

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

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

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

Более подробно о направлении и допуске направления

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

NavLatency

Данное поле используется при расчете только, если для Bearing и BearingTol также введены значения; при этом ввод значения NavLatency является необязательным, даже если для Bearing и BearingTol заданы значения. NavLatency показывает, сколько, предположительно, проходит времени между отправкой данных GPS от движущегося транспортного средства на сервер и моментом, когда обработанный маршрут поступает на навигационное устройство транспортного средства.

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

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

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

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

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

Name

Имя барьера.

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

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

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

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

Name

Имя барьера.

BarrierType

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

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

  • 1 (Scaled Cost) – масштабирует стоимость (например, время в пути или расстояние), необходимую для проезда по лежащим ниже улицам, на коэффициент, указанный с помощью поля ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера называется полигональным барьером масштабируемой стоимости. Он может использоваться для моделирования погодных условий, из-за которых скорость перемещения в указанных регионах снижается.

ScaledTimeFactor

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

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

ScaledDistanceFactor

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

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

ScaledCostFactor

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

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

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

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

Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев ограничения запрещают использование тех или иных дорог. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для подъезда к инциденту или пункту обслуживания. Ограничение по высоте позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено.

Инструмент поддерживает следующие ограничения:

  • Any Hazmat Prohibited —В маршрут не включаются дороги, по которым запрещена перевозка любых видов опасных веществ.Доступность: Выберите страны в Северной Америке и Европе
  • Avoid Carpool Roads —В маршрут не будут включаться дороги, предназначенные исключительно для пассажирских перевозок (автобусы и т.д.).Доступность: Все страны
  • Avoid Express Lanes —В маршрут не будут включаться дороги, предназначенные для скоростного передвижения.Доступность: Все страны
  • Avoid Ferries —В маршруте не будут использоваться паромные переправы.Доступность: Все страны
  • Avoid Gates —В маршрут не будут включаться дороги, на которых имеются ворота для въезда по пропуску или охраняемые въезды.Доступность: Все страны
  • Avoid Limited Access Roads —В маршрут не будут включаться дороги с ограниченным доступом.Доступность: Все страны
  • Avoid Private Roads —В маршрут не будут включаться частные дороги.Доступность: Все страны
  • Avoid Roads Unsuitable for Pedestrians —В маршрут не будут включаться дороги, не предназначенные для движения по ним пешеходов.Доступность: Все страны
  • Avoid Stairways —В маршрут для пешехода не будут включаться все лестницы.Доступность: Все страны
  • Avoid Toll Roads —В маршруте для легковых автомобилей не будут использоваться платные дороги.Доступность: Все страны
  • Avoid Toll Roads for Trucks —В маршруте для легковых автомобилей не будут использоваться платные дороги.Доступность: Все страны
  • Avoid Truck Restricted Roads —В результатах будут отсутствовать соответствующие дороги если только на них не находится точка доставки.Доступность: Все страны
  • Avoid Unpaved Roads —В маршрут не будут включаться дороги без покрытия (например, грунтовые, с гравийным покрытием и т.д.).Доступность: Все страны
  • Axle Count Restriction —В маршрут не будут включаться дороги, на которых запрещены грузовики с указанным числом осей. Число осей задается параметром Number of Axles.Доступность: Выберите страны в Северной Америке и Европе
  • Driving a Bus —В маршрут не будут включаться дороги, по которым запрещено перемещение на автобусах. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Driving a Taxi —В маршрут не будут включаться дороги, по которым запрещено перемещение на такси. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Driving a Truck —В маршрут не будут включаться дороги, по которым запрещено перемещение на грузовиках. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Driving an Automobile —В маршрут не будут включаться дороги, по которым запрещено перемещение на автомобилях. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Driving an Emergency Vehicle —В маршрут не будут включаться дороги, по которым запрещено перемещение аварийно-спасательных автомобилей. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Height Restriction —В маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной высоты. Высота транспортного средства задается параметром Vehicle Height (в метрах).Доступность: Выберите страны в Северной Америке и Европе
  • Kingpin to Rear Axle Length Restriction —В маршрут не будут включаться дороги, по которым запрещено движение всех грузовиков с шириной заноса задней оси больше разрешенной. Это значение задается параметром Vehicle Kingpin to Rear Axle Length (метры).Доступность: Выберите страны в Северной Америке и Европе
  • Length Restriction —В маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной длины. Длина транспортного средства задается параметром Vehicle Length (в метрах).Доступность: Выберите страны в Северной Америке и Европе
  • Preferred for Pedestrians —В маршрут будут предпочтительно включаться дороги, подходящие для передвижения пешеходов.Доступность: Выберите страны в Северной Америке и Европе
  • Riding a Motorcycle —В маршрут не будут включаться дороги, по которым запрещено перемещение на мотоциклах. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением.Доступность: Все страны
  • Roads Under Construction Prohibited —В маршрут не будут включаться ремонтируемые дороги.Доступность: Все страны
  • Semi or Tractor with One or More Trailers Prohibited —В маршрут не будут включаться дороги, на которых запрещено движение тягачей с одним или более трейлерами.Доступность: Выберите страны в Северной Америке и Европе
  • Single Axle Vehicles Prohibited —В маршрут не будут включаться дороги, на которых запрещены одноосные транспортные средства.Доступность: Выберите страны в Северной Америке и Европе
  • Tandem Axle Vehicles Prohibited —В маршрут не будут включаться дороги, на которых запрещены транспортные средства со сдвоенными осями.Доступность: Выберите страны в Северной Америке и Европе
  • Through Traffic Prohibited —В результаты не будут включаться дороги, по которым запрещен сквозной проезд.Доступность: Все страны
  • Truck with Trailers Restriction —В маршрут не будут включаться дороги, на которых запрещены грузовики с прицепом. Число прицепов задается параметром ограничений Number of Trailers on Truck.Доступность: Выберите страны в Северной Америке и Европе
  • Use Preferred Hazmat Routes —Маршрут пройдет по дорогам, которые предназначены для перевозки опасных веществ.Доступность: Выберите страны в Северной Америке и Европе
  • Use Preferred Truck Routes —Маршруты будут, по возможности, проходить по дорогам, которые предназначены для грузовиков, например, по дорогам, которые являются частью национальной дорожной сети, как указано в National Surface Transportation Assistance Act для США, или по дорогам, которые предназначены для грузовиков в штатах или провинциях, или по дорогам, которые предпочитают водители.Доступность: Выберите страны в Северной Америке и Европе
  • Walking —В маршрут не будут включаться дороги, по которым запрещено перемещение пешеходов.Доступность: Все страны
  • Weight Restriction —В маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной массы. Вес транспортного средства задается параметром Vehicle Weight (в килограммах).Доступность: Выберите страны в Северной Америке и Европе
  • Weight per Axle Restriction —В маршрут не будут включаться дороги, по которым запрещено движение автомобилей с нагрузкой на ось больше разрешенной. Нагрузка на ось задается параметром Vehicle Weight per Axle (в килограммах).Доступность: Выберите страны в Северной Америке и Европе
  • Width Restriction —В маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной ширины. Ширина транспортного средства задается параметром Vehicle Width (в метрах).Доступность: Выберите страны в Северной Америке и Европе
String
Attribute_Parameter_Values
(Дополнительный)

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

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

  • AttributeName – имя ограничения.
  • ParameterName – имя параметра, связанного с ограничением. В зависимости от целей ограничения, оно может иметь одно или несколько значений поля ParameterName.
  • ParameterValue- значение для ParameterName, используемое инструментом при оценке ограничения.

Параметр Значения Параметра атрибутов зависит от параметра Ограничения. Поле ParameterValue применяется, только если в качестве значения параметра Ограничения указано имя ограничения.

В параметре Значения Параметра атрибутов каждое ограничение (указанное, как AttributeName) содержит значение поля ParameterName, Использование ограничения, определяющее запрет, нежелательность или предпочтительность использования дорог, для которых установлено ограничение, а также степень нежелательности или предпочтительности использования дорог. Поле Использование ограничения ParameterName может иметь одно из следующих строковых значений или эквивалентных числовых значений, указанных в скобках:

  • PROHIBITED (-1) – передвижение по дорогам, имеющим это ограничение, полностью запрещено.
  • AVOID_HIGH (5) – Крайне маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • AVOID_MEDIUM (2) – маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • AVOID_LOW (1.3) – достаточно маловероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_LOW (0.8) – достаточно вероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_MEDIUM (0,5) – вероятно, что инструмент включит в маршрут дороги с этим ограничением.
  • PREFER_HIGH (0,2) – Крайне вероятно, что инструмент включит в маршрут дороги с этим ограничением.

Как правило, для поля Использование ограничения используется значение по умолчанию, PROHIBITED, если ограничение связано с характеристиками транспортного средства, например, с его высотой. Однако в некоторых случаях значение поля Использование ограничения будет зависеть от ваших предпочтений при выборе маршрута. Например, для ограничения Избегать платных дорог параметр Использование ограничения имеет по умолчанию значение AVOID_MEDIUM. Это означает, что, при наличии данного ограничения инструмент будет по возможности избегать использования платных дорог при построении маршрута. Значение AVOID_MEDIUM также указывает, насколько важно избегать использования платных дорог при поиске лучшего маршрута: это ограничение имеет средний приоритет. При выборе AVOID_LOW исключение платных дорог из маршрута будет иметь меньшее значение, а при выборе AVOID_HIGH – большее, поэтому сервис будет создавать более длинные маршруты, чтобы по возможности избежать использования платных дорог. При выборе PROHIBITED использование платных дорог будет полностью запрещено, и сервис не сможет включать их даже частично в маршрут. Имейте в виду, что в некоторых ситуациях важно избежать или запретить платные дороги, чтобы избежать платы за проезд. И наоборот, другие предпочитают ездить по платным дорогам, потому что движение без пробок для них более ценно, чем деньги, потраченные на платные дороги. В последнем случае для параметра Использование ограничения следует выбрать значения PREFER_LOW, PREFER_MEDIUM или PREFER_HIGH. Чем выше предпочтительность, тем в большей степени маршрут будет проходить по дорогам с этим ограничением.

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

Укажите тип объектов маршрута, получаемых на выходе инструмента.

  • True Shape —Возврат точной геометрии выходного маршрута, на основе исходных улиц.
  • True Shape with Measures —Возврат точной геометрии выходного маршрута, на основе исходных улиц. Дополнительно строятся измерения, чтобы можно было использовать их для линейной привязки. Значения измерений увеличиваются от первой остановки и сохраняют общее время в пути или расстояние в пути в единицах, заданных в параметре Единицы измерения.
  • Straight Line —Возврат прямой линии между двумя остановками.
  • None —Не возвращать геометрию маршрутов. Это значение можно использовать (и быстро получать результаты) в тех случаях, когда нужно определить только общую продолжительность или время пути маршрута.

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

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

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

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

Инструмент игнорирует этот параметр, если значение параметра Геометрия маршрута отличается от Истинная форма.

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

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

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

  • Отмечено (True в Python) – будет создан путевой лист, настроенный в соответствии со значениями параметров Язык путевого листа, Имя стиля путевого листа и Единицы расстояния путевого листа.
  • Не отмечено (False в Python) – путевой лист не создается, и инструмент возвращает пустой слой Directions.

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

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

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

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

  • ar - Арабский
  • bs - Боснийский
  • ca - Каталонский
  • cs - Чешский
  • da -Датский
  • de - Немецкий
  • el - Греческий
  • en - Английский
  • es - Испанский
  • et - Эстонский
  • fi - Финский
  • fr - Французский
  • he - Иврит
  • hr - Хорватский
  • hu - Венгерский
  • id - Индонезийский
  • it - Итальянский
  • ja - Японский
  • ko - Корейский
  • lt - Литовский
  • lv - Латвийский
  • nb - Норвежский
  • nl - Нидерландский
  • pl - Польский
  • pt-BR - Португальский (Бразильский)
  • pt-PT - Португальский (Португалия)
  • ro - Румынский
  • ru - Русский
  • sk - Словацкий
  • sl - Словенский
  • sr - Сербский
  • sv - Шведский
  • th - Тайский
  • tr - Турецкий
  • uk - Украинский
  • vi - Вьетнамский
  • zh-CN - Китайский (Китай)
  • zh-HK - Китайский (Гонконг)
  • zh-TW - Китайский (Тайвань)

Сначала инструмент ищет точное соответствие для заданного языка, включая любую локализацию. Если не нашлось точного соответствия, будет выполнена попытка найти соответствие в пределах языковой семьи. Если соответствие не будет найдено, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию. К примеру, если установлен язык путевого листа es-MX (мексиканский испанский), инструмент возвратит путевой лист на испанском, так как поддерживает код языка es и не поддерживает es-MX.

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

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

  • Miles —Единицы расстояния – мили.
  • Kilometers —Единицы расстояния – километры.
  • Meters —Единицы расстояния – метры.
  • Feet —Единицы расстояния – футы.
  • Yards —Единицы расстояния – ярды.
  • NauticalMiles —Единицы расстояния – морские мили.
String
Directions_Style_Name
(Дополнительный)

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

  • NA Desktop —Готовый для печати путевой лист со всеми поворотами.
  • NA Navigation —Путевой лист со всеми поворотами для автомобильного навигационного устройства.
String
Time_Zone_for_Time_of_Day
(Дополнительный)

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

  • Geographically Local —Значение параметра Время суток относится к часовому поясу, в котором находятся пункты обслуживания или инциденты.Если значением параметра Использование времени суток является Время начала, а значением параметра Направление движения является От пункта обслуживания к инциденту, то это будет часовой пояс пунктов обслуживания.Если значением параметра Использование времени суток является Время начала, а значением параметра Направление движения является От инцидента к пункту обслуживания, то это будет часовой пояс инцидентов.Если значением параметра Использование времени суток является Время окончания, а значением параметра Направление движения является От пункта обслуживания к инциденту, то это будет часовой пояс инцидентов.Если значением параметра Использование времени суток является Время окончания, а значением параметра Направление движения является От инцидента к пункту обслуживания, то это будет часовой пояс пунктов обслуживания.
  • UTC —Значения параметра Время суток указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если хотите найти ближайшие пункты обслуживания для конкретного момента времени, например, текущего, но не знаете, в каком часовом поясе будут находиться пункты обслуживания или инциденты.

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

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

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

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

Для получения списка имен поддерживаемых режимов передвижения используйте то же подключение к ГИС-серверу, которое вы использовали для доступа к этому инструменту, и в наборе инструментов Утилиты запустите инструмент GetTravelModes. Инструмент GetTravelModes добавляет в приложение таблицу Поддерживаемых режимов передвижения. В качестве входных данных можно задать любое значение в поле Travel Mode Name таблицы Поддерживаемые режимы передвижения. Вы также можете указать в качестве входного значение из поля Travel Mode Settings. Это ускорит выполнение инструмента, поскольку инструмент не будет искать настройки на основании имени режима передвижения.

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

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

Задайте импеданс – значение, представляющее затраты или стоимость перемещения вдоль сегментов дорог или других частей транспортной сети.

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

Расстояние перемещения – это импеданс; длина дороги в километрах рассматривается как импеданс. В этом смысле расстояние аналогично для всех режимов – километр останется километром и для пешехода, и для машины. (Что может измениться, так это пути, по которым разрешено перемещаться в различных режимах, что влияет на расстояние между точками и моделируется настройками режима передвижения.)

  • TravelTime —Используются данные исторического трафика или трафика в режиме реального времени. Эта опция применяется для моделирования времени, которое требуется автомобилю для передвижения по дорогам в определенное время суток, при использовании данных текущего трафика, где это доступно. При использовании TravelTime вы можете дополнительно указать параметр TravelTime::Vehicle Maximum Speed (km/h), чтобы задать физическое ограничение скорости движения транспортного средства.
  • Minutes —Данные о трафике в режиме реального времени не используются, но при этом используются средние исторические скорости передвижения автомобилей на данном участке.
  • TruckTravelTime —Используются данные исторического трафика или трафика в режиме реального времени, но скорость адаптирована в соответствии с максимальной разрешенной скоростью для грузовиков. Это применяется для моделирования времени, которое требуется грузовику для передвижения по дорогам в определенное время суток. При использовании TruckTravelTime вы можете дополнительно указать параметр TruckTravelTime::Vehicle Maximum Speed (km/h), чтобы задать физическое ограничение скорости движения грузовика.
  • TruckMinutes —Не используется трафик в реальном времени, расчет выполняется на основе самой маленькой исторической средней скорости автомобилей и максимально допустимой скорости, заданной на каждом участке дорог для грузовиков.
  • WalkTime —По умолчанию задает скорость передвижения пешехода равной 5 км/ч, но это значение можно изменить с помощью атрибутивного параметра WalkTime::Walking Speed (km/h).
  • Miles —Измерения длин дорог хранятся в милях и могут использоваться при выполнении анализа, основанного на кратчайшем расстоянии.
  • Kilometers —Хранит измерений длин дорог в километрах и может использоваться при выполнении анализа, основанного на кратчайшем расстоянии.
  • TimeAt1KPH —По умолчанию скорость равна 1 км/ч на всех дорогах и путях. Эту скорость нельзя изменить с помощью атрибутивных параметров.
  • Drive Time —Моделирует время в пути для легкового автомобиля. Это время является динамичным и изменяется в зависимости от транспортных потоков, если доступны данные трафика Это значение используется по умолчанию.
  • Truck Time —Моделирует время в пути для грузовика. Это время является статичным для каждой дороги и не зависит от трафика.
  • Walk Time —Моделирует время в пути для пешехода.
  • Travel Distance —Хранит измерения длин дорог и путей. Для моделирования расстояния пешком выберите эту опцию и убедитесь, что Пешком задано в параметре Ограничение. Аналогично, для моделирования расстояния поездки на машине или грузовике выберите здесь Расстояние пути и задайте соответствующие ограничения, чтобы транспортное средство перемещалось только по тем дорогам, по которым для разрешено движение.

При выборе импенданса на основе времени, такого как TravelTime, TruckTravelTime, Minutes, TruckMinutes или WalkTime, параметру Единицы граничных значений необходимо задать значение на основе времени; при выборе импеданса на основе расстояния, такого как Miles, Kilometers, Единицы граничных значений должны быть основаны на расстоянии.

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

Указывает, будут ли параметры анализа сохранены в виде файла слоя сетевого анализа. Вы не можете работать с этим файлом напрямую, даже если вы откроете его в приложении ArcGIS Desktop, например, в ArcMap. Это предназначено для отправки в техническую поддержку Esri для диагностики качества результатов, получаемых инструментом.

  • Отмечено (True в Python) - выходные данные будут сохранены в виде файла слоя сетевого анализа. Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
  • Не отмечено (False в Python) - выходные данные не будут сохранены в виде файла слоя сетевого анализа. Это значение по умолчанию

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

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

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

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

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

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

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

  • Отмечено (True в Python) – сохраняет данные маршрута как файл .zip. Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в истории геообработки в вашем проекте. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.
  • Не отмечено (False в Python) – данные маршрута не сохранены как файл .zip. Это значение по умолчанию

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

Импеданс на основе времени - это значение, которое задает время перемещения вдоль сегментов дорог или других частей транспортной сети.

  • Minutes —Импеданс времени - минуты.
  • TravelTime —Импеданс времени - время пути.
  • TimeAt1KPH —Импеданс времени - время при одном км в час.
  • WalkTime —Импеданс времени - время пешком.
  • TruckMinutes —Импеданс времени - минуты на грузовике.
  • TruckTravelTime —Импеданс времени - время пути на грузовике.
String
Distance_Impedance
(Дополнительный)

Импеданс на основе расстояния - это значение, которое задает расстояние перемещения вдоль сегментов дорог или других частей транспортной сети.

  • Miles —Импеданс расстояния в милях.
  • Kilometers —Импеданс расстояния в километрах.
String
Output_Format
(Дополнительный)

Определяет формат, в котором будут созданы выходные объекты.

  • Feature Set —Выходные объекты возвращаются в виде классов объектов и таблиц. Это значение по умолчанию
  • JSON File —Выходные объекты возвращаются в виде сжатого файла, содержащего представление JSON выходных данных. Если выбрана эта опция, на выходе будет один файл (с расширением .zip), содержащий один или несколько файлов JSON (с расширением .json) - для каждого созданного сервисом выходного набора.
  • GeoJSON File —Выходные объекты возвращаются в виде сжатого файла, содержащего представление JSON выходных данных. Если выбрана эта опция, на выходе будет один файл (с расширением .zip), содержащий один или несколько файлов GeoJSON (с расширением .geojson) - для каждого созданного сервисом выходного набора.

Если указан формат выхода на основе файла, такой как файл JSON или файл GeoJSON, выходные данные не будут добавлены к отображению, потому что приложение, такое как ArcMap или ArcGIS Pro, не может отобразить содержание файла результатов. Напротив, файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в истории геообработки на панели проект. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.

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

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

  • SKIP —Сетевые местоположения, которые не определены, будут игнорироваться, и анализ будет выполняться с использованием только допустимых сетевых местоположений. Анализ также будет продолжен, если местоположения находятся на непреодолимых элементах или имеют другие ошибки. Это полезно, если вы знаете, что не все ваши сетевые местоположения верны, но вы хотите запустить анализ с использованием допустимых сетевых местоположений. Это значение по умолчанию
  • HALT —Недопустимые местоположения не будут игнорироваться. Не запускает анализ, если есть недопустимые местоположения. Исправьте неверные местоположения и перезапустите анализ.
Boolean

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

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

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

Boolean
Output_Routes

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

Feature Set
Output_Directions

Обеспечивает доступ к пошаговому путевому листу для каждого маршрута.

Feature Set
Output_Closest_Facilities

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

Feature Set
Output_Network_Analysis_Layer

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

File
Output_Route_Data

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

File
Output_Incidents

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

Feature Set
Output_Facilities

Пункты обслуживания, использованные в анализе.

Feature Set
Output_Result_File

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

File
Output_Network_Analysis_Layer_Package

Пакет слоев, который включает слой сетевого анализа с данными и настройками, используемыми в анализе.

File
Output_Direction_Points

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

Feature Set
Output_Direction_Lines

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

Feature Set

Пример кода

Пример FindClosestFacilities (автономный скрипт)

Следующий скрипт Python демонстрирует, как использовать инструмент FindClosestFacilities в скрипте.

"""This example shows how to find three closest stores from each customer location."""

import sys
import time
import arcpy

# Change the username and password applicable to your own ArcGIS Online account
username = "<your user name>"
password = "<your password>"
cf_service = "https://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)

# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(cf_service)

# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
incidents = "C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_closest_facilities = "C:/data/Results.gdb/ClosestStores"

# Call the tool
result = arcpy.FindClosestFacilities_ClosestFacility(incidents, facilities, "Minutes", "", 3)
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))

# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
    time.sleep(1)

# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    arcpy.AddError("An error occured when running the tool")
    arcpy.AddError(result.getMessages(2))
    sys.exit(2)
elif result_severity == 1:
    arcpy.AddWarning("Warnings were returned when running the tool")
    arcpy.AddWarning(result.getMessages(1))

# Save the output routes and the closest facilities to a geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(3).save(output_closest_facilities)

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

Этот инструмент не использует параметры среды геообработки

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