Сводка
Определяет области обслуживания сети вокруг пунктов обслуживания. Область обслуживания сети – это регион, охватывающий все улицы, которые могут быть доступны в пределах заданного расстояния или времени пути от одного или более пункта обслуживания. Например, область обслуживания 10-минутной доступности для пункта обслуживания, включает все улицы, которые находятся в пределах 10-минутной досягаемости от этого пункта.
Области обслуживания обычно используются для визуализации и измерения доступности. Например, полигон вокруг продуктового магазина для трехминутного времени езды может определить жителей, которые смогут добраться до магазина в течение трех минут и, скорее всего, будут совершать в нем покупки.
Более подробно о выходных данных инструмента GenerateServiceAreas
Иллюстрация
Использование
Инструмент создает области времени пути, если значение параметра Единицы граничных значений задано в единицах времени. Соответственно, инструмент создает области на основе расстояния, если значение параметра Break Units задано в единицах расстояния.
Необходимо указать как минимум один пункт обслуживания. Можно загрузить до 1 000 пунктов обслуживания.
Вы можете добавить до 250 точечных барьеров. Вы можете добавить любое количество линейных или полигональных барьеров, но линейные барьеры не могут пересекать более 500 объектов-улиц, а полигональные – более 2 000 объектов.
Вы можете использовать иерархию дорог, что позволит получить результаты быстрее, но полученное решение может быть менее точным.
Независимо от того, включен ли параметр Use Hierarchy (True), иерархия всегда используется, если максимальное граничное значение превышает 240 минут или 240 миль (386,24 км). Если выходные области обслуживания не перекрываются и генерализованы, это ограничение сокращается до 15 минут и 15 миль (24,14 километров).
Если расстояние между входной точкой и ближайшей проезжей улицей больше 12,42 миль (20 км), точка исключается из анализа.
Время в пути не может превышать 9 часов (540 минут) при передвижении пешком или 5 часов (300 минут) для других режимов передвижения.
Расстояние в пути не может превышать 27 миль (43,45 километра) при передвижении пешком или 300 миль (482,80 километра) для других режимов передвижения.
При движении пешком максимальное время в пути при создании детальных полигонов не может превышать 5 часов (300 минут). Для остальных режимов передвижения максимальное время в пути не может быть больше 15 минут.
Для всех режимов передвижения, включая движение пешком, максимальное расстояние в пути при создании детальных полигонов не может быть больше 15 миль (24,14 километра).
При движении пешком максимальное время в пути при создании линий области обслуживания не может превышать 5 часов (300 минут). Для остальных режимов передвижения максимальное время в пути не может быть больше 15 минут.
Для всех режимов передвижения, включая движение пешком, максимальное расстояние в пути при создании линий области обслуживания не может быть больше 15 миль (24,14 километра).
Расстояние отсечения полигона не может превышать 500 метров.
Данный инструмент предназначен для работы в , ArcGIS Pro, ArcMap, ArcGlobe и ArcScene, но не в ArcCatalog.
При использовании этого сервиса расходуются кредиты. Подробнее см. в разделе Обзор сервисных кредитов.
Синтаксис
arcpy.naagol.GenerateServiceAreas(Facilities, Break_Values, Break_Units, {Analysis_Region}, {Travel_Direction}, {Time_of_Day}, Use_Hierarchy, {UTurn_at_Junctions}, {Polygons_for_Multiple_Facilities}, {Polygon_Overlap_Type}, {Detailed_Polygons}, {Polygon_Trim_Distance}, Polygon_Simplification_Tolerance, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Polygon_Detail}, {Output_Type}, {Output_Format}, {Ignore_Invalid_Locations})
Параметр | Объяснение | Тип данных |
Facilities |
Входные местоположения, вокруг которых создаются области обслуживания. Можно загрузить до 1 000 пунктов обслуживания. Набор объектов-пунктов обслуживания имеет связанную таблицу атрибутов. Поля в таблице атрибутов описаны ниже. ObjectID Управляемое системой поле ID. Name Имя пункта обслуживания. Если имя не задано, оно будет автоматически создано во время расчета. Все поля из входных пунктов обслуживания включаются в выходные полигоны, когда для параметра Полигоны для нескольких пунктов обслуживания задано значение Перекрытие или Нет перекрытий. Поле ObjectID из входных пунктов обслуживания переносится в поле FacilityOID выходных полигонов. Breaks Определяет экстент области обслуживания, которая будет вычислена для каждого пункта обслуживания. Этот атрибут позволяет указать различные граничные значения области обслуживания для каждого пункта. Например, при наличии двух пунктов обслуживания это значит, что можно создать полигоны областей обслуживания 5- и 10-минутной доступности для одного пункта обслуживания и 6-, 9- и 12-минутной доступности – для другого. Разделите несколько значений границ пробелом и укажите числовые значения, используя символ точки в качестве десятичного разделителя, даже если языковой стандарт вашего компьютера определяет другой десятичный разделитель. Например, значения 5.5 10 15.5 задает три значения границ вокруг пункта обслуживания. AdditionalTime Количество времени, проведенное на пункте обслуживания, которое уменьшает площадь области обслуживания, рассчитанной для данного объекта. По умолчанию значение равно 0. Например, при вычислении областей обслуживания, отражающих время реагирования пожарной станции на вызов, в AdditionalTime может храниться время выезда для каждой из пожарных станций (то есть время, которое требуется пожарной команде на то, чтобы надеть соответствующее защитное оборудование и выехать с пожарной станции). Предположим, у пожарной станции 1 время выезда равно 1 минуте, а у пожарной станции 2 – 3 минутам. При вычислении области обслуживания 5-минутной доступности для обеих пожарных частей, фактическая область обслуживания для станции 1 будет составлять 4 минуты (поскольку одну из пяти минут займет время выезда). Подобным образом у пожарной станции 2 область обслуживания будет составлять всего 2 минуты от пожарной части. AdditionalDistance Дополнительное расстояние, которое нужно преодолеть для достижения пункта обслуживания перед вычислением области. Этот атрибут сокращает экстент области обслуживания, которая вычисляется для заданного пункта. По умолчанию значение равно 0. Обычно пункт обслуживания, например, пожарная часть, находится не на самой улице, а на некотором удалении от проезжей части. Значение этого атрибута может использоваться для учета расстояния между действительным местоположением пункта обслуживания и его положением на улице, если важно включать это расстояние при расчете областей обслуживания для пункта обслуживания. AdditionalCost Дополнительная стоимость, потраченная на пункте обслуживания, которая уменьшает экстент области обслуживания, рассчитанной для данного объекта. По умолчанию значение равно 0. Используйте это значение атрибута, когда режим передвижения для анализа использует атрибут импеданса, который не основывается ни на времени, ни на расстоянии. Единицы измерения для этих атрибутивных значений будут интерпретироваться как неизвестные. CurbApproach указывает направление, в котором транспортное средство может подъехать и отъехать от пункта обслуживания. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
Атрибут 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 |
Break_Values | Определяет размер и число полигонов области обслуживания, которые нужно создать для каждого пункта обслуживания. Единицы определяются Единицами граничных значений. Для создания концентрических областей обслуживания для каждого пункта обслуживания можно использовать несколько границ полигонов. Например, чтобы определить области обслуживания для одного пункта обслуживания с расстоянием 2, 3 и 5 миль, введите 2 3 5, используя пробел в качестве разделителя, и установите для Единицы граничных значений значение Мили. На количество указываемых граничных значений ограничений нет. Размер максимального граничного значения не может превышать 300 минут или 300 миль (482,80 километров). При создании полигонов с детальной геометрией для максимального размера области обслуживания действует ограничение в 15 минут и 15 миль (24,14 километров). | String |
Break_Units | Задает единицы для параметра Граничные значения. Единицы, выбранные для этого параметра, определяют, будет ли инструмент создавать области обслуживания на основе расстояния или времени пути. Выберите единицу времени для измерения продолжительности пути. Для измерения протяженности пути выберите единицу расстояния. Ваш выбор также определяет единицы измерения, которые инструмент будет использовать также для указания общей продолжительности или протяженности пути в результатах. Возможный выбор:
| String |
Analysis_Region (Дополнительный) | Регион, в котором будет выполняться анализ. Если значение этого параметра не указано, инструмент автоматически вычислит имя региона на основе местоположения входных точек. Задание имени региона необходимо только в случае, если для ваших входных данных не подходит автоматическое определение названия региона. Чтобы задать регион используйте одно из следующих значений:
| String |
Travel_Direction (Дополнительный) | Задает направление перемещения, используемое для создания полигонов области обслуживания, по направлению к пунктам обслуживания или от них.
Направление перемещения может изменять форму полигонов, так как импедансы противоположных сторон улиц могут отличаться, или могут применяться другие ограничения, например, улицы могут быть с односторонним движением. Выбираемое направление зависит от характера анализа областей обслуживания в конкретном случае. Область обслуживания для службы доставки пиццы, например, может быть создана с учетом пути от пункта обслуживания, а область обслуживания больницы должна быть создана с учетом пути к пункту обслуживания. | String |
Time_of_Day (Дополнительный) | Время отправления или прибытия для пункта обслуживания. Интерпретация этого значения зависит от того, какое направление движения задано – от пункта обслуживания или к нему.
Вы можете задать с помощью параметра Часовой пояс для времени суток (Time Zone for Time of Day), как будут указываться время и дата, в UTC или в часовом поясе, в котором находятся пункт обслуживания. Повторяя один и тот же анализ, но с разными значениями Времени суток, можно увидеть, как изменяется доступность пункта обслуживания с течением времени. Например, пятиминутная область обслуживания вокруг пожарной части может быть большой рано утром, затем уменьшаться в утренний час пик, снова увеличиваться и т.д. | Date |
Use_Hierarchy | Определяет, должна ли использоваться иерархия при нахождении лучшего маршрута между пунктом обслуживания и инцидентом.
Независимо от того, включен ли параметр Использовать иерархию (True), иерархия всегда используется, если максимальное граничное значение превышает 240 минут или 240 миль (386.24 километров). | Boolean |
UTurn_at_Junctions (Дополнительный) | Указывает, следует ли ограничивать или разрешать зоне обслуживания делать развороты в соединениях. Чтобы лучше разобраться в значениях параметров, рассмотрим следующую терминологию: соединение – это точка, где один участок улицы заканчивается и потенциально может соединяться с одним или несколькими другими сегментами; псевдо-соединение – это точка, в которой две улицы точно соединяются друг с другом; пересечение – это точка соединения трех или более улиц; а тупик – точка, в которой заканчивается один сегмент улицы, не соединяясь с другими.
| String |
Polygons_for_Multiple_Facilities (Дополнительный) | Указывает способ создания полигонов областей обслуживания в случае наличия в анализе нескольких пунктов обслуживания.
При использовании значений Перекрытие и Нет перекрытий, все поля из входных пунктов обслуживания включаются в выходные полигоны, с тем исключением, что значения из входного поля ObjectID переносятся в поле FacilityOID выходных полигонов. При объединении по граничным значениям полю FacilityOID присваивается значение null, а входные поля не переносятся в выходные. | String |
Polygon_Overlap_Type (Дополнительный) | Определяет, будут ли концентрические полигоны областей обслуживания создаваться в виде дисков или колец. Этот параметр применяется только при задании нескольких граничных значений для пунктов обслуживания.
| String |
Detailed_Polygons (Дополнительный) | Определяет параметр создания генерализованных или детализированных полигонов.
Инструмент поддерживает генерацию подробных полигонов, только если максимальное указанное значение параметра Граничные значения меньше или равно 15 минутам 15 милям (24,14 км). | Boolean |
Polygon_Trim_Distance (Дополнительный) | Расстояние, в пределах которого сокращаются полигоны области обслуживания. Это удобно при поиске областей обслуживания в местах с редкой сетью дорог, когда вы не хотите, чтобы область охватывала район, в котором нет дорог. По умолчанию задано значение 100 метров. Отсутствие значения или значение 0 для данного параметра означает, что полигоны области обслуживания не будут обрезаться. При использовании иерархии значение этого параметра игнорируется. | Linear Unit |
Polygon_Simplification_Tolerance | Степень упрощения геометрии полигона. Упрощение не затрагивает важнейшие вершины полигона, для сохранения исходной формы, и удаляет все остальные вершины. Указываемое расстояние упрощения является максимальным допустимым смещением упрощенных границ по отношению к исходным. Упрощение полигона уменьшает количество вершин и приводит к сокращению времени отработки. | Linear Unit |
Point_Barriers (Дополнительный) |
Используйте этот параметр для указания одной или нескольких точек, действующих в качестве временных ограничений или представляющих дополнительное время или расстояние, которые могут потребоваться для передвижения по улицам. Например, точечный барьер может быть использован для обозначения упавшего дерева или для ввода времени ожидания на железнодорожном переезде. Инструмент может накладывать до 250 ограничений, точек, добавленных в качестве барьеров. При указании точечных барьеров вы можете задать свойства каждого из них, такие как имя или тип барьера, с помощью атрибутов: Name Имя барьера. BarrierType Указывает, ограничивает ли точечный барьер перемещение полностью или добавляет время или расстояние при его пересечении. Значение этого атрибута указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
Additional_Time Время поездки, которое добавляется при прохождении барьера. Это поле применимо только для барьеров с добавленной стоимостью и когда значение параметра Единицы измерения основано на времени. Значение этого поля должно быть больше или равно нулю, а его единицы измерения должны соответствовать заданным в параметре Единицы измерения. Additional_Distance Расстояние, которое добавляется при прохождении барьера. Это поле применимо только для барьеров с добавленной стоимостью и когда значение параметра Единицы измерения основано на расстоянии. Значение этого поля должно быть больше или равно нулю, а его единицы измерения должны соответствовать заданным в параметре Единицы измерения. AdditionalCost Стоимость поездки, которая добавляется при прохождении барьера. Это поле применимо только для барьеров с добавленной стоимостью, когда значение параметра Единицы измерения не основано ни на времени, ни на расстоянии. FullEdge Указывает, как ограничительные точечные барьеры применяются к элементам ребер во время анализа. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
CurbApproach Указывает направление движения, на которое влияет барьер. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
Так как соединения являются точками и не имеют сторон, барьеры на соединениях влияют на все транспортные средства независимо от стороны подъезда. Атрибут 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 Указывает, ограничивает ли прохождение через барьер перемещение полностью или масштабирует стоимость перемещения (например время или расстояние). Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
ScaledTimeFactor Это коэффициент, на который умножается время поездки по улицам, пересекающимся с барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабируемой стоимости и только в том случае, если режим передвижения, используемый для анализа, использует атрибут импеданса, основанный на времени. ScaledDistanceFactor Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабируемой стоимости и только в том случае, если режим передвижения, используемый для анализа, использует атрибут импеданса, основанный на расстоянии. ScaledCostFactor Это коэффициент, на который умножается стоимость пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабируемой стоимости и только в том случае, если режим передвижения, используемый для анализа, использует атрибут импеданса, основанный ни на времени, ни на расстоянии. | Feature Set |
Restrictions [Restrictions,...] (Дополнительный) | Ограничения на поездки, которые будут соблюдаться инструментом при определении зон обслуживания. Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев ограничения запрещают использование тех или иных дорог. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для подъезда к инциденту или пункту обслуживания. Ограничение по высоте позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено. Инструмент поддерживает следующие ограничения:
| String |
Attribute_Parameter_Values (Дополнительный) | Используйте этот параметр для указания дополнительных значений, требуемых атрибутом или ограничением, например для указания того, применяется ли ограничение как полный или рекомендуемый запрет либо как предпочтение путешествовать по дорогам с ограниченным движением. Если ограничение означает нежелательность или предпочтительность использования дороги, вы можете дополнительно указать с помощью этого параметра степень нежелательности или предпочтительности. Например, вы можете установить для платных дорог правило никогда их не использовать, по возможности избегать или наоборот, отдавать им предпочтение. Если вы задаете параметр Значения атрибутивного параметра из класса пространственных объектов, имена полей класса пространственных объектов должны соответствовать следующим:
Параметр Значения Параметра атрибутов зависит от параметра Ограничения. Поле ParameterValue применяется, только если в качестве значения параметра Ограничения указано имя ограничения. В параметре Значения Параметра атрибутов каждое ограничение (указанное, как AttributeName) содержит значение поля ParameterName, Использование ограничения, определяющее запрет, нежелательность или предпочтительность использования дорог, для которых установлено ограничение, а также степень нежелательности или предпочтительности использования дорог. Поле Использование ограничения ParameterName может иметь одно из следующих строковых значений или эквивалентных числовых значений, указанных в скобках:
Как правило, для поля Использование ограничения используется значение по умолчанию, PROHIBITED, если ограничение связано с характеристиками транспортного средства, например, с его высотой. Однако в некоторых случаях значение поля Использование ограничения будет зависеть от ваших предпочтений при выборе маршрута. Например, для ограничения Избегать платных дорог параметр Использование ограничения имеет по умолчанию значение AVOID_MEDIUM. Это означает, что, при наличии данного ограничения инструмент будет по возможности избегать использования платных дорог при построении маршрута. Значение AVOID_MEDIUM также указывает, насколько важно избегать использования платных дорог при поиске лучшего маршрута: это ограничение имеет средний приоритет. При выборе AVOID_LOW исключение платных дорог из маршрута будет иметь меньшее значение, а при выборе AVOID_HIGH – большее, поэтому сервис будет создавать более длинные маршруты, чтобы по возможности избежать использования платных дорог. При выборе PROHIBITED использование платных дорог будет полностью запрещено, и сервис не сможет включать их даже частично в маршрут. Имейте в виду, что в некоторых ситуациях важно избежать или запретить платные дороги, чтобы избежать платы за проезд. И наоборот, другие предпочитают ездить по платным дорогам, потому что движение без пробок для них более ценно, чем деньги, потраченные на платные дороги. В последнем случае для параметра Использование ограничения следует выбрать значения PREFER_LOW, PREFER_MEDIUM или PREFER_HIGH. Чем выше предпочтительность, тем в большей степени маршрут будет проходить по дорогам с этим ограничением. | Record Set |
Time_Zone_for_Time_of_Day (Дополнительный) | Указывает часовой пояс или пояса параметра Время суток (Time of Day).
Вне зависимости от значения параметра Часовой пояс для времени суток, все пункты обслуживания должны быть в одном часовом поясе, когда параметр Время суток имеет ненулевое значение, и параметром Полигоны для нескольких пунктов обслуживания задано создание объединенных или неперекрывающихся полигонов. | String |
Travel_Mode (Дополнительный) | Задайте режим передвижения для модели анализа. Режимы передвижения настраиваются в ArcGIS Online и могут изменяться администратором вашей организации в целях лучшего соответствия рабочим процессам вашей организации. Вам требуется указать имя режима передвижения, поддерживаемого вашей организацией. Для получения списка имен поддерживаемых режимов передвижения используйте то же подключение к ГИС-серверу, которое вы использовали для доступа к этому инструменту, и в наборе инструментов Утилиты запустите инструмент GetTravelModes. Инструмент GetTravelModes добавляет в приложение таблицу Поддерживаемых режимов передвижения. В качестве входных данных можно задать любое значение в поле Travel Mode Name таблицы Поддерживаемые режимы передвижения. Вы также можете указать в качестве входного значение из поля Travel Mode Settings. Это ускорит выполнение инструмента, поскольку инструмент не будет искать настройки на основании имени режима передвижения. Пользовательский (значение по умолчанию) – позволяет настроить собственный режим передвижения при помощи параметров этого режима (Развороты в соединениях, Использовать иерархию, Ограничения, Значения Параметров атрибутов и Импеданс). Значения по умолчанию для модели параметров пользовательского режима передвижения на легковом автомобиле. Также можно выбрать Пользовательский и задать указанные выше параметры пользовательского режима передвижения для моделирования быстрой пешей ходьбы или передвижения грузового автомобиля с определенными габаритными (по высоте) и весовыми характеристиками, загруженного определенным опасным грузом. Можете попробовать различные настройки для получения нужных вам результатов анализа. После определения настроек анализа вам необходимо связаться с администратором вашей организации и сохранить эти настройки как часть нового или существующего режима передвижения, чтобы любой пользователь вашей организации мог перезапустить анализ с такими же настройками. | String |
Impedance (Дополнительный) | Задайте импеданс – значение, представляющее затраты или стоимость перемещения вдоль сегментов дорог или других частей транспортной сети. Время в пути - это импеданс: для того чтобы проехать 1 милю по пустой дороге, машине может понадобиться минута. Время в пути может зависеть от режима перемещения: ту же милю пешеход пройдет за 20 минут, поэтому важно выбрать правильный импеданс для моделируемого режима. Расстояние перемещения – это импеданс; длина дороги в километрах рассматривается как импеданс. В этом смысле расстояние аналогично для всех режимов – километр останется километром и для пешехода, и для машины. (Что может измениться, так это пути, по которым разрешено перемещаться в различных режимах, что влияет на расстояние между точками и моделируется настройками режима передвижения.)
При выборе импенданса на основе времени, такого как TravelTime, TruckTravelTime, Minutes, TruckMinutes или WalkTime, параметру Единицы граничных значений необходимо задать значение на основе времени; при выборе импеданса на основе расстояния, такого как Miles, Kilometers, Единицы граничных значений должны быть основаны на расстоянии. | String |
Save_Output_Network_Analysis_Layer (Дополнительный) | Указывает, будут ли параметры анализа сохранены в виде файла слоя сетевого анализа. Вы не можете работать с этим файлом напрямую, даже если вы откроете его в приложении ArcGIS Desktop, например, в ArcMap. Это предназначено для отправки в техническую поддержку Esri для диагностики качества результатов, получаемых инструментом.
| Boolean |
Overrides (Дополнительный) | Задает дополнительные опции, которые смогут повлиять на выполнение расчета, если будут найдены решения для задач сетевого анализа. Значение этого параметра должно быть задано в JavaScript Object Notation (JSON). К примеру, корректным значением является следующее: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми. Значение по умолчанию является пустым, что означает отсутствие замещения каких-либо настроек расчета. Замещения - дополнительные настройки, которые должны применяться только по итогам выполнения тщательного анализа результатов, которые будут получены до и после применения таких настроек. Чтобы получить список поддерживаемых параметров переопределения для каждого расчета и их допустимых значений, обратитесь в службу технической поддержки Esri. | String |
Time_Impedance (Дополнительный) | Импеданс на основе времени - это значение, которое задает время перемещения вдоль сегментов дорог или других частей транспортной сети.
| String |
Distance_Impedance (Дополнительный) | Импеданс на основе расстояния - это значение, которое задает расстояние перемещения вдоль сегментов дорог или других частей транспортной сети.
| String |
Polygon_Detail (Дополнительный) | Задает уровень детализации выходных полигонов.
Если ваш анализ охватывает городские территории с сетевой структурой улиц, разница между генерализованными и стандартными полигонами будет небольшой. Однако для горных и сельских дорог стандартные или детализированные полигоны могут представлять существенно более точные результаты, чем генерализованные. Инструмент поддерживает генерацию полигонов высокой точности, только если максимальное указанное значение параметра Граничные значения меньше или равно 15 минутам или 15 милям (24,14 км). | String |
Output_Type (Дополнительный) | Задает количество выходных объектов. Выходные области обслуживания могут быть линейными объектами, представляющими дороги, доступными без нарушения предельных значений, или полигональными объектами, охватывающими эти линии (представляющими доступную область).
| String |
Output_Format (Дополнительный) | Определяет формат, в котором будут созданы выходные объекты.
Если указан формат выхода на основе файла, такой как файл JSON или файл GeoJSON, выходные данные не будут добавлены к отображению, потому что приложение, такое как ArcMap или ArcGIS Pro, не может отобразить содержание файла результатов. Напротив, файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в истории геообработки на панели проект. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки. | String |
Ignore_Invalid_Locations (Дополнительный) | Указывает, будут ли игнорироваться неверные входные местоположения.
| Boolean |
Производные выходные данные
Имя | Объяснение | Тип данных |
Service_Areas | Предоставляет доступ к полигональным объектам, которые представляют области, которых можно достичь из входных локаций за указанное время передвижения, расстояние перемещения или стоимость поездки. | Feature Set |
Solve_Succeeded | Определяет, был ли анализ областей обслуживания успешным. | Boolean |
Output_Network_Analysis_Layer | Слой сетевого анализа со свойствами, как настроенные в параметрах инструмента, который может использоваться для дальнейшего анализа или исправления ошибок на карте. | File |
Output_Facilities | Предоставляет доступ к атрибутам пунктов обслуживания, которые используются в анализе областей обслуживания. Вы можете использовать атрибуты из этого типа данных, например, поле Status, чтобы определить, почему пункт обслуживания не был использован при анализе. | Feature Set |
Output_Service_Area_Lines | Хранит итоговые области обслуживания как линейные объекты и покрывает улицы или ребра сети, которые могут быть достигнуты за определенное время, на заданном расстоянии или в других предельных значениях стоимости перемещения. Линии являются более достоверным представлением области обслуживания, чем полигоны, поскольку анализ областей обслуживания основывается на измерениях вдоль линий сети. | Feature Set |
Output_Result_File | Файл .zip, содержащий результаты анализа с одним или несколькими файлами для каждого выхода. Формат отдельного файла задается параметром Выходной формат. | File |
Output_Network_Analysis_Layer_Package | Пакет слоев, который включает слой сетевого анализа с данными и настройками, используемыми в анализе. | File |
Пример кода
GenerateServiceAreas, пример (автономный скрипт)
Следующий скрипт Python демонстрирует, как использовать инструмент GenerateServiceAreas в скрипте.
"""This example shows how to generate 5, 10, 15 minute drive time areas around facilities."""
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>"
sa_service = "https://logistics.arcgis.com/arcgis/services;World/ServiceAreas;{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(sa_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
output_service_areas = "C:/data/Results.gdb/StoreServiceAreas"
# Call the tool
result = arcpy.GenerateServiceAreas_ServiceAreas(facilities, "5 10 15", "Minutes")
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))
# Store the output drive time polygons to a geodatabase
result.getOutput(0).save(output_service_areas)
Параметры среды
Этот инструмент не использует параметры среды геообработки