Сводка
Находит объекты, которые расположены в пределах указанного расстояния от объектов входного слоя.
Расстояние может измеряться как по прямой линии, так и с учетом заданного режима передвижения. Затем вычисляется статистика для близлежащих объектов, как показано ниже:
- Расчет общей численности населения в пределах пяти минут езды от предложенного местоположения нового магазина.
- Расчёт числа съездов с автотрассы в пределах одной мили от предлагаемого местоположения нового магазина, которые будут использоваться в качестве измерения степени доступности магазина.
Иллюстрация
Использование
Для инструмента Суммировать близлежащие требуется два входных слоя: слой, от объектов которого будут измеряться расстояния, и слой для суммирования. Оба слоя могут быть точечными, линейными или площадными. Первый слой может содержать до 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 | Определяет, какой тип измерения расстояний вы хотели бы использовать: расстояние по прямой линии или измерение времени или расстояния поездки по дорожной сети различными видами транспорта, то есть используя разные режимы передвижения.
| String |
distances [distances,...] (Дополнительный) | Список двойных значений, которые определяют расстояние поиска (для прямолинейного движения и режимов передвижения на основе расстояния) или время поиска (для режимов передвижения на основе времени). Вы можете указать одно или несколько значений расстояния. Объекты, находящиеся в пределах указанных расстояний, будут суммироваться. Значения units расстояния указываются в параметре units. | Double |
units (Дополнительный) | Если тип вблизи – прямолинейный или режим передвижения на основе расстояния, то для заданных значений расстояния используются линейные единицы измерения. Допустимыми являются метры, километры, футы, ярды и мили. Если тип вблизи – режим передвижения на основе времени, то значения могут быть в секундах, минутах и часах.
| String |
timeOfDay (Дополнительный) | Задайте, будут ли при вычисления времени в пути учитываться данные о загруженности дорог. Чтобы использовать условия интенсивности дорожного движения необходимо тип вблизи перевести в режим "поездка по времени". Значение параметра Время суток показывает время начала поездки, или время отправления из точек отправления. Поддерживается два типа условий интенсивности дорожного движения (далее: трафик): типичный и текущий. Условия типичного трафика подразумевают средне-исторические скорости, рассчитанные на неделю для 5-минутных интервалов. Для текущего трафика используются скорости, которые получены от телефонов, сенсоров и других источников данных для записи действительной скорости передвижения и прогнозирования скоростей на ближайшее время вперед. Для использования в этой задаче типичного трафика в тех местоположениях, где он доступен, выберите время и день недели и конвертируйте этот день недели в одну из следующих дат, начиная с 1990 года:
Чтобы использовать текущий трафик, где и когда он доступен, выберите дату и время в пределах 12 часов от текущего времени. Esri сохраняет данные текущего трафика в течение 12 часов и дает прогнозные значения данных на 12 часов вперед. Если время и дата, которые вы укажете для данного параметра, будут за пределами 24-часового временного окна, или если поездка в анализе продолжится за пределами (позже) прогнозного окна данных, то в этом случае задача возвратится к скоростям типичного трафика. | Date |
timeZoneForTimeOfDay (Дополнительный) | Укажите часовой пояс или пояса выбранного времени суток. Есть две опции: Локальное (по умолчанию) и UTC.
| String |
returnBoundaries (Дополнительный) | Устанавливает, будут ли возвращаться входные геометрии, расстояние по прямой линии или буфер геометрии режима передвижения.
| Boolean |
sumShape (Дополнительный) | Вычисляет статистику по форме входных суммируемых объектов, в том числе с учетом длины линий или площадей полигонов суммируемых объектов внутри каждого полигона входного слоя суммирования.
| Boolean |
shapeUnits (Дополнительный) | При суммировании геометрии близлежащих объектов укажите единицы суммирования. Если объекты суммирования – полигоны, то допустимыми вариантами являются акры, гектары, квадратные метры, квадратные километры, квадратные футы, квадратные ярды и квадратные мили. Если объекты суммирования – линии, то допустимыми вариантами являются метры, километры, футы, ярды и мили.
| String |
summaryFields [[Field, Statistic],...] (Дополнительный) | Список имен полей и тип суммарной статистики, которые вы хотите выполнить для этих полей – для всех точек в пределах каждого полигона. Всегда возвращается число точек внутри каждого полигона. Поддерживаются следующие типы статистики:
| Value Table |
groupByField (Дополнительный) | Это – поле из входных объектов суммирования, которое может использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей – HazardClass (класс опасности), содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass (класса опасности) используйте его, как поле группировать по. | Field |
minorityMajority (Дополнительный) | Это может применяться только при использовании поля группы. Если вы укажете ADD_MIN_MAJ, то в пределах поля группировки будет вычислено меньшинство (наиболее редко встречающиеся) или большинство (наиболее часто встречающиеся) среди атрибутивных значений. К выходному слою будут добавлены два новых поля с префиксами Majority_ и Minority_.
| Boolean |
percentShape (Дополнительный) | Это может применяться только при использовании поля группы. Если отмечено – будет вычислена доля в процентах каждого уникального значения группы для каждого входного ближайшего объекта.
| Boolean |
Производные выходные данные
Name | Объяснение | Тип данных |
resultLayer | Выходной суммированный слой. | Набор объектов |
groupBySummary | Если было указано поле группы, то инструмент выведет таблицу, содержащую расчетную статистику для каждой уникальной группы. | Набор записей |
Environments
Информация о лицензиях
- Basic: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Standard: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
- Advanced: Требуется Права доступа Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа