Создать области обслуживания (Generate Service Areas) (Network Analyst)
Резюме
Создает слой сетевого анализа области обслуживания, устанавливает свойства анализа и выполняет данный анализ. Данный инструмент идеально подходит для настройки области обслуживания сервиса геообработки в Интернет. Область обслуживания сети – это регион, охватывающий все улицы, которые могут быть доступны в пределах заданного расстояния или времени пути от одного или более пунктов обслуживания.
Области обслуживания обычно используются для визуализации и измерения доступности. Например, полигон трехминутного времени в пути вокруг продуктового магазина может определить жителей, которые смогут добраться до магазина в течение трех минут и, скорее всего, будут совершать в нем покупки.
Примечание:Инструменты Создать области обслуживания (Generate Service Areas) и Создать слой области обслуживания (Make Service Area Layer) похожи, но предназначены для различных целей. Используйте инструмент Создать области обслуживания (Generate Service Area) при настройке сервиса геообработки; это упростит процесс настройки. В противном случае используйте Создать слой области обслуживания (Make Service Area Layer). Также используйте инструмент Создать слой области обслуживания (Make Service Area Layer) при необходимости создать линии области обслуживания; Создать области обслуживания (Generate Service Area) не предоставляет функции для создания линий.
Для создания сервиса геообработки области обслуживания с использованием Создать области обслуживания (Generate Service Area) вам необходимо только настроить один инструмент и опубликовать инструмент напрямую, как сервис. Иначе вам необходимо создать модель при помощи Создать слой области обслуживания (Make Service Area Layer), правильно подключить ее к различным другим инструментам и опубликовать модель для создания сервиса геообработки области обслуживания.
Для получения информации о настройке сервиса полигона времени в пути с использованием учебных данных, см. Пример сервиса геообработки: полигоны времени в пути.
Использование
В диалоговом окне инструмента различные дополнительные параметры группируются в следующие шесть категорий, что облегчает управление ими:
- Дополнительный анализ
- Барьеры
- Набор сетевых данных
- Сетевые положения
- Создание полигонов
- Возможности сервиса
Более подробно о выходных данных инструмента Создать области обслуживания (Generate Service Areas)
Синтаксис
| Параметр | Объяснение | Тип данных |
Facilities |
Пункты обслуживания, вокруг которых создаются области обслуживания. Набор объектов пунктов обслуживания имеет три атрибута: ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, указывающее на географическое положение объекта сетевого анализа. Name: Имя пункта обслуживания. Если имя не задано, пустое или NULL, то оно автоматически создается во время решения. | Feature Set |
Break_Values |
Определяет размер и количество полигонов области обслуживания, которые будут созданы для каждого пункта обслуживания. Единицы определяются значением Единицы разрывов (Break Units). При запуске инструмента Создать области обслуживания (Generate Service Areas) происходит примечательное взаимодействие между следующими параметрами: Граничные значения (Break Values), Единицы разрывов (Break Units), а также Атрибут времени (Time Attribute) или Атрибут расстояния (Distance Attribute). При этом Граничные значения (Break Values) и Единицы разрывов (Break Units) определяют время или расстояние распространения области обслуживания вокруг пункта или пунктов обслуживания. Каждый из параметров Атрибут времени (Time Attribute) и Атрибут расстояния (Distance Attribute) определяет один атрибут сетевой стоимости. При этом используется только один из этих атрибутов стоимости, выбранный механизмом расчета атрибут соответствует значению Единицы разрывов (Break Units). Это означает, что, если вы указываете основанное на времени значение Единицы разрывов (Break Unit), например, в секундах или минутах, инструмент выполняет расчет с использованием атрибута стоимости, определенного в параметре Атрибут времени (Time Attribute). Когда вы указываете основанное на расстоянии значение Единицы разрывов (Break Unit), например, в километрах или милях, то используется атрибут стоимости, определенный в параметре Атрибут расстояния (Distance Attribute). Для создания концентрических областей для пунктов обслуживания можно использовать несколько полигональных границ. Например, чтобы определить области обслуживания для одного пункта обслуживания с расстоянием 2, 3 и 5 миль, введите "2 3 5", разделяя значения пробелом. Задайте для параметра Единицы разрывов (Break Units) значение Мили (Miles), убедитесь, что вы выбрали сетевой атрибут на основании расстояния для параметра Атрибут расстояния (Distance Attribute). | String |
Break_Units |
Единицы для параметра Граничные значения (Break Values)
Инструмент Создать области обслуживания (Generate Service Areas) выбирает, какой сетевой атрибут стоимости использовать: указанный в параметре Атрибут времени (Time Attribute), или в Атрибуте расстояния (Distance Attribute), в зависимости от того, какие единицы вы выбрали – на основании времени или расстояния. Инструмент выполняет необходимые преобразования единиц в том случае, если значение Единиц разрывов (Break Units) отличается от единиц соответствующего атрибута стоимости времени или расстояния. | String |
Network_Dataset |
Набор сетевых данных, для которого выполняется анализ области обслуживания. Набор сетевых данных должен содержать хотя бы один атрибут стоимости, основанный на времени, и один, основанный на расстоянии. | Network Dataset Layer |
Service_Areas |
Выходная рабочая область и имя выходных объектов. Рабочая область должна уже существовать. Выходная рабочая область по умолчанию: in_memory. | Feature Class |
Travel_Direction (дополнительно) |
Выберите направление перемещения, используемое для создания полигонов области обслуживания: к пунктам обслуживания или от них.
Направление перемещения может изменять форму полигонов, так как импедансы противоположных сторон улиц могут отличаться, или могут существовать улицы с односторонним движением. Выбираемое направление зависит от характера анализа областей обслуживания в конкретном случае. Область обслуживания для службы доставки пиццы, например, должна быть создана с учетом пути от пункта обслуживания, а область обслуживания больницы должна быть создана с учетом пути к пункту обслуживания, так как время доставки пациента в больницу является критическим. | String |
Time_of_Day (дополнительно) |
Время отправления или прибытия для пункта обслуживания. Интерпретация этого значения зависит от того, какое направление движения задано – от пунктов обслуживания или к ним.
Чтобы данный параметр вступил в силу, ваш набор сетевых данных должен включать данные трафика. Повторяя один и тот же анализ, но с разными значениями времени суток, можно увидеть, как изменяется доступность пункта обслуживания с течением времени. Например, пятиминутная область обслуживания вокруг пожарной части может быть большой рано утром, затем уменьшаться в часы пик, снова увеличиваться и т. д. | Date |
UTurn_Policy (дополнительно) |
Правила разворота на соединениях. При разрешении U-образных разворотов неявно предполагается, что механизм расчета может развернуться на соединении и продолжить движение по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Для соответствия, параметр правил разворотов в неявном виде указывает количество ребер, участвующих в соединении, что представляет собой валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения.
 Подсказка:При необходимости более точного определения правил разворотов, рассмотрите возможность добавления оценки задержек на универсальных поворотах к атрибуту сетевой стоимости или настройки его параметров, если таковой существует, а также обратите особое внимание на конфигурацию обратных поворотов. Кроме того, ознакомьтесь с заданным свойством CurbApproach для ваших сетевых положений. | String |
Point_Barriers (дополнительно) | Определяет точечные барьеры, которые разделены на два типа: ограничения и дополнительной стоимости. Они временно ограничивают прохождение по сети или добавляют импеданс к точкам сети. Точечные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для точечных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов и их описания. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. BarrierType: Указывает, ограничивает ли барьер перемещение полностью или добавляет стоимость при прохождении через него. Существует две опции:
Используйте значение 0 для параметра Ограничение (Restriction) и 2 для параметра Дополнительная стоимость (Added Cost) AdditionalCost: AdditionalCost показывает величину импеданса, добавляемую при прохождении области обслуживания через барьер. Единица для данного поля аналогичная единицам, используемым для Единиц разрывов (Break Units). | Feature Set |
Line_Barriers (дополнительно) |
Определяет линейные барьеры, которые временно ограничивают прохождение через них. Линейные барьеры определяются набором объектов. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. | Feature Set |
Polygon_Barriers (дополнительно) | Определяет полигональные барьеры, которые разделены на два типа: ограничения и полигональные барьеры масштабированной стоимости. Они временно ограничивают перемещение или масштабируют импеданс в покрываемых ими частях сети. Полигональные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для полигональных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. BarrierType: Указывает, ограничивает ли барьер перемещение полностью или масштабирует стоимость прохождения через него. Существует две опции:
Используйте значение 0 для параметра Ограничение (Restriction) и 1 для параметра Масштабированная стоимость (Scaled Cost) ScaledCostFactor: ScaledCostFactor показывает величину, на которую умножается импеданс при прохождении области обслуживания через барьер. | Feature Set |
Time_Attribute (дополнительно) |
Определяет сетевой атрибут стоимости для использования при задании временных единиц значения Единиц разрывов (Break Units). Инструмент выполняет необходимые преобразования единиц времени в том случае, если значение Единиц разрывов (Break Units) отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы времени для разрывов и сетевой атрибут стоимости не обязательно должны быть одинаковыми. | String |
Time_Attribute_Units (дополнительно) |
Единицы сетевого атрибута стоимости, определенные параметром Атрибут времени (Time Attribute). Это информационный параметр, который не может быть изменен без прямого редактирования набора сетевых данных. Его также нет необходимости изменять, так как преобразования между единицами разрывов и стоимостным атрибутом выполняются за вас. | String |
Distance_Attribute (дополнительно) | Определяет сетевой атрибут стоимости для использования, если значение Единиц разрывов (Break Units) является единицей расстояния. Инструмент выполняет необходимые преобразования единиц расстояния в том случае, если значение Единиц разрывов (Break Units) отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы расстояния для разрывов и сетевой атрибут стоимости не обязательно должны быть одинаковыми. | String |
Distance_Attribute_Units (дополнительно) |
Единицы сетевого атрибута стоимости, определенные параметром Атрибут расстояния (Distance Attribute). Это информационный параметр, который не может быть изменен без прямого редактирования набора сетевых данных. Его также нет необходимости изменять, так как преобразования между единицами разрывов и стоимостным атрибутом выполняются за вас. | String |
Use_Hierarchy_in_Analysis (дополнительно) |
The parameter is not used if a hierarchy attribute is not defined on the network dataset used to perform the analysis. In such cases, use "#" as the parameter value. | Boolean |
Restrictions (дополнительно) |
Определяет, какие сетевые атрибуты ограничения будут учитываться во время решения. | String |
Attribute_Parameter_Values (дополнительно) |
Определяет значения параметра для атрибутов сети, имеющих параметры. Набор записей имеет два столбца, которые используются вместе для уникальной идентификации параметров, а также другой столбец, который определяет значение параметра. Набор записей значений параметра атрибута имеет связанные атрибуты. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. AttributeName: Имя сетевого атрибута, чей параметр атрибута задан строкой таблицы. ParameterName: Имя параметра атрибута, чье значение задано строкой таблицы. (Параметры типа объекта не могут быть обновлены с помощью данного инструмента.) ParameterValue: Значение, которое вы хотите задать для параметра атрибута. Если значение не указано, для параметра атрибута устанавливается значение NULL. | Record Set |
Maximum_Snap_Tolerance (дополнительно) |
Максимальный допуск замыкания представляет собой самое дальнее расстояние, которое использует Network Analyst для поиска расположения или повторного расположения точки на сети. Выполняется поиск подходящих ребер или соединений, далее выполняется замыкание точки на ближайший объект. Если подходящее положение не было найдено в пределах максимального допуска замыкания, то объект обозначается, как неразмещенный. | Linear unit |
Exclude_Restricted_Portions_of_the_Network (дополнительно) |
| Boolean |
Feature_Locator_WHERE_Clause (дополнительно) |
Выражение SQL используется для выбора поднабора исходных объектов, ограничивая сетевые элементы, на которых могут быть расположены объекты. Синтаксис для данного параметра состоит их двух частей: первая – имя источника класса пространственных объектов (после которого имеется пробел), вторая – выражение SQL. Чтобы написать выражения SQL для двух или более исходных классов пространственных объектов, их необходимо разделить точкой с запятой. Например, чтобы убедиться, что пункты обслуживания не располагаются на шоссе с ограниченным доступом, напишите выражение SQL, аналогичное следующему, с целью исключить такие исходные объекты: "Streets" "FUNC_CLASS not in('1', '2')". Обратите внимание, что барьеры игнорируют выражение WHERE для локатора объектов во время загрузки. | String |
Polygons_for_Multiple_Facilities (дополнительно) |
Выберите способ создания полигонов областей обслуживания в случае наличия в анализе множественных пунктов обслуживания.
| String |
Polygon_Overlap_Type (дополнительно) |
Используется для создания концентрических полигонов областей обслуживания в виде дисков или колец. Этот параметр применяется, только если для пунктов обслуживания задано нескольких граничных значений.
| String |
Detailed_Polygons (дополнительно) | Определяет параметр создания генерализованных или детализированных полигонов.
| Boolean |
Polygon_Trim_Distance (дополнительно) |
Используется для указания расстояния, в пределах которого полигон обрезается. Это полезно в случае, если ваши данные являются разреженными, и вы не желаете охватывать области обслуживания, не содержащие пространственных объектов. Отсутствие значения или значение 0 для данного параметра означает, что полигоны области обслуживания не следует обрезать. При использовании иерархии значение данного параметра игнорируется. | Linear unit |
Polygon_Simplification_Tolerance (дополнительно) |
Определяет степень упрощения геометрии полигона. Упрощение сохраняет исходную форму важных точек полигона, определяющих его форму, и удаляет все остальные точки. Указываемое вами расстояние упрощения является максимальным допустимым смещением упрощенного полигона от исходного. Упрощение полигона уменьшает количество вершин и приводит к сокращению времени отрисовки. | Linear unit |
Maximum_Facilities (дополнительно) |
Ограничивает количество пунктов обслуживания, которые могут быть добавлены в анализ области обслуживания. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Long |
Maximum_Number_of_Breaks (дополнительно) |
Ограничивает количество граничных значений, которые могут быть добавлены в анализ области обслуживания. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Long |
Maximum_Features_Affected_by_Point_Barriers (дополнительно) | Ограничивает количество объектов, на которые влияют точечные барьеры Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Long |
Maximum_Features_Affected_by_Line_Barriers (дополнительно) |
Ограничивает количество объектов, на которые влияют линейные барьеры Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (дополнительно) |
Ограничивает количество объектов, на которые влияют полигональные барьеры. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Long |
Maximum_Break_Time_Value (дополнительно) |
Ограничивает значение параметра Граничное значение (Break Value), которое может использоваться при расчете областей обслуживания на основании времени. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Double |
Maximum_Break_Distance_Value (дополнительно) | Ограничивает значение параметра Граничное значение (Break Value), которое может использоваться при расчете областей обслуживания на основании расстояния. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. Значение NULL соответствует отсутствию ограничений. | Double |
Force_Hierarchy_beyond_Break_Time_Value (дополнительно) |
Определяет граничное значение, после которого механизм расчета применит иерархию, даже в том случае, если иерархия не была разрешена при вычислении областей обслуживания на основании времени. Вычисление областей обслуживания для высоких граничных значений при использовании сетевой иерархии приводит к выполнению меньшего объема обработки, чем вычисление аналогичных областей обслуживания без использования иерархии. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Значение NULL показывает отсутствие иерархии, при этом всегда будет учитываться значение параметра Использовать иерархию в анализе (Use Hierarchy in Analysis). Если входной набор сетевых данных не поддерживает иерархию, то указание значения для данного параметра приведет к ошибке. В данном случае необходимо использовать значение NULL. | Double |
Force_Hierarchy_beyond_Break_Distance_Value (дополнительно) |
Определяет граничное значение, после которого механизм расчета применит иерархию, даже в том случае, если иерархия не была разрешена при вычислении областей обслуживания на основании расстояния. Вычисление областей обслуживания для высоких граничных значений при использовании сетевой иерархии приводит к выполнению меньшего объема обработки, чем вычисление аналогичных областей обслуживания без использования иерархии. Данный параметр помогает вам управлять объемом обработки, который выполняется при вычислении. Значение NULL показывает отсутствие иерархии, при этом всегда будет учитываться значение параметра Использовать иерархию в анализе (Use Hierarchy in Analysis). Если входной набор сетевых данных не поддерживает иерархию, то указание значения для данного параметра приведет к ошибке. В данном случае необходимо использовать значение NULL. | Double |
Пример кода
Выполнение инструмента с использованием необходимых параметров из окна Python.
import arcpy
facilities = arcpy.FeatureSet()
facilities.load("FireStations")
arcpy.na.GenerateServiceAreas(facilities, "1 2 3", "Minutes", "Streets_ND",
"in_memory\\FireStationServiceAreas")
В следующем автономном скрипте Python показано, как GenerateServiceAreas может использоваться для определения доступности магазина с течением времени. Он показывает процесс создания 5-минутной области обслуживания вокруг положения магазина в различное время дня. Такие анализы могут быть полезны, например для пиццерии, чтобы проследить изменение области, которая может быть достигнута в течении 5 минут от положения магазина, в зависимости от текущих условий движения.
# Name: GenerateServiceAreas_Workflow.py
# Description: Generate a 5 minute service area around a store location at
# different times in a day. Such analysis can be useful, for example
# for a pizza store, to see how the area that can be reached within
# 5 minutes from the store changes based on the current traffic
# conditions.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
import datetime
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"
env.overwriteOutput = True
#Set local variables
inNetworkDataset = "Transportation/Streets_ND"
impedanceAttribute = "TravelTime"
breakValues = "5"
breakUnits = "Minutes"
inFacilities = "Analysis/ExistingStore"
outGeodatabase = "C:/data/output/ServiceAreaOutput.gdb"
serviceArea = "in_memory\\ServiceAreas"
dateFieldName = "StartTime"
nameField = "Name"
#use today at 8 AM as the start time and then increment it by one hour
startTime = datetime.datetime(1899,12,30,8,0,0)
#Create a new feature set with same schema as Facilities parameter in
#Generate Service Areas tool. Load the feature from the ExistingStore
#feature class in the feature set
facilities = arcpy.GetParameterValue("GenerateServiceAreas_na",0)
facilities.load(inFacilities)
#Create an empty feature class with same spatial reference as the
#network dataset and a Date field called StartTime and a text field called Name
outServiceAreas = arcpy.management.CreateFeatureclass(outGeodatabase, "ServiceAreas",
"POLYGON","","","",
inNetworkDataset).getOutput(0)
arcpy.management.AddField(outServiceAreas, dateFieldName, "DATE")
arcpy.management.AddField(outServiceAreas, nameField, "TEXT")
#Open an insert cursor on the feature class to add new polygons
cursor = arcpy.da.InsertCursor(outServiceAreas, ("SHAPE@", nameField,
dateFieldName))
#Geneate a 5 minute service area around the store at every one hour interval
#from 8 AM to 8 PM. Copy the output service area to a new feature class
for i in range(1,14):
timeFormat = startTime.time().strftime("%I %p")
print "Generating {0} {1} service area at {2}".format(breakValues,breakUnits,
timeFormat)
arcpy.na.GenerateServiceAreas(facilities,breakValues,breakUnits,
inNetworkDataset, serviceArea, "TRAVEL_FROM",
startTime, Time_Attribute=impedanceAttribute)
#Get the shape from the output service area so that it can be inserted
#in the feature class
with arcpy.da.SearchCursor(serviceArea,("SHAPE@", nameField)) as inputRows:
row = inputRows.next()
cursor.insertRow((row[0],row[1],startTime))
startTime = startTime + datetime.timedelta(seconds=3600)
del cursor
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)