FindClosestFacilities (ClosestFacility)

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

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

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

Рисунок

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

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

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

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

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

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

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

Синтаксис

FindClosestFacilities_naagol (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})

Параметр	Объяснение	Тип данных
Incidents	Укажите один или несколько инцидентов (до 1,000). Это местоположения, относительно которых инструмент ищет ближайшие пункты обслуживания. При указании инцидентов вы можете задать с помощью атрибутов свойства каждого из них, такие как имя или время обслуживания. Для задания свойств инцидентов можно использовать следующие атрибуты: Имя (Name) – Имя инцидента. Имя используется в путевом листе. Если имя не указано, в выходных маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location. ID – Уникальный идентификатор инцидента. Идентификатор включается в выходные маршруты (как поле IncidentID) и помогает присоединить дополнительную информацию из выходных маршрутов, такую как общее время езды или общее расстояние, к атрибутам из ваших инцидентов и наоборот. Если ID не указан, сервис автоматически создает уникальный идентификатор для каждого инцидента. AdditionalTime – Количество времени, затраченное на месте инцидента, которое добавляется к общему времени маршрута. Единицы для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0. Если вы ищете пожарные части, ближайшие к месту пожара, чтобы оценить, через сколько времени начнется тушение пожара, атрибут AdditionalTime может показывать, сколько времени требуется пожарным на развертывание их оборудования на месте пожара перед тем, как они смогут начать его тушить. AdditionalDistance – Дополнительное расстояние, пройденное машинами на месте происшествия, которое добавляется к общей протяженности маршрута. Единицы для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0. Обычно место происшествия, например дом, находится не на самой улице, а на некотором удалении от проезжей части. Значение этого атрибута может использоваться для учета расстояния между действительным местоположением инцидента и его положением на улице, если имеет смысл включать это расстояние в общую протяженность пути. CurbApproach – Указывает направление, в котором транспортное средство может подъехать или отъехать от инцидента. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (Любая сторона транспортного средства) – Транспортное средство может подъезжать и отъезжать от инцидента в любом направлении, поэтому в месте инцидента разрешен разворот. Данный параметр можно выбрать, если для транспортного средства возможно и желательно развернуться в месте инцидента. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия на месте инцидента стоянки, где транспортное средство может выполнить разворот. 1 ( Правая сторона транспортного средства) – Когда транспортное средство подъезжает или отъезжает от инцидента, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа. 2 (Левая сторона транспортного средства) – Когда транспортное средство подъезжает и отъезжает от инцидента, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева. 3 (Без разворота) – При подъезде транспортного средства к инциденту бордюр может располагаться с любой стороны транспортного средства. Но при отправлении транспортное средство не должно выполнять разворот. Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда инцидент находится с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к инциденту, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к инциденту так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.	Feature Set
Facilities	Укажите один или несколько пунктов обслуживания (до 1,000). Это местоположения, которые оцениваются при поиске ближайших пунктов обслуживания. При указании пунктов обслуживания вы можете задать с помощью атрибутов свойства каждого из них, такие как имя или время обслуживания. Для задания свойств пунктов обслуживания можно использовать следующие атрибуты: Имя (Name) – Имя пункта обслуживания. Имя используется в путевом листе. Если имя не указано, в выходных маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location. ID – Уникальный идентификатор пункта обслуживания. Идентификатор включается в выходные данные маршрутов и выходные ближайших пунктов обслуживания (поля FacilityID). Поле FacilityID можно использовать для присоединения дополнительной информации из выходных маршрутов, такой как общее время езды или общее расстояние, к атрибутам из ваших пунктов обслуживания. Если ID не указан, сервис автоматически создает уникальный идентификатор для каждого пункта обслуживания. AdditionalTime – Количество времени, затраченное в пункте обслуживания, которое добавляется к общему времени маршрута. Единицы для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0. Если вы ищете пожарные части, ближайшие к пожарам, атрибут AdditionalTime может показывать время, требующееся пожарным для того, чтобы надеть защитное снаряжение и выехать из пожарной части. AdditionalDistance – Дополнительное расстояние, пройденное машинами в пункте обслуживания, которое добавляется к общей протяженности маршрута. Единицы для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0. Обычно пункт обслуживания, например пожарная часть, находится не на самой улице, а на некотором удалении от проезжей части. AdditionalDistance может использоваться для учета расстояния между действительным местоположением пункта обслуживания и его положением на улице, если имеет смысл включать это расстояние в общую протяженность пути. CurbApproach: Указывает направление, в котором транспортное средство может подъехать или отъехать от пункта обслуживания. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (Любая сторона транспортного средства) – Транспортное средство может подъезжать и отъезжать от пункта обслуживания в любом направлении, поэтому в пункте обслуживания разрешен разворот. Данный параметр можно выбрать, если для транспортного средства возможно и желательно развернуться в пункте обслуживания. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия в пункте обслуживания места для стоянки, где транспортное средство может выполнить разворот. 1 ( Правая сторона транспортного средства) – Когда транспортное средство подъезжает или отъезжает от пункта обслуживания, он должен находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа. 2 (Левая сторона транспортного средства) – Когда транспортное средство подъезжает и отъезжает от пункта обслуживания, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева. 3 (Без разворота) – При подъезде транспортного средства к пункту обслуживания бордюр может располагаться с любой стороны транспортного средства. Но при отправлении транспортное средство не должно выполнять разворот. Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда пункт обслуживания располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к пункту обслуживания, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к пункту обслуживания так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.	Feature Set
Measurement_Units	Укажите единицы, которые должны использоваться для измерения и указания общей продолжительности или протяженности пути для выходных маршрутов. Инструмент находит ближайший пункт обслуживания, измеряя продолжительность или протяженность пути вдоль улиц. Единицы, выбранные для этого параметра, определяют, будет ли инструмент измерять протяженность или продолжительность пути для нахождения ближайшего пункта обслуживания. Выберите единицу времени для измерения продолжительности пути. Для измерения протяженности пути выберите единицу расстояния. Выбранные вами единицы инструмент будет использовать также для указания общей продолжительности или протяженности пути в результатах. Можно выбрать следующие варианты: Метры (Meters) Километры (Kilometers) Футы (Kilometers) Ярды (Yards) Мили (Miles) Морские мили (NauticalMiles) Секунды (Seconds) Минуты (Minutes) Часы (Hours) Дни (Days)	String
Analysis_Region (дополнительно)	Укажите регион, в котором выполняется анализ. Если значение этого параметра не указано, инструмент автоматически вычислит имя региона на основе местоположения входных точек. Задание имени региона рекомендуется для увеличения скорости работы инструмента. Чтобы задать регион используйте одно из следующих значений: Europe (Европа) India (Индия) Japan (Япония) Korea (Корея) MiddleEastAndAfrica (Средний Восток и Африка) NorthAmerica (Северная Америка) Oceania (Океания) SouthAmerica (Южная Америка) SouthEastAsia (Юго-Восточная Азия) Тайвань Таиланд	String
Number_of_Facilities_to_Find (дополнительно)	Укажите число ближайших пунктов обслуживания, которые нужно найти для каждого инцидента. Это полезно в ситуациях, таких как пожар, когда могут понадобиться несколько пожарных машин из разных пожарных частей. Вам может, например, понадобиться найти три пожарные части, находящиеся ближе всего к месту пожара. Инструмент может находить до 100 пунктов обслуживания для каждого инцидента.	Long
Cutoff (дополнительно)	Укажите продолжительность или протяженность пути, при которых следует прекратить поиск пунктов обслуживания для данного инцидента. Например, при нахождении ближайших к месту происшествия больниц, значение отсечки 15 минут означает, что инструмент выполнит поиск ближайшей больницы в пределах 15 минутах езды от инцидента. Если ближайшая больница находится в 17 минутах езды, поиск ближайшего пункта обслуживания не даст никаких результатов. Предельное значение особенно полезно для поиска нескольких пунктов обслуживания. Единицы измерения этого свойства задаются параметром Единицы измерения (Measurement Units).	Double
Travel_Direction (дополнительно)	Укажите, нужно ли при поиске ближайшего пункта обслуживания измерять путь от места инцидента до пункта обслуживания или от пункта обслуживания до места инцидента. От пункта обслуживания к инциденту – Направление движения от пунктов обслуживания к инцидентам От инцидента к пункту обслуживания – Направление движения от инцидентов к пунктам обслуживания В зависимости от того, какое значение параметра используется, найденные пункты обслуживания могут различаться, поскольку время езды по некоторым улицам может зависеть от направления движения и односторонних ограничений. Например, объект может располагаться в 10 минутах езды по направлению от инцидента к пункту обслуживания, но в 15 минутах езды при движении от пункта обслуживания до инцидента из-за другого времени в пути. Если вы указываете значение для Времени суток (Time of Day), опции От пункта обслуживания к инциденту (Facility to Incident) и От инцидента к пункту обслуживания (Incident to Facility) также могут дать различные результаты из-за разницы в условиях дорожного движения. Пожарные части, как правило, используют для этого параметра значение От пункта обслуживания к инциденту (Facility to Incident), поскольку их интересует, как быстро они смогут доехать от пожарной части (пункта обслуживания) к месту происшествия (инциденту). Для магазинов розничной торговли (пунктов обслуживания) важнее знать, как быстро покупатели (инциденты) смогут доехать до магазина, поэтому магазины обычно выбирают значение От инцидента к пункту происшествия (Incident to Facility).	String
Use_Hierarchy (дополнительно)	Укажите, должна ли использоваться иерархия при нахождении лучшего маршрута между пунктом обслуживания и инцидентом. Отмечено (Истина) – Использовать иерархию при нахождении маршрутов. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка (такие как скоростные автострады) улицам более низкого порядка (таким как местные дороги), и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным пунктам обслуживания, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае междугородних поездок, поскольку инструмент выбирает лучший маршрут из сравнительно небольшого поднабора улиц. Не отмечено (Ложь) – Не использовать иерархию при нахождении маршрутов. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города. Инструмент автоматически начинает использовать иерархию, если расстояние по прямой между пунктами обслуживания и инцидентами превышает 50 миль, даже если в этом параметре указано иное.	Boolean
Time_of_Day (дополнительно)	Указывает время и дату начала или окончания маршрутов. Значение обозначает время начала или время окончания маршрута в зависимости от значения параметра Использование времени суток (Time of Day Usage) Если вы указываете в качестве значения этого параметра текущие дату и время, инструмент будет использовать при нахождении ближайших пунктов обслуживания текущие условия дорожного движения, и общее время пути будет учитывать условия дорожного движения. Указание времени суток позволяет более точно оценить время езды между инцидентом и пунктом обслуживания, поскольку будут учтены условия дорожного движения в конкретный час и день. Параметр Часовой пояс для времени суток (Time Zone for Time of Day) определяет, как будут указываться время и дата, в UTC или в часовом поясе, в котором находятся пункт обслуживания или инцидент.	Date
Time_of_Day_Usage (дополнительно)	Указывает, является ли значение параметра Время суток (Time of Day) временем отправления или временем прибытия. Время начала (Start Time) – Когда выбрана эта опция, инструмент находит лучший маршрут, принимая значение параметра Время суток (Time of Day) в качестве времени отправления из пункта обслуживания или с места инцидента. Время окончания (End Time) – Когда выбрана эта опция, инструмент принимает значение параметра Время суток (Time of Day) в качестве времени прибытия в пункт обслуживания или на место инцидента. Этот параметр можно использовать для того, чтобы узнать, в какое время необходимо выехать, чтобы прибыть в пункт назначения в момент времени, заданный параметром Время суток (Time of Day).	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. Этот тип барьера называется барьером дополнительной стоимости. Additional_Time: указывает, какое время пути добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения времени. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Measurement Units. Additional_Distance: указывает, какое расстояние добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения расстояния. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Measurement Units.	Feature Set
Line_Barriers (дополнительно)	Укажите одну или несколько линий, которые запрещают передвижение там, где они пересекают улицы. Например, при помощи линейного барьера можно смоделировать маршрут парада или марша протеста, которые препятсвуют движению по нескольким участкам улиц. Линейный барьер может также быстро запретить пересечение нескольких дорог, отделяя, таким образом, возможный маршрут от нежелательных участков уличной сети. Инструмент имеет ограничение числа улиц, которые можно запретить с помощью параметра Line Barriers. Хотя лимита на число линий, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми линиями, не должно превышать 500. При указании линейных барьеров вы можете задать с помощью атрибута свойство имени для каждого из них. Name: имя барьера.	Feature Set
Polygon_Barriers (дополнительно)	Укажите полигоны, которые либо полностью запрещают передвижение, либо пропорционально масштабируют время или расстояние, необходимое для передвижения по улицам, пересекаемым полигоном. Сервис имеет ограничение числа улиц, которые можно запретить с помощью параметра Polygon Barriers. Хотя лимита на число полигонов, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми полигонами, не должно превышать 2,000. При указании полигональных барьеров вы можете задать с помощью атрибутов свойства каждого из них, такие как тип барьера. Для задания свойств полигональных барьеров можно использовать следующие атрибуты: Name: имя барьера. BarrierType: указывает, ограничивает ли барьер перемещение полностью или масштабирует время или расстояние при прохождении по нему. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (Restriction) – запрещает прохождение через любую часть барьера. Этот барьер называется запрещающим полигональным барьером, поскольку он запрещает перемещение по пересекаемым улицам. Одним из применений этого типа барьеров является моделирование наводнений, покрывающих улицы, и перемещение по ним становится невозможным. 1 (Scaled Cost) – масштабирует время или расстояние, необходимое для перемещения по соответствующим улицам на коэффициент, указанный в поле ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера называется полигональным барьером масштабируемой стоимости. Он может использоваться для моделирования погодных условий, из-за которых скорость перемещения в указанных регионах снижается. ScaledTimeFactor: это коэффициент, на который умножается время езды по улицам, пересекающимся с барьером. Это поле действительно только для барьеров с масштабированной стоимостью, и только если используются единицы измерения времени. Значение поля должно быть больше нуля. ScaledDistanceFactor: это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Этот атрибут действителен только для барьеров с масштабированной стоимостью, и только если используются единицы измерения расстояния. Значение атрибута должно быть больше нуля.	Feature Set
Restrictions (дополнительно)	Укажите, какие ограничения должны учитываться инструментом при нахождении наилучшего маршрута между инцидентом и пунктом обслуживания. Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев, ограничения приводят к запрету проезда по дорогам, но они также могут указывать, избегать дорогу или наоборот, предпочесть ее. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для подъезда к инциденту или пункту обслуживания. Ограничение по высоте (Height Restriction) позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено. Ниже приводится список доступных ограничений и их краткое описание. Примечание: Использование некоторых ограничений требует ввода дополнительных значений. Это значение должно быть связано с именем ограничения и определенным параметром, предназначенным для его работы. Вы можете идентифицировать такие ограничения по их названиям, отображающимся под столбцом AttributeName в параметре Attribute Parameter Values. Поле ParameterValue следует использовать в параметре Attribute Parameter Values для правильного использования ограничения при поиске доступных дорог. Примечание: Некоторые ограничения поддерживаются только в определенных странах; их доступность по регионам указана в списке ниже. Кроме доступности ограничений по регионам, можно проверить его доступность в определенной стране по таблице в разделе Список стран на веб-странице Покрытие данными для сервисов сетевого анализа. Если для страны указано значение Yes в столбце Logistics Attribute, ограничение в этой стране поддерживается и доступно для региона. Если вы задаете имена ограничений, которые недоступны в стране, где находятся инциденты, сервис игнорирует их. Сервис также игнорирует ограничения чье значение параметра Использование ограничений находится в пределах от 0 до 1 (см. свойство Значения параметра атрибутов). Он запрещает все ограничения, чье значение параметра Использование ограничения больше 0. Инструмент поддерживает следующие ограничения: Any Hazmat Prohibited (Вредные вещества запрещены) – в маршрут не включаются дороги, по которым запрещена перевозка любых видов опасных веществ. Доступность: Выберите страны в Северной Америке и Европе Avoid Carpool Roads (Избегать дорог для пассажирских перевозок) – в маршрут не будут включаться дороги, предназначенные исключительно для пассажирских перевозок (автобусы и т.д.). Доступность: Все страны Avoid Express Lanes (Избегать скоростных полос) – в маршрут не будут включаться дороги, предназначенные для скоростного передвижения. Доступность: Все страны Avoid Ferries (Избегать паромных переправ) – в маршруте не будут использоваться паромные переправы. Доступность: Все страны Avoid Gates (Избегать ворот) – в маршрут не будут включаться дороги, на которых имеются ворота для въезда по пропуску или охраняемые въезды. Доступность: Все страны Avoid Limited Access Roads (Избегать дорог с ограниченным доступом) – в маршрут не будут включаться дороги с ограниченным доступом. Доступность: Все страны Avoid Private Roads (Избегать частных дорог) – в маршрут не будут включаться частные дороги. Доступность: Все страны Avoid Toll Roads (Избегать платных дорог) – в маршруте не будут использоваться платные дороги. Доступность: Все страны Avoid Unpaved Roads (Избегать дорог без покрытия) – в маршрут не будут включаться дороги без покрытия (например, грунтовые, с гравийным покрытием и т.д.). Доступность: Все страны Axle Count Restriction (Ограничение по числу осей) в маршрут не будут включаться дороги, на которых запрещены грузовики с указанным числом осей. Число осей задается параметром Number of Axles. Доступность: Выберите страны в Северной Америке и Европе Driving a Bus (На автобусе) – в маршрут не будут включаться дороги, по которым запрещено движение автобусов. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Delivery Vehicle (Автотранспорт для доставки) – в маршрут не будут включаться дороги, по которым запрещено движение автотранспорта для доставки. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Taxi (На такси) – в маршрут не будут включаться дороги, по которым запрещено движение такси. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Truck (На грузовике) – в маршрут не будут включаться дороги, по которым запрещено движение грузовиков. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a 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 (в метрах). Доступность: Выберите страны в Северной Америке и Европе 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 (дополнительно)	Укажите дополнительные значения, требуемые для некоторых ограничений, такие как вес транспортного средства для ограничения по весу (Weight Restriction). Вы можете использовать этот параметр, чтобы указать, является ли движение по дорогам, для которых установлено это ограничение, запрещенным, нежелательным или предпочтительным. Если ограничение означает нежелательность или предпочтительность использования дороги, вы можете дополнительно указать с помощью этого параметра степень нежелательности или предпочтительности. Например, вы можете установить для платных дорог правило никогда их не использовать, по возможности избегать или наоборот, отдавать им предпочтение. Если вы задаете параметр Значения атрибутивного параметра (Attribute Parameter Values) из класса пространственных объектов, имена полей класса пространственных объектов должны соответствовать следующим: AttributeName: указывает имя ограничения. ParameterName: указывает имя параметра, связанного с ограничением. В зависимости от целей ограничения, оно может иметь одно или несколько значений поля ParameterName. ParameterValue: значение для ParameterName, используемое инструментом при оценке ограничения. Параметр Значения атрибутивного параметра (Attribute Parameter Values) зависит от параметра Ограничения (Restrictions). Поле ParameterValue применяется, только если значением параметра Ограничения (Restrictions) является имя ограничения. В параметре Значения атрибутивного параметра (Attribute Parameter Values) каждое ограничение (AttributeName) содержит значение поля ParameterName, Использование ограничения (Restriction Usage), определяющее запрет, нежелательность или предпочтительность использования дорог, для которых установлено ограничение, а также степень нежелательности или предпочтительности использования дорог. Поле Использование ограничения (Restriction Usage) 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) – Очень вероятно, что инструмент включит в маршрут дороги с этим ограничением. Как правило для поля Использование ограничения (Restriction Usage) используется значение по умолчанию, PROHIBITED, если ограничение связано с характеристиками транспортного средства, например его высотой. Однако в некоторых случаях значение поля Использование ограничения (Restriction Usage) будет зависеть от ваших предпочтений при выборе маршрута. Например, для ограничения Избегать платных дорог (Avoid Toll Roads) параметр Использование ограничения (Restriction Usage) имеет по умолчанию значение AVOID_MEDIUM. Это означает, что, при наличии данного ограничения инструмент будет по возможности избегать использования платных дорог при построении маршрута. Значение AVOID_MEDIUM также указывает, насколько важно избегать использования платных дорог при поиске лучшего маршрута: это ограничение имеет средний приоритет. При выборе AVOID_LOW исключение платных дорог из маршрута будет иметь меньшее значение, а при выборе AVOID_HIGH – большее, поэтому сервис будет создавать более длинные маршруты, чтобы по возможности избежать использования платных дорог. При выборе PROHIBITED использование платных дорог будет полностью запрещено, и сервис не сможет включать их в маршрут. Следует помнить, что в некоторых случаях целью анализа является прокладка маршрута в обход платных дорог, а в других случаях проезд по платным дорогам может быть предпочтителен, поскольку время, потраченное на движение, более ценно, чем деньги, уплаченные за проезд. В последнем случае для параметра Использование ограничения (Restriction Usage) следует выбрать значения PREFER_LOW, PREFER_MEDIUM или PREFER_HIGH. Чем выше предпочтительность, тем в большей степени маршрут будет проходить по дорогам с этим ограничением.	Record Set
Route_Shape (дополнительно)	Укажите тип объектов маршрута, получаемых на выходе инструмента. Параметр может быть задан с помощью одного из следующих значений: Истинная форма (True Shape) – Возвратить точную геометрию выходного маршрута на основе исходных улиц. Прямая линия (Straight Line) – Возвратить прямую линию между инцидентом и пунктом обслуживания. Нет (None) – Не возвращать геометрию маршрутов. Это значение можно использовать в тех случаях, когда нужно определить только общую продолжительность или протяженность пути между ближайшим пунктом обслуживания и инцидентом. Когда параметр Форма маршрута (Route Shape) имеет значение Истинная форма (True Shape), генерализацией формы маршрута можно дополнительно управлять, выбирая значения параметров Допуск упрощения линии маршрута (Route Line Simplification Tolerance). Независимо от выбранного значения параметра Геометрия маршрута (Route Shape), лучший маршрут определяется всегда на основе минимальной продолжительности или протяженности пути, а не на основе расстояния по прямой между инцидентами и пунктами обслуживания. Это значит, что изменяются только формы маршрута, а не исходные улицы, которые перебирает инструмент при нахождении маршрута.	String
Route_Line_Simplification_Tolerance (дополнительно)	Определяет степень упрощения геометрии выходных линий маршрутов и маршрутых листов. Инструмент игнорирует этот параметр, если значение параметра Форма маршрута (Route Shape) отличается от Истинная форма (True Shape). При упрощении сохраняются важнейшие точки на маршруте, например, повороты и перекрестки, составляющую основную форму маршрута, а остальные точки удаляются. Указываемое вами расстояние упрощения является максимальным допустимым смещением упрощенной линии от исходной. Упрощение линии сокращает количество вершин в геометрии маршрута. Это ускоряет работу инструмента.	Linear unit
Populate_Directions (дополнительно)	Укажите, должен ли инструмент создавать путевой лист для каждого маршрута. Отмечена (Истина) (Checked (True)): Будет создан путевой лист, настроенный в соответствии со значениями параметров Язык путевого листа (Directions Language), Имя стиля путевого листа (Directions Style Name) и Единицы расстояния путевого листа (Directions Distance Units). Не отмечена (Ложь) (Unchecked (False)): Путевой лист не создается, инструмент возвращает пустой слой Directions.	Boolean
Directions_Language (дополнительно)	Укажите язык, на котором должен создаваться путевой лист. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Значениями параметра могут быть следующие двух- или пятисимвольные коды языка: ar – Арабский de – Немецкий en – Английский es – Испанский et – Эстонский fr – Французский he – Иврит it – Итальянский ja – Японский ko – Корейский lt – Литовский lv – Латышский nl – Нидерландский pl – Польский pt-BR – Португальский (Бразилия) pt-PT – Португальский (Португалия) ru – Русский sv – Шведский zh-CN – Упрощенный китайский Если указан неподдерживаемый код языка, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию.	String
Directions_Distance_Units (дополнительно)	Укажите единицы измерения для отображения расстояний в путевом листе. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Мили Километры Метры Футы Ярды Морские мили	String
Directions_Style_Name (дополнительно)	Укажите имя стиля форматирования для путевого листа. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Параметр может принимать следующие значения: NA Desktop: Создает готовый для печати путевой лист от поворота к повороту. NA Navigation: Создает путевой лист со всеми поворотами для автомобильного навигационного устройства.	String
Time_Zone_for_Time_of_Day (дополнительно)	Указывает часовой пояс параметра Время суток (Time of Day). Географически локальное (Geographically Local): Значение параметра Время суток (Time of Day) относится к часовому поясу, в котором находятся пункты обслуживания или инциденты. Если значением параметра Использование времени суток (Time of Day Usage) является Время начала (Start Time), а значением параметра Направление движения (Travel Direction) является От пункта обслуживания к инциденту (Facility to Incident), то это будет часовой пояс пунктов обслуживания. Если значением параметра Использование времени суток (Time of Day Usage) является Время начала (Start Time), а значением параметра Направление движения (Travel Direction) является От инцидента к пункту обслуживания (Incident to Facility), то это будет часовой пояс инцидентов. Если значением параметра Использование времени суток (Time of Day Usage) является Время окончания (End Time), а значением параметра Направление движения (Travel Direction) является От пункта обслуживания к инциденту (Facility to Incident), то это будет часовой пояс инцидентов. Если значением параметра Использование времени суток (Time of Day Usage) является Время окончания (End Time), а значением параметра Направление движения (Travel Direction) является От инцидента к пункту обслуживания (Incident to Facility), то это будет часовой пояс пунктов обслуживания. UTC: Значения параметра Время суток (Time of Day) указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если хотите найти ближайшие пункты обслуживания для конкретного момента времени, например текущего, но не знаете, в каком часовом поясе будут находиться пункты обслуживания или инциденты. Независимо от значения параметра Часовой пояс для времени суток (Time Zone for Time of Day), в случае если ваши пункты обслуживания и инциденты находятся в нескольких часовых поясах, инструмент использует следующие правила: Все инциденты должны быть в одном и том же часовом поясе: при указании начального времени и перемещении от места инцидента к пункту обслуживания; при указании конечного времени и перемещении от пункта обслуживания к месту инцидента. Все пункты обслуживания должны быть в одном и том же часовом поясе: при указании начального времени и перемещении от пункта обслуживания к месту инцидента; при указании конечного времени и перемещении от места инцидента к пункту обслуживания.	String

Пример кода

Пример FindClosestFacilities

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

import arcpy
import time
import sys

username = "<your user name>"
password = "<your password>"
cf_service = "http://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)


#Add the geoprocessing service as a toolbox. Use an alias when importing
arcpy.ImportToolbox(cf_service, "agol")

#Set the variables to call the tool
facilities = r"C:/data/Inputs.gdb/Stores"
incidents = r"C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_directions = "C:/data/output/Results.gdb/Directions"

#Call the tool
result = arcpy.agol.FindClosestFacilities(incidents, facilities, "Minutes", "", 2)

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

#print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    print "An error occured when running the tool"
    print result.getMessages(2)
    sys.exit(2)
elif result_severity == 1:
    print "Warnings were returned when running the tool"
    print result.getMessages(1)
    
#Get the output routes  and save to a local geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(1).save(output_directions)

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

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