Сводка
Определяет области обслуживания сети вокруг пунктов обслуживания. Область обслуживания сети – это регион, охватывающий все улицы, которые могут быть доступны в пределах заданного расстояния или времени пути от одного или более пункта обслуживания. Например, область обслуживания 10-минутной доступности для пункта обслуживания, включает все улицы, которые находятся в пределах 10-минутной досягаемости от этого пункта.
Области обслуживания обычно используются для визуализации и измерения доступности. Например, полигон вокруг продуктового магазина для трехминутного времени езды может определить жителей, которые смогут добраться до магазина в течение трех минут и, скорее всего, будут совершать в нем покупки.
Внимание:
Актуальную информацию об инструменте см. в последней версии раздела веб-справки. ArcGIS Online регулярно выполняет функциональные обновления в сервисах, например, установленная на вашем компьютере справка может устареть.
Более подробно о выходных данных инструмента Создать области обслуживания
Иллюстрация
Использование
Инструменты в наборе инструментов Готовые к использованию - это сервисы геообработки ArcGIS Online, которые используют размещенные в ArcGIS Online данные и возможности анализа.
Инструмент создает области времени пути, если значение параметра Единицы граничных значений задано в единицах времени. Соответственно, инструмент создает области на основе расстояния, если значение параметра Break Units задано в единицах расстояния.
Необходимо указать как минимум один пункт обслуживания. Можно загрузить до 1 000 пунктов обслуживания.
Вы можете добавить до 250 точечных барьеров. Вы можете добавить любое количество линейных или полигональных барьеров, но линейные барьеры не могут пересекать более 500 объектов улиц, а полигональные – более 2000 объектов улиц.
Независимо от того, включен ли параметр Использовать иерархию (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 метров.
При использовании этого сервиса расходуются кредиты. Подробнее см. в разделе Обзор сервисных кредитов.
Синтаксис
arcpy.agolservices.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})
Parameter | Объяснение | Тип данных |
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 совпадают с единицами вашего атрибута импеданса. | 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 Расстояние, которое добавляется при прохождении барьера. Это поле применимо только для барьеров дополнительной стоимости. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Единицы измерения. Additional_Cost Стоимость поездки, которая добавляется при прохождении барьера. Это поле применимо только для барьеров дополнительной стоимости. 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 совпадают с единицами вашего атрибута импеданса. | Feature Set |
Line_Barriers (Дополнительный) | Используйте этот параметр, чтобы указать одну или несколько линий, которые запрещают передвижение там, где они пересекают улицы. Например, при помощи линейного барьера можно смоделировать маршрут парада или марша протеста, которые препятствуют движению по нескольким участкам улиц. Линейный барьер может также быстро запретить пересечение нескольких дорог, отделяя, таким образом, возможный маршрут от нежелательных участков уличной сети. Инструмент накладывает ограничение на количество улиц, которое вы можете ограничить с помощью параметра Линейные барьеры. Хотя лимита на число линий, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми линиями, не должно превышать 500. При указании линейных барьеров вы можете задать свойства имени и типа барьера для каждого из них с помощью атрибутов: Name Имя барьера. | Feature Set |
Polygon_Barriers (Дополнительный) | Используйте этот параметр, чтобы указать полигоны, которые либо полностью запрещают передвижение, либо пропорционально масштабируют время или расстояние, необходимые для передвижения по улицам, пересекаемым полигоном. Сервис накладывает ограничение на количество улиц, которые вы можете ограничить с помощью параметра Полигональные барьеры. Хотя лимита на число линий, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми линиями, не должно превышать 2000. При указании точечных барьеров вы можете задать свойства каждого из них, такие как имя или тип барьера, с помощью атрибутов: Name Имя барьера. BarrierType Указывает, ограничивает ли прохождение через барьер перемещение полностью или масштабирует стоимость перемещения (например время или расстояние). Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
ScaledTimeFactor Это коэффициент, на который умножается время поездки по улицам, пересекающимся с барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабированной стоимости. ScaledDistanceFactor Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабированной стоимости. ScaledCostFactor Это коэффициент, на который умножается стоимость пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля. Это поле применимо только для барьеров масштабированной стоимости. | Feature Set |
Restrictions [Restrictions,...] (Дополнительный) | Ограничения перемещения, которые должны учитываться инструментом при определении зон обслуживания. Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев ограничения запрещают использование тех или иных дорог. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для подъезда к инциденту или пункту обслуживания. Ограничение по высоте позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено. Примечание:Значения, предоставляемые вами для данного параметра, игнорируются за исключением случаев, когда Режим передвижения задан как Пользовательский. Примечание:Использование некоторых ограничений требует ввода дополнительных значений. Это значение должно быть связано с именем ограничения и определенным параметром, предназначенным для его работы. Вы можете идентифицировать такие ограничения по их названиям, отображающимся под столбцом AttributeName в параметре Attribute Parameter Values. Поле ParameterValue следует использовать в параметре Attribute Parameter Values для правильного использования ограничения при поиске доступных дорог. Примечание:Некоторые ограничения поддерживаются только в определенных странах; их доступность по регионам указана в списке ниже. Кроме доступности ограничений по регионам, можно проверить его доступность в определенной стране по таблице в разделе Список стран Покрытия сетевого анализа. Если для страны указано значениеYes в столбце Атрибуты логистики, то будут проверены ограничения, которые есть для всего региона, в котором находится страна. Если вы задаете имена ограничений, которые недоступны в стране, где находятся инциденты, сервис игнорирует их. Сервис также игнорирует ограничения, где значение параметра Использование ограничений находится в пределах от 0 до 1 (см. параметр Значение параметра атрибутов). Он запрещает все ограничения, чье значение параметра Использование ограничения больше 0. Инструмент поддерживает следующие ограничения:
| 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 (Дополнительный) | Указывает часовой пояс или пояса параметра Время суток.
Вне зависимости от значения параметра Часовой пояс для времени суток все пункты обслуживания должны быть в одном часовом поясе, если параметр Время суток имеет ненулевое значение и параметром Полигоны для нескольких пунктов обслуживания задано создание объединенных или неперекрывающихся полигонов. | String |
Travel_Mode (Дополнительный) | Задайте режим передвижения для модели анализа. Режимы передвижения настраиваются в ArcGIS Online и могут изменяться администратором вашей организации в целях лучшего соответствия рабочим процессам вашей организации. Вам требуется указать имя режима передвижения, поддерживаемого вашей организацией. Для получения списка имен поддерживаемых режимов передвижения используйте то же подключение к ГИС-серверу, которое вы использовали для доступа к этому инструменту, и в наборе инструментов Утилиты запустите инструмент GetTravelModes. Инструмент GetTravelModes добавляет в приложение таблицу Поддерживаемых режимов передвижения. В качестве входных данных можно задать любое значение в поле Travel Mode Name таблицы Поддерживаемые режимы передвижения. Вы также можете указать в качестве входного значения значение из поля Travel Mode Settings. Это ускорит выполнение инструмента, поскольку инструмент не будет искать настройки на основании имени режима передвижения. Пользовательский (значение по умолчанию) – позволяет настроить собственный режим передвижения при помощи параметров этого режима (Развороты в соединениях, Использовать иерархию, Ограничения, Значения Параметров атрибутов и Импеданс). Значения по умолчанию для модели параметров пользовательского режима передвижения на легковом автомобиле. Также можно выбрать Пользовательский и задать указанные выше параметры пользовательского режима передвижения для моделирования быстрой пешей ходьбы или передвижения грузового автомобиля с определенными габаритными (по высоте) и весовыми характеристиками, загруженного определенным опасным грузом. Можете попробовать различные настройки для получения нужных вам результатов анализа. После определения настроек анализа вам необходимо связаться с администратором вашей организации и сохранить эти настройки как часть нового или существующего режима передвижения, чтобы любой пользователь вашей организации мог перезапустить анализ с такими же настройками. Внимание:При выборе Пользовательского режима, значения, заданные для его параметров, включаются в анализ. Указание другого режима передвижения, определенного вашей организацией, приведет к тому, что все заданные вами в качестве параметров пользовательского режима передвижения значения будут проигнорированы. Этот инструмент перезапишет их значениями заданного режима передвижения. | String |
Impedance (Дополнительный) | Задайте импеданс - значение, представляющее затраты или стоимость перемещения вдоль сегментов дорог или других частей транспортной сети. Время в пути - это импеданс: для того чтобы проехать 1 милю по пустой дороге, машине может понадобиться минута. Время в пути может зависеть от режима перемещения: ту же милю пешеход пройдет за 20 минут, поэтому важно выбрать правильный импеданс для моделируемого режима. Расстояние перемещения – это импеданс; длина дороги в километрах рассматривается как импеданс. В этом смысле расстояние аналогично для всех режимов – километр останется километром и для пешехода, и для машины. (Что может измениться, так это пути, по которым разрешено перемещаться в различных режимах, что влияет на расстояние между точками и моделируется настройками режима передвижения.) Внимание:Значение, указанное вами для данного параметра, игнорируется, за исключением случаев, когда Режим передвижения задан как Пользовательский, который является значением по умолчанию.
При выборе импеданса на основе времени, такого как TravelTime, TruckTravelTime, Minutes, TruckMinutes или WalkTime,, параметру Единицы граничных значений необходимо задать значение на основе времени. При выборе импеданса на основе расстояния, такого как Мили или Километры, Единицы граничных значений должны быть основаны на расстоянии. Прежние версии:Значения импеданса Время в пути на машине, Время в пути на грузовике, Время в пути пешком и Расстояние пути больше не поддерживаются и будут убраны в следующих версиях. При использовании одного из этих значений инструмент использует значение параметра Импеданс времени для основанных на времени значений и параметра Импеданс расстояния для значений, основанных на расстоянии. | 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 |
Производные выходные данные
Name | Объяснение | Тип данных |
Service_Areas | Предоставляет доступ к полигональным объектам, которые представляют области, которых можно достичь из входных локаций за указанное время передвижения, расстояние перемещения или стоимость поездки. | Набор объектов |
Solve_Succeeded | Определяет, был ли анализ областей обслуживания успешным. | Логическое |
Output_Network_Analysis_Layer | Слой сетевого анализа со свойствами, как настроенные в параметрах инструмента, который может использоваться для дальнейшего анализа или исправления ошибок на карте. | Файл |
Output_Facilities | Предоставляет доступ к атрибутам пунктов обслуживания, которые используются в анализе областей обслуживания. Вы можете использовать атрибуты этого типа данных, например, поле Status, чтобы определить, почему пункт обслуживания не был использован в анализе. | Набор объектов |
Output_Service_Area_Lines | Хранит итоговые области обслуживания как линейные объекты и покрывает улицы или ребра сети, которые могут быть достигнуты за определенное время, на заданном расстоянии или в других предельных значениях стоимости перемещения. Линии являются более достоверным представлением области обслуживания, чем полигоны, поскольку анализ областей обслуживания основывается на измерениях вдоль линий сети. | Набор объектов |
Output_Result_File | Файл .zip, содержащий результаты анализа, с одним или несколькими файлами для каждого результата. Формат отдельного файла задается параметром Выходной формат. | Файл |
Пример кода
Следующий скрипт Python демонстрирует, как использовать инструмент Generate Service Areas в скрипте.
"""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)
В следующем примере показано, как выполнить анализ области обслуживания, используя пользовательский режим передвижения.
"""This example shows how to perform a service area analysis using a custom travel mode
that models trucks carrying wide load."""
import sys
import time
import json
import arcpy
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.
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"
# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")
for attr_param in tt_dict["attributeParameterValues"]:
if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)
# Call the tool
result = arcpy.GenerateServiceAreas_ServiceAreas(facilities, "5 10 15", "Minutes", Travel_Mode=travel_mode)
# 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)