Присоединить объекты (GeoAnalytics)

Краткая информация

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

Иллюстрация

В обоих примерах показано пространственно-временное присоединение с помощью инструмента Присоединить объекты.

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

• Пространственное соединение сопоставляет объекты (строки) входных данных (Целевой слой и Присоединяемый слой) в зависимости от их пространственного расположения. Временное соединение сопоставляет объекты (строки) входных данных на основе их временных отношений. Атрибутивное соединение сопоставляет объекты на основе полей значений.

• Вы можете соединять их на основании пространственного отношения, временного отношения, атрибутивного отношения, или любой их комбинации.

  Опции	Описание
  Пространственное отношение	Пространственное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа геометрии (точки, линии, полигоны) соединяемых слоёв. Доступны следующие пространственные отношения: Пересекает Равен Ближайший (На плоскости) – использует расстояния на плоскости. Ближайший (Геодезически) – использует геодезические расстояния. Этот параметр доступен только в ArcGIS Enterprise версии 10.7.1 и более поздних. Содержит Внутри Касается Перекрещивается Перекрывает Узнайте больше о пространственных отношениях в инструментах GeoAnalytics для Server
  Временное отношение	Временное отношение, определяющее, будут ли объекты присоединяться друг к другу. Доступные отношения будут зависеть от типа времени (мгновенный или интервальный) соединяемых слоёв. Доступны следующие временные отношения: Соответствует Встречено Перекрывает Перекрыто В течение Содержит Равен Завершает Завершено Начинает Начато Пересекает Ближайший объект Ближайший объект до Ближайший объект после Узнайте больше о временных отношениях в инструментах GeoAnalytics для Server
  Атрибутивное отношение	Атрибутивное отношение, определяющее, будут ли объекты присоединяться друг к другу. Атрибуты объектов соединяются, если значения поля в присоединяемом слое идентичны значениям поля в целевом слое.

• Если целевые и присоединяемые объекты находятся в разных системах координат, будет использована система координат целевых объектов. Если выбрана выходная система координат, все объекты проецируются в эту систему, а затем соединяются.

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

• Если несколько пространственных объектов совпадают с одним и тем же целевым объектом, вы можете определить, соединять ли все совпадающие объекты (Присоединить один-ко-многим) или суммировать все объекты вместе (Присоединить один-к-одному):

  • Присоединить один-ко-многим – присоединяет все совпадающие объекты в присоединяемом слое с объектами целевого слоя. Полученный в результате слой будет содержать несколько записей для целевого объекта.
  • Присоединить один-к-одному – суммирует все совпадающие присоединяемые объекты, и присоединяет их к каждому объекту в целевом слое. Только совпадающие объекты будут включены в суммирование и результат. Количество присоединённых объектов будет добавлено в дополнение к другой статистике, такой как сумма, минимум, максимум, диапазон, дисперсия, среднее и стандартное отклонение. По умолчанию, только те целевые объекты, которые имеют заданное отношение с соединяемыми объектами, будут сохраняться в выходном классе объектов (внутреннее соединение). Если отмечена опция Сохранить все целевые объекты, в выходной класс объектов будут записаны все входные целевые объекты (это называется левым внешним соединением).

  

  Показаны примеры операции присоединения один-ко-многим и один-к-одному. В этом примере присоединение один-к одному включает только количество; дополнительные статистические параметры могут быть вычислены, как показано ниже.

• Дополнительно вы можете построить выражение для присоединения пространственных объектов с помощью параметра Условие присоединения. Если вы указываете выражение, будут использоваться только соответствующие условию пространственные объекты. Например, используя выражение $target["Magnitude"] > $join["Explosion"] вы можете только соединить целевые объекты из поля Magnitude, если значение поля больше, чем у присоединяемого объекта в поле Explosion. См. раздел Выражения присоединения объектов для дополнительной информации.

• При выполнении соединения "один ко многим" в выходные объекты включаются следующие поля:

  • Все поля из целевых слоев
  • Все поля из присоединяемого слоя

  Если одно и то же имя поля существует в целевом и присоединяемом наборах данных, поле соединения будет начинаться со слова join (например, join_fieldname).

  Имя поля	Описание
  start_datetime	Это поле представляет время начала и создается, когда для входных данные задано время в виде момента или интервала.
  end_datetime	Это поле представляет время окончания и создается, когда для входных данные задано время в виде интервала.

  В дополнение ко всем полям из целевого слоя, следующие поля включаются в выходные объекты при выполнении соединения один к одному:

  Имя поля	Описание
  count	Число пространственных объектов, которые были присоединены.
  statistic_fieldname	Каждая указанная статистика будет создавать поле атрибутов с именем в следующем формате: statistics_field name. Например, максимум и среднеквадратическое отклонение для поля id будет MAX_id и SD_id.
  start_datetime	Это поле представляет время начала и создается, когда для входных данные задано время в виде момента или интервала.
  end_datetime	Это поле представляет время окончания и создается, когда для входных данные задано время в виде интервала.

• Вы можете повысить производительность инструмента Присоединить объекты, выполнив одно или несколько из следующих действий:

  • Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
  • Сделайте условия соединения как можно более избирательными. Например, пространственное соединение Рядом с условием 1 километр будет работать лучше, чем соединение с условием 5 километров на тех же данных.
  • Добавляйте больше одного условия. Дополнительное условие присоединения делает соединение более избирательным. Например, пространственное соединение Рядом с условиями 1 километр и 1 час будет работать лучше, чем соединение с условием 1 километр на тех же данных.
  • Применяйте выражение присоединения.
  • Используйте локальные данные там, где запускается анализ.

• Аналогичный анализ можно выполнить при помощи инструмента Пространственное соединение из набора инструментов Анализ.

• Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на ArcGIS Enterprise.

• При запуске инструментов GeoAnalytics Server анализ выполняется на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Рекомендуется всегда публиковать данные или создавать файловое хранилище больших данных.

  Более подробно о публикации локаторов на портале

  Более подробно о создании файловых хранилищ больших данных в Server Manager

Параметры

Диалог

Подпись	Описание	Тип данных
Целевой слой	Содержит целевые объекты. Атрибуты целевых объектов, к которым присоединяются атрибуты присоединяемых объектов и которые будут перенесены в выходной.	Record Set
Присоединяемый слой	Содержит присоединяемые объекты. Атрибуты, которые будут присоединены к объектам целевого класса. Дополнительные сведения о том, как тип операции соединения влияет на объединение присоединяемых атрибутов, см. в описании параметра Операции соединения (join_operation в Python).	Record Set
Выходное имя	Имя выходного сервиса пространственных объектов.	String
Операция соединения	Определяет, как будут осуществляться соединения между Целевым слоем и Присоединяемым слоем в выходном классе объектов, если найдено несколько присоединяемых объектов, которые имеют то же пространственное расположение по отношению к одному целевому объекту. Присоединить Один-к-одному—Атрибуты нескольких присоединяемых объектов будут агрегированы. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, атрибуты этих двух полигонов будут агрегированы до переноса в выходной класс объектов. Если один полигон имеет атрибутивное значение 3, а другой – значение 7, при выборе суммарной статистики для этого поля значение в выходном классе объектов будет равно 10. Это значение по умолчанию, и возвращается только статистика подсчета. Присоединить один-ко-многим—Выходной класс пространственных объектов будет содержать несколько копий (записей) целевого объекта. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, выходной класс объектов будет содержать две строки атрибутивной таблицы целевого объекта: одна – с атрибутами одного полигона, другая – с атрибутами другого. С этим методом суммарная статистика не используется.	String
Пространственное отношение (Дополнительный)	Задает критерии, которые будут использованы для пространственного соединения объектов. Пересекает—Присоединяемые объекты учитываются, если они пересекают целевые объекты. Это значение по умолчанию Равен—Присоединяемые объекты сопоставляются если их геометрия идентична геометрии целевого объекта. Ближайший, планарный—Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется с помощью плоскостного расстояния. Задание расстояние для параметра, применяемого к Пространственному расстоянию Рядом. Ближайший, геодезический—Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется геодезически. Задание расстояние для параметра, применяемого к Пространственному расстоянию Рядом. Данная опция доступна для версии ArcGIS Enterprise 10.7 и более поздних. Содержит—Целевые объекты должны содержать в своих границах присоединяемые объекты. Целевыми объектами должны быть полигоны или полилинии. Если целевыми объектами являются полигоны, присоединяемыми объектами могут быть только полигоны. Полигон может содержать объект любого типа. Полилиния может содержать только полилинию и точку. Точка не может содержать какой-либо объект, даже точку. Если присоединяемый объект полностью находится на границе целевого объекта (ни одна из его частей не находится внутри или вне ее), объект не будет сопоставлен. Внутри—Целевые объекты должны содержать в своих границах присоединяемые объекты. Это отношение является обратным отношению Содержит. Для этой опции целевые объекты могут быть только полигонами, а присоединяемые объекты – также полигонами. Точка может быть присоединяемым объектом, только если целевым объектом также является точка. Если присоединяемый объект находится целиком на границе целевого объекта; в этом случае объект учитываться не будет. Касается—Присоединяемые объекты учитываются, если их границы касаются целевого объекта. Если целевые и присоединяемые объекты являются линиями или полигонами, граница присоединяемого объекта может только касаться границы целевого объекта, и ни одна часть присоединяемого объекта может не пересекать границу целевого объекта. Перекрещивается—Присоединяемые объекты учитываются, если целевой объект пересекается их контуром. Присоединяемые и целевые объекты должны быть линейными или полигональными. Если присоединяемыми и целевыми объектами являются полигоны, используется граница полигона (линия). Будут учитываться линии, пересекающиеся в точке, но не линии с общим линейным сегментом. Перекрывает—Присоединяемые объекты будут сопоставляться, если они накладываются на целевые объекты.	String
Расстояние отношения Рядом (Дополнительный)	Расстояние от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Радиус поиска действует, только когда Пространственным отношением является Рядом, планарный или Рядом, геодезический.	Linear Unit
Временное отношение (Дополнительный)	Задает критерии времени, которые будут использованы для сопоставления объектов. Соответствует—Если окончание интервала целевого времени равно началу интервала времени соединения, то целевое время встречает время соединения. Встречено—Если начало целевого времени равно окончанию интервала времени соединения, то такое целевое время встречено временем соединения. Перекрывает—Если интервал целевого времени начинается и заканчивается до начала и окончания интервала времени соединения, то такое целевое время перекрывает время соединения. Перекрыто—Если интервал целевого времени начинается и заканчивается после времени начала и окончания интервала времени соединения, то такое целевое время перекрыто временем соединения. В течение—Если целевое время находится в промежутке между началом и окончанием интервала времени соединения, считается, что это целевое время случилось в течение времени соединения. Содержит—Если время присоединяемого объекта находится в промежутке между началом и окончанием интервала целевого времени, считается, что это целевое время содержит время соединения. Равен—Два времени считаются равными, если их моменты или интервалы одинаковые. Завершает—Если целевое время оканчивается одновременно с временем соединения, а началось после этого времени соединения, то это целевое время завершает время соединения. Завершено—Если время присоединяемого объекта оканчивается одновременно с целевым временем, и это время соединения началось после начала целевого времени, то это целевое время будет завершено временем соединения. Начинает—Если целевое время начинается одновременно с началом интервала времени соединения и заканчивается до окончания интервала времени соединения, то это целевое время начинает время соединения. Начато—Если целевое время интервала начинается одновременно с временем соединения и заканчивается по окончании времени соединения, то это целевое время начато временем соединения. Пересекает—Если любая часть целевого времени случается одновременно с временем соединения, то это целевое время пересекает время соединения. Ближайший объект—Если целевое время находится в заданном диапазоне времени от времени соединения, то это целевое время располагается рядом со временем соединения. Рядом до—Если целевое время указывает время до времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается незадолго до времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже. Рядом после—Если целевое время указывает время после времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается немного позже времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже.	String
Расстояние временного отношения Рядом (Дополнительный)	Расстояние во времени от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Время действует, только когда Временным отношением является Рядом, Рядом до или Рядом после, и оба объекта содержат информацию о времени.	Time Unit
Атрибутивное отношение (Дополнительный)	Соединяет объекты по значениям атрибутивного поля. Указывает, какое атрибутивное поле целевого слоя должно быть сопоставлено с атрибутивным полем слоя соединения. Целевое поле – атрибутивное поле из целевого слоя, содержащее сопоставляемые значения. Поле соединения – атрибутивное поле из слоя соединения, содержащее сопоставляемые значения.	Value Table
Поля суммирования (Дополнительный)	Статистика, которая будет рассчитываться по определенным полям.	Value Table
Условие присоединения (Дополнительный)	Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям. Например, вы можете применить условие присоединения к объектам, у которых атрибутивное значение HealthSpending в слое соединения на 20 процентов больше, чем значение Income в целевом слое. В 10.5 и 10.5.1 выражение условия соединения выглядит так: join["HealthSpending"] > target["Income"] * .2. В версии 10.6 и выше, используйте выражения Arcade, например, $join["HealthSpending"] > $target["Income"] * .2. Если слой добавлен на карту, фильтры Поля и Помощник могут использоваться для построения выражения. Более подробно о выражениях Присоединения объектов в версии 10.6	String
Хранилище данных (Дополнительный)	Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию это Хранилище больших пространственно-временных данных. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат. Хранилище пространственно-временных больших данных—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию Реляционное хранилище данных—Результаты будут храниться в хранилище реляционных данных.	String
Сохранить все целевые объекты (Дополнительный)	Определяет, будут ли поддерживаться в выходном классе объектов (внешнее соединение) все целевые объекты или только те, у которых имеется заданное отношение с соединяемыми объектами (внутреннее соединение). Отмечено – все целевые объекты будут записаны в выходные данные (внешнее соединение). Не отмечено – только те целевые объекты, которые имеют заданное отношение с соединяемыми, будут сохраняться в выходном классе объектов (внутреннее соединение). Все точечные объекты, не попадающие в пределы полигональных объектов, будут исключены из выходных данных. Это значение по умолчанию	Boolean

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

Подпись	Описание	Тип данных
Output_Feature_Class	Присоединенные выходные данные.	Record Set

Python

arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store}, {keep_all_target_features})

Имя	Описание	Тип данных
target_layer	Содержит целевые объекты. Атрибуты целевых объектов, к которым присоединяются атрибуты присоединяемых объектов и которые будут перенесены в выходной.	Record Set
join_layer	Содержит присоединяемые объекты. Атрибуты, которые будут присоединены к объектам целевого класса. Дополнительные сведения о том, как тип операции соединения влияет на объединение присоединяемых атрибутов, см. в описании параметра Операции соединения (join_operation в Python).	Record Set
output_name	Имя выходного сервиса пространственных объектов.	String
join_operation	Определяет, как будут осуществляться соединения между значениями target_layer и join_layer в выходном классе объектов, если найдено несколько присоединяемых объектов, которые имеют то же пространственное расположение по отношению к одному целевому объекту. JOIN_ONE_TO_ONE—Атрибуты нескольких присоединяемых объектов будут агрегированы. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, атрибуты этих двух полигонов будут агрегированы до переноса в выходной класс объектов. Если один полигон имеет атрибутивное значение 3, а другой – значение 7, при выборе суммарной статистики для этого поля значение в выходном классе объектов будет равно 10. Это значение по умолчанию, и возвращается только статистика подсчета. JOIN_ONE_TO_MANY—Выходной класс пространственных объектов будет содержать несколько копий (записей) целевого объекта. Например, если точечный целевой объект расположен внутри двух отдельных полигонов в классе присоединяемых объектов, выходной класс объектов будет содержать две строки атрибутивной таблицы целевого объекта: одна – с атрибутами одного полигона, другая – с атрибутами другого. С этим методом суммарная статистика не используется.	String
spatial_relationship (Дополнительный)	Задает критерии, которые будут использованы для пространственного соединения объектов. INTERSECTS—Присоединяемые объекты учитываются, если они пересекают целевые объекты. Это значение по умолчанию EQUALS—Присоединяемые объекты сопоставляются если их геометрия идентична геометрии целевого объекта. NEAR—Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется с помощью плоскостного расстояния. Введите расстояние в параметре spatial_near_distance. NEAR_GEODESIC—Присоединяемые объекты учитываются, если они находятся в пределах указанного расстояния от целевого объекта. Расстояние измеряется геодезически. Введите расстояние в параметре spatial_near_distance. Данная опция доступна для версии ArcGIS Enterprise 10.7 и более поздних. CONTAINS—Целевые объекты должны содержать в своих границах присоединяемые объекты. Целевыми объектами должны быть полигоны или полилинии. Если целевыми объектами являются полигоны, присоединяемыми объектами могут быть только полигоны. Полигон может содержать объект любого типа. Полилиния может содержать только полилинию и точку. Точка не может содержать какой-либо объект, даже точку. Если присоединяемый объект полностью находится на границе целевого объекта (ни одна из его частей не находится внутри или вне ее), объект не будет сопоставлен. WITHIN—Целевые объекты должны содержать в своих границах присоединяемые объекты. Это отношение является обратным отношению Содержит. Для этой опции целевые объекты могут быть только полигонами, а присоединяемые объекты – также полигонами. Точка может быть присоединяемым объектом, только если целевым объектом также является точка. Если присоединяемый объект находится целиком на границе целевого объекта; в этом случае объект учитываться не будет. TOUCHES—Присоединяемые объекты учитываются, если их границы касаются целевого объекта. Если целевые и присоединяемые объекты являются линиями или полигонами, граница присоединяемого объекта может только касаться границы целевого объекта, и ни одна часть присоединяемого объекта может не пересекать границу целевого объекта. CROSSES—Присоединяемые объекты учитываются, если целевой объект пересекается их контуром. Присоединяемые и целевые объекты должны быть линейными или полигональными. Если присоединяемыми и целевыми объектами являются полигоны, используется граница полигона (линия). Будут учитываться линии, пересекающиеся в точке, но не линии с общим линейным сегментом. OVERLAPS—Присоединяемые объекты будут сопоставляться, если они накладываются на целевые объекты.	String
spatial_near_distance (Дополнительный)	Расстояние от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Радиус поиска действует, только когда для параметра spatial_relationship задано NEAR или NEAR_GEODESIC.	Linear Unit
temporal_relationship (Дополнительный)	Задает критерии времени, которые будут использованы для сопоставления объектов. MEETS—Если окончание интервала целевого времени равно началу интервала времени соединения, то целевое время встречает время соединения. MET_BY—Если начало целевого времени равно окончанию интервала времени соединения, то такое целевое время встречено временем соединения. OVERLAPS—Если интервал целевого времени начинается и заканчивается до начала и окончания интервала времени соединения, то такое целевое время перекрывает время соединения. OVERLAPPED_BY—Если интервал целевого времени начинается и заканчивается после времени начала и окончания интервала времени соединения, то такое целевое время перекрыто временем соединения. DURING—Если целевое время находится в промежутке между началом и окончанием интервала времени соединения, считается, что это целевое время случилось в течение времени соединения. CONTAINS—Если время присоединяемого объекта находится в промежутке между началом и окончанием интервала целевого времени, считается, что это целевое время содержит время соединения. EQUALS—Два времени считаются равными, если их моменты или интервалы одинаковые. FINISHES—Если целевое время оканчивается одновременно с временем соединения, а началось после этого времени соединения, то это целевое время завершает время соединения. FINISHED_BY—Если время присоединяемого объекта оканчивается одновременно с целевым временем, и это время соединения началось после начала целевого времени, то это целевое время будет завершено временем соединения. STARTS—Если целевое время начинается одновременно с началом интервала времени соединения и заканчивается до окончания интервала времени соединения, то это целевое время начинает время соединения. STARTED_BY—Если целевое время интервала начинается одновременно с временем соединения и заканчивается по окончании времени соединения, то это целевое время начато временем соединения. INTERSECTS—Если любая часть целевого времени случается одновременно с временем соединения, то это целевое время пересекает время соединения. NEAR—Если целевое время находится в заданном диапазоне времени от времени соединения, то это целевое время располагается рядом со временем соединения. NEAR_BEFORE—Если целевое время указывает время до времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается незадолго до времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже. NEAR_AFTER—Если целевое время указывает время после времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается немного позже времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже. Задает критерии времени, которые будут использованы для сопоставления объектов. MEETS—Если окончание интервала целевого времени равно началу интервала времени соединения, то целевое время встречает время соединения. MET_BY—Если начало целевого времени равно окончанию интервала времени соединения, то такое целевое время встречено временем соединения. OVERLAPS—Если интервал целевого времени начинается и заканчивается до начала и окончания интервала времени соединения, то такое целевое время перекрывает время соединения. OVERLAPPED_BY—Если интервал целевого времени начинается и заканчивается после времени начала и окончания интервала времени соединения, то такое целевое время перекрыто временем соединения. DURING—Если целевое время находится в промежутке между началом и окончанием интервала времени соединения, считается, что это целевое время случилось в течение времени соединения. CONTAINS—Если время присоединяемого объекта находится в промежутке между началом и окончанием интервала целевого времени, считается, что это целевое время содержит время соединения. EQUALS—Два времени считаются равными, если их моменты или интервалы одинаковые. FINISHES—Если целевое время оканчивается одновременно с временем соединения, а началось после этого времени соединения, то это целевое время завершает время соединения. FINISHED_BY—Если время присоединяемого объекта оканчивается одновременно с целевым временем, и это время соединения началось после начала целевого времени, то это целевое время будет завершено временем соединения. STARTS—Если целевое время начинается одновременно с началом интервала времени соединения и заканчивается до окончания интервала времени соединения, то это целевое время начинает время соединения. STARTED_BY—Если целевое время интервала начинается одновременно с временем соединения и заканчивается по окончании времени соединения, то это целевое время начато временем соединения. INTERSECTS—Если любая часть целевого времени случается одновременно с временем соединения, то это целевое время пересекает время соединения. NEAR—Если целевое время находится в заданном диапазоне времени от времени соединения, то это целевое время располагается рядом со временем соединения. NEAR_BEFORE—Если целевое время указывает время до времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается незадолго до времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже. NEAR_AFTER—Если целевое время указывает время после времени соединения, но находится в заданном диапазоне от времени соединения, то оно располагается немного позже времени соединения. Данная опция доступна, начиная с ArcGIS Enterprise версии 10.6 и позже.	String
temporal_near_distance (Дополнительный)	Расстояние во времени от целевого объекта, в пределах которого будут рассматриваться объекты соединения, для пространственного соединения. Время действует, только когда для temporal_relationship выбрано NEAR, NEAR_BEFORE или NEAR_AFTER, и оба объекта содержат информацию о времени.	Time Unit
attribute_relationship [attribute_relationship,...] (Дополнительный)	Соединяет объекты по значениям атрибутивного поля. Указывает, какое атрибутивное поле целевого слоя должно быть сопоставлено с атрибутивным полем слоя соединения. Целевое поле – атрибутивное поле из целевого слоя, содержащее сопоставляемые значения. Поле соединения – атрибутивное поле из слоя соединения, содержащее сопоставляемые значения.	Value Table
summary_fields [summary_fields,...] (Дополнительный)	Статистика, которая будет рассчитываться по определенным полям. COUNT – количество ненулевых значений. Может использоваться с числовыми или текстовыми полями. Количество [null, 0, 2] равно 2. SUM – сумма числовых значений в поле. Сумма [null, null, 3] равна 3. MEAN – среднее арифметическое числовых значений. Среднее [0,2, null] равно 1. MIN – минимальное значение числового поля. Минимум [0, 2, null] равен 0. MAX – максимальное значение числового поля. Максимальное значение [0, 2, null] равно 2. STDDEV – среднеквадратическое отклонение числового поля. Среднеквадратическое отклонение [1] равно null. Среднеквадратическое отклонение [null, 1,1,1] равно null. VAR – дисперсия по числовому полю в треке. Дисперсия [1] равна null. Дисперсия [null, 1,1,1] равна null. RANGE – диапазон числового поля. Он вычисляется вычитанием минимального значения из максимального. Диапазон [0, null, 1] равен 1. Диапазон [null, 4] равен 0. ANY – пример строки из текстового поля.	Value Table
join_condition (Дополнительный)	Применяет к указанным полям условие. Будут присоединены только объекты, значение полей которых соответствуют этим условиям. Например, вы можете применить условие присоединения к объектам, у которых атрибутивное значение HealthSpending в слое соединения на 20 процентов больше, чем значение Income в целевом слое. В 10.5 и 10.5.1 выражение условия соединения выглядит так: join["HealthSpending"] > target["Income"] * .2. В версии 10.6 и выше, используйте выражения Arcade, например, $join["HealthSpending"] > $target["Income"] * .2.	String
data_store (Дополнительный)	Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат. SPATIOTEMPORAL_DATA_STORE—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию RELATIONAL_DATA_STORE—Результаты будут храниться в хранилище реляционных данных.	String
keep_all_target_features (Дополнительный)	Определяет, будут ли поддерживаться в выходном классе объектов (внешнее соединение) все целевые объекты или только те, у которых имеется заданное отношение с соединяемыми объектами (внутреннее соединение). KEEP_ALL—Все целевые объекты будут записаны в выходные данные (левое внешнее соединение). KEEP_COMMON—Только те целевые объекты, которые имеют заданное отношение с соединяемыми, будут сохраняться в выходном классе объектов (внутреннее соединение). Это значение по умолчанию	Boolean

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

Имя	Описание	Тип данных
output	Присоединенные выходные данные.	Record Set

Пример кода

JoinFeatures, пример (автономный скрипт)

В следующем автономном скрипте показано, как использовать инструмент JoinFeatures.

# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and 
#              return the count of nearby crimes. This example is a self join 
#              (joining the same layer to itself).
# Requirements: ArcGIS GeoAnalytics Server 

# Import system modules 
import arcpy 

# Set local variables 
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
outFS = "CloseCrimes" 
dataStore = "SPATIOTEMPORAL_DATA_STORE" 

# Execute Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE", 
                                spatialOperation, nearDistance, temporalOperation, 
                                nearTime, None, None, None, dataStore)

Параметры среды

Выходная система координат, Экстент, Текущая рабочая область

Особые случаи

Выходная система координат

Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для GeoAnalytics Tools готовые результаты будут храниться в пространственно-временном хранилище данных в WGS84.

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

• Basic: Обязательно ArcGIS GeoAnalytics Server
• Standard: Обязательно ArcGIS GeoAnalytics Server
• Advanced: Обязательно ArcGIS GeoAnalytics Server