Суммировать близлежащие (Стандартный анализ объектов)

Сводка

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

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

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

Иллюстрация

Суммировать близлежащие

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

  • Для инструмента Суммировать близлежащие требуется два входных слоя: слой, от объектов которого будут измеряться расстояния, и слой для суммирования. Оба слоя могут быть точечными, линейными или площадными. Первый слой может содержать до 1000 объектов.

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

  • Некоторые режимы перемещения могут также учитывать пробки. Если учитываются пробки, то можно выбрать, используются ли пробки в режиме реального времени, либо исторический трафик (нужно указать день недели и время). Трафик в режиме реального времени можно спрогнозировать на 12 часов вперед. Исторический трафик можно задавать в 15-минутных интервалах в течение всего дня.

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

Синтаксис

arcpy.sfa.SummarizeNearby(sumNearbyLayer, summaryLayer, outputName, nearType, {distances}, {units}, {timeOfDay}, {timeZoneForTimeOfDay}, {returnBoundaries}, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
ParameterОбъяснениеТип данных
sumNearbyLayer

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

Feature Set
summaryLayer

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

Feature Set
outputName

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

String
nearType

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

  • STRAIGHTLINEПрямолинейное Евклидово измерение расстояния. Используется по умолчанию.
  • DRIVINGDISTANCEИспользование расстояния поездки на автомобиле.
  • DRIVINGTIMEИспользование расстояния, пройденного в заданный отрезок времени в автомобиле.
  • TRUCKINGDISTANCEИспользование расстояния поездки на грузовом автомобиле.
  • TRUCKINGTIMEИспользование расстояния, пройденного в заданный отрезок времени на грузовом автомобиле.
  • WALKINGDISTANCEИспользование расстояния, пройденного пешком по улице.
  • WALKINGTIMEИспользование расстояния, которое может быть пройдено пешком в заданный отрезок времени.
String
distances
[distances,...]
(Дополнительный)

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

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

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

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

  • MILESМили
  • FEETФуты
  • KILOMETERSКилометры
  • METERSМетры
  • YARDSЯрды
  • SECONDSСекунды
  • MINUTESМинуты
  • HOURSЧасы
String
timeOfDay
(Дополнительный)

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

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

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

  • Понедельник – 1/1/1990
  • Вторник – 1/2/1990
  • Среда – 1/3/1990
  • Четверг – 1/4/1990
  • Пятница – 1/5/1990
  • Суббота – 1/6/1990
  • Воскресенье – 1/7/1990
Хотя упомянутые выше даты дней недели начинаются с 1990 года, типичный трафик рассчитывается в соответствии с последними тенденциями дорожного движения – обычно за последние несколько месяцев.

Чтобы использовать текущий трафик, где и когда он доступен, выберите дату и время в пределах 12 часов от текущего времени. Esri сохраняет данные текущего трафика в течение 12 часов и дает прогнозные значения данных на 12 часов вперед. Если время и дата, которые вы укажете для данного параметра, будут за пределами 24-часового временного окна, или если поездка в анализе продолжится за пределами (позже) прогнозного окна данных, то в этом случае задача возвратится к скоростям типичного трафика.

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

Укажите часовой пояс или пояса выбранного времени суток. Есть две опции: Локальное (по умолчанию) и UTC.

  • GEOLOCALЗначение времени суток учитывает часовой пояс (пояса), в котором находятся входные объекты. Это может привести к разному начальному времени в разных зонах. Используется по умолчанию.
  • UTCЗначение времени суток указано по Всемирному координированному времени (UTC). Начальные времена для всех точек являются синхронными, т.е. не зависят от часовых поясов.
String
returnBoundaries
(Дополнительный)

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

  • RETURN_BOUNDARIESВыходной слой будет содержать области, которые определены указанным типом вблизи. Например, если используется расстояние по прямой линии 5 километров, получим области вокруг входных объектов слоя вблизи с радиусом 5 миль. Используется по умолчанию.
  • RETURN_INPUTВыходной слой будет содержать те же объекты, что и входной слой вблизи.
Boolean
sumShape
(Дополнительный)

Вычисляет статистику по форме входных суммируемых объектов, в том числе с учетом длины линий или площадей полигонов суммируемых объектов внутри каждого полигона входного слоя суммирования.

  • ADD_SHAPE_SUMВычислять суммированные атрибуты объекта. Используется по умолчанию.
  • NO_SHAPE_SUMНе вычислять суммированные атрибуты объекта.
Boolean
shapeUnits
(Дополнительный)

При суммировании геометрии близлежащих объектов укажите единицы суммирования.

Если объекты суммирования – полигоны, то допустимыми вариантами являются акры, гектары, квадратные метры, квадратные километры, квадратные футы, квадратные ярды и квадратные мили.

Если объекты суммирования – линии, то допустимыми вариантами являются метры, километры, футы, ярды и мили.

  • MILESМили
  • FEETФуты
  • KILOMETERSКилометры
  • METERSМетры
  • YARDSЯрды
  • ACRESАкры
  • HECTARESГектары
  • SQUAREMETERSКвадратные метры
  • SQUAREKILOMETERSКвадратные километры
  • SQUAREFEETКвадратные футы
  • SQUAREYARDSКвадратные ярды
  • SQUAREMILESКвадратные мили
String
summaryFields
[[Field, Statistic],...]
(Дополнительный)

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

  • SUM – суммарное значение.
  • MIN – наименьшее значение.
  • MAX – наибольшее значение.
  • MEAN – среднее арифметическое значение.
  • STD – среднеквадратическое отклонение.

Value Table
groupByField
(Дополнительный)

Это – поле из входных объектов суммирования, которое может использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей – HazardClass (класс опасности), содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass (класса опасности) используйте его, как поле группировать по.

Field
minorityMajority
(Дополнительный)

Это может применяться только при использовании поля группы. Если вы укажете ADD_MIN_MAJ, то в пределах поля группировки будет вычислено меньшинство (наиболее редко встречающиеся) или большинство (наиболее часто встречающиеся) среди атрибутивных значений. К выходному слою будут добавлены два новых поля с префиксами Majority_ и Minority_.

  • NO_MIN_MAJНе добавлять поля меньшинства и большинства. Используется по умолчанию.
  • ADD_MIN_MAJДобавить поля меньшинства и большинства.
Boolean
percentShape
(Дополнительный)

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

  • NO_PERCENTНе добавлять полей процентов. Используется по умолчанию.
  • ADD_PERCENTДобавлять поля процентов.
Boolean

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

NameОбъяснениеТип данных
resultLayer

Выходной суммированный слой.

Набор объектов
groupBySummary

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

Набор записей

Environments

Информация о лицензиях

  • Basic: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • Standard: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • Advanced: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа

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