Ближайший объект (Инструменты Анализа)

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

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

Узнайте больше о том, как рассчитывается близость с помощью инструментов геообработки

Иллюстрация

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

К входным объектам будут добавлены следующие поля. Если поля уже существуют, их значения обновляются. Эти названия полей можно настроить с помощью параметра Имена полей.
- NEAR_FID—Object ID ближайшего объекта. Если ближайшие объекты не найдены, значение будет равно -1.
- NEAR_DIST—Расстояние между входным и ближайшим объектом. Если значением параметра Метод является Геодезический, и входные объекты заданы в географической системе координат, значения в этом поле указываются в линейных единицах измерения системы координат входных объектов или метрах. Если ближайшие объекты не найдены, значение будет равно -1.
- NEAR_FC—Путь к исходному классу объектов, содержащему ближайший найденный объект. Имя слоя будет использоваться, если в качестве входных данных используются слои, а если в качестве входных данных используются пути, будет применен путь к классу пространственных объектов. Это поле добавляется в выходную таблицу только в том случае, если указано несколько ближайших объектов. Если ближайший объект не найден, значение будет пустой строкой или null.
Если отмечен параметр Местоположение, во входные данные будут добавлены следующие поля. Значения полей будут обновлены, если эти поля уже существуют. Единицы измерения значений в поле зависят от значения параметра Метод. Если для параметра Метод задано Плоскостной, значение дается в линейных единицах измерения системы координат входных объектов. Если выбран Геодезический метод, значение будет в географической системе координат, связанной с системой координат входных объектов.
- NEAR_X—X-координата точки ближайшего объекта, наиболее близкой к входному объекту. Если ближайшие объекты не найдены, значение будет равно -1.
- NEAR_Y—Y-координата точки ближайшего объекта, наиболее близкой к входному объекту. Если ближайшие объекты не найдены, значение будет равно -1.
Если отмечен параметр Угол, ко входным объектам будет добавлено следующее поле. Значение поля будет обновлено, если это поле уже существует.
- NEAR_ANGLE—Угол, под которым направлена в местоположении FROM_X и FROM_Y линия, соединяющая входные объекты с ближайшим объектом. Если ближайшие объекты не найдены, или ближайший объект пересекается с входным объектом, значение будет равно 0.
Значения NEAR_FID и NEAR_DIST будут равны -1, если в пределах указанного радиуса поиска не будут найдены объекты.
И входными, и ближайшими объектами могут быть точки, мультиточки, линии или полигоны.
Значение параметра Ближайшие объекты может включать один или нескольких классов пространственных объектов с разными типами геометрии (точек, мультиточек, линий и полигонов).
Для вычисления расстояния и дополнительной информации о близости внутри одного класса объектов или слоя можно использовать тот же класс объектов или слой. В этом случае оцениваемый входной объект будет исключен из списка ближайших объектов-кандидатов, чтобы не допустить, чтобы все объекты были ближайшими друг к другу.
Входными объектами может быть слой, в котором вы создали выборку. В процессе выполнения инструмента будут использоваться и обновляться объекты. У остальных объектов будут значения -1 во вновь созданных полях (таких как NEAR_FID и NEAR_DIST).
Когда несколько ближайших объектов находятся на равном кратчайшем расстоянии от входного объекта, один из них выбирается в качестве самого близкого объекта случайным образом.
Когда значением параметра Метод является Плоскостные, используйте проекцию для входных объектов, которая позволяет корректно измерять расстояния, например, равнопромежуточную проекцию.

Более подробно о картографических проекциях и системах координат
Для визуализации местоположений NEAR_X и NEAR_Y выходную таблицу можно использовать в качестве входной для инструментов Создать слой событий XY или XY в линию.
You can set a unit of measurement for the NEAR_DIST поле—например, метры, километры или мили — с использованием параметра Единицы расстояния.
Этот инструмент поддерживает поиск ближайшего объекта для каждого из нескольких входных значений параметра Ближайшие объекты.

Подпись	Объяснение	Тип данных
Входные объекты	Входные объекты могут быть точками, полилиниями, полигонами или мультиточками.	Feature Layer
Ближайшие объекты	Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу будет добавлено поле `NEAR_FC`, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Один и тот же класс объектов или слой можно использовать как в качестве входных объектов, так и в качестве ближайших объектов.	Feature Layer
Радиус поиска (Дополнительный)	Радиус, который будет использоваться для поиска ближайших объектов. Если значение не указано, в вычисления будут включены все ближайшие объекты. Если расстояние введено, но единица измерения не задана или неизвестна, будут использоваться единицы системы координат входных объектов. Если используется опция Геодезический для параметра Метод, используйте линейные единицы измерения, такие как километры или мили.	Linear Unit
Местоположение (Дополнительный)	Определяет, будут ли записаны в поля `NEAR_X` и `NEAR_Y` координаты x и y самой близкой точки ближайшего объекта. Отмечено–Местоположения будут записаны. Не отмечено–Информация о местоположениях записываться не будет. Используется по умолчанию.	Boolean
Угол (Дополнительный)	Определяет, будут ли вычислены и записаны в поле `NEAR_ANGLE` выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если для параметра `method` выбран метод `PLANAR`, угловое направление будет принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если для параметра `method` используется метод `GEODESIC`, угол будет находиться в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад. Отмечено–Ближайший угол будет вычисляться и записываться в поле `NEAR_ANGLE`. Не отмечено–Ближайший угол не будет вычисляться и записываться в поле `NEAR_ANGLE`. Используется по умолчанию.	Boolean
Метод (Дополнительный)	Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Рекомендуется использовать метод Геодезический, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область. Плоскостной–Между объектами будут вычисляться расстояния на плоскости. Используется по умолчанию. Геодезический–Между объектами будут вычисляться геодезические расстояния. Этот метод учитывает кривизну сфероида и корректно обрабатывает данные вблизи полюсов и международной линии перемены дат.	String
Имена полей (Дополнительный)	Имена атрибутивных полей, добавляемых в процессе обработки. Если этот параметр не используется, либо любые поля, которые будут добавлены, исключаются из параметра, то будут использоваться имена полей по умолчанию. По умолчанию всегда добавляются поля `NEAR_FID` и `NEAR_DIST`, а поля `NEAR_X` и `NEAR_Y` будут добавлены, когда отмечен параметр Местоположение, поле `NEAR_ANGLE` будет добавлено, когда отмечен параметр Угол, а поле `NEAR_FC` будет добавлено при использовании нескольких входных данных. При необходимости, если имеется несколько значений параметра Ближайшие объекты, укажите столбец `Near Features`, чтобы обозначить исходные данные, по которым будет определяться это поле. Столбцы таблицы значений: Property–The property type. Feature ID–The object ID of the feature that is nearest will be added. Distance–The distance to the feature that is nearest will be added. Location x-coordinate–The x-coordinate of the feature that is nearest will be added. Location y-coordinate–The y-coordinate of the feature that is nearest will be added. Angle–The angle to the feature that is nearest will be added. Feature class–The name of the feature class with the nearest feature will be added. Field Name–The name of the attribute field to add to contain the specified Near property. Near Features–The near features that the field values will be based on.	Value Table
Единицы измерения расстояния (Дополнительный)	Задает единицы измерения значений для поля `NEAR_DIST`. Если единицы измерения не заданы, значения в поле `NEAR_DIST` будут храниться в единицах измерения системы координат входных объектов. Если входные данные хранятся в географической системе координат и используется геодезический метод, единицами в поле `NEAR_DIST` будут метры. Километры–Единицами измерения будут километры. Метры–Единицами измерения будут метры. Международные морские мили–Единицами измерения будут международные морские мили. Сухопутные мили–Единицами измерения будут сухопутные мили. Международные ярды–Единицами измерения будут международные ярды. Международные футы–Единицами измерения будут международные футы. Геодезические морские мили США–Единицами измерения будут морские мили США. Геодезические мили США–Единицами измерения будут мили США. Геодезические ярды США–Единицами измерения будут ярды США. Геодезические футы США–Единицами измерения будут геодезические футы США.	String
Сопоставление полей (Дополнительный)	Пары полей из входных и ближайших объектов, которые будут использоваться для сопоставления атрибутов. При расчете близких объектов будут использоваться только те близкие объекты, значения сопоставляемых полей которых совпадают со значениями входных объектов. Столбцы таблицы значений: Input Fields–Fields from the input features that will be used for attribute matching. Near Fields–Fields from the near features that will be used for attribute matching.	Value Table

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

Подпись	Объяснение	Тип данных
Обновленные входные объекты	Обновленные входные объекты	Feature Layer

arcpy.analysis.Near(in_features, near_features, {search_radius}, {location}, {angle}, {method}, {field_names}, {distance_unit}, {match_fields})

Имя	Объяснение	Тип данных
in_features	Входные объекты могут быть точками, полилиниями, полигонами или мультиточками.	Feature Layer
near_features [near_features,...]	Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу будет добавлено поле `NEAR_FC`, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Один и тот же класс объектов или слой можно использовать как в качестве входных объектов, так и в качестве ближайших объектов.	Feature Layer
search_radius (Дополнительный)	Радиус, который будет использоваться для поиска ближайших объектов. Если значение не указано, в вычисления будут включены все ближайшие объекты. Если расстояние введено, но единица измерения не задана или неизвестна, будут использоваться единицы системы координат входных объектов. Если используется опция `GEODESIC` для параметра `method`, используйте линейные единицы измерения, такие как километры или мили.	Linear Unit
location (Дополнительный)	Определяет, будут ли записаны в поля `NEAR_X` и `NEAR_Y` координаты x и y самой близкой точки ближайшего объекта. `LOCATION`–Местоположения будут записаны. `NO_LOCATION`–Информация о местоположениях записываться не будет. Используется по умолчанию.	Boolean
angle (Дополнительный)	Определяет, будут ли вычислены и записаны в поле `NEAR_ANGLE` выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если для параметра `method` выбран метод `PLANAR`, угловое направление будет принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если для параметра `method` используется метод `GEODESIC`, угол будет находиться в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад. `ANGLE`–Ближайший угол будет вычисляться и записываться в поле `NEAR_ANGLE`. `NO_ANGLE`–Ближайший угол не будет вычисляться и записываться в поле `NEAR_ANGLE`. Используется по умолчанию.	Boolean
method (Дополнительный)	Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Рекомендуется использовать метод `GEODESIC`, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область. `PLANAR`–Между объектами будут вычисляться расстояния на плоскости. Используется по умолчанию. `GEODESIC`–Между объектами будут вычисляться геодезические расстояния. Этот метод учитывает кривизну сфероида и корректно обрабатывает данные вблизи полюсов и международной линии перемены дат.	String
field_names [[property, fieldname],...] (Дополнительный)	Имена атрибутивных полей, добавляемых в процессе обработки. Если этот параметр не используется, либо любые поля, которые будут добавлены, исключаются из параметра, то будут использоваться имена полей по умолчанию. По умолчанию всегда добавляются поля `NEAR_FID` и `NEAR_DIST`, а поля `NEAR_X` и `NEAR_Y` будут добавлены, если значение параметра `location` - `LOCATION`, поле `NEAR_ANGLE` будет добавлено, если значение параметра `angle` - `ANGLE`, а поле `NEAR_FC` будет добавлено при использовании нескольких входных данных. При необходимости, если имеется несколько значений параметра `near_features`, укажите класс пространственных объектов или векторный слой, чтобы обозначить исходные данные, по которым будет определяться это поле. Столбцы таблицы значений: `Property`–The property type. `NEAR_FID`–The object ID of the feature that is nearest will be added. `NEAR_DIST`–The distance to the feature that is nearest will be added. `NEAR_X`–The x-coordinate of the feature that is nearest will be added. `NEAR_Y`–The y-coordinate of the feature that is nearest will be added. `NEAR_ANGLE`–The angle to the feature that is nearest will be added. `NEAR_FC`–The name of the feature class with the nearest feature will be added. `Field Name`–The name of the attribute field to add to contain the specified Near property. `Near Features`–The near features that the field values will be based on.	Value Table
distance_unit (Дополнительный)	Задает единицы измерения значений для поля `NEAR_DIST`. Если единицы измерения не заданы, значения в поле `NEAR_DIST` будут храниться в единицах измерения системы координат входных объектов. Если входные данные хранятся в географической системе координат и используется геодезический метод, единицами в поле `NEAR_DIST` будут метры. `Kilometers`–Единицами измерения будут километры. `Meters`–Единицами измерения будут метры. `NauticalMilesInt`–Единицами измерения будут международные морские мили. `MilesInt`–Единицами измерения будут сухопутные мили. `YardsInt`–Единицами измерения будут международные ярды. `FeetInt`–Единицами измерения будут международные футы. `NauticalMiles`–Единицами измерения будут морские мили США. `Miles`–Единицами измерения будут мили США. `Yards`–Единицами измерения будут ярды США. `Feet`–Единицами измерения будут геодезические футы США.	String
match_fields [[input_field, near_field],...] (Дополнительный)	Пары полей из входных и ближайших объектов, которые будут использоваться для сопоставления атрибутов. При расчете близких объектов будут использоваться только те близкие объекты, значения сопоставляемых полей которых совпадают со значениями входных объектов. Столбцы таблицы значений: `Input Fields`–Fields from the input features that will be used for attribute matching. `Near Fields`–Fields from the near features that will be used for attribute matching.	Value Table

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

Имя	Объяснение	Тип данных
out_feature_class	Обновленные входные объекты	Feature Layer

Пример кода

Пример 1 Near (окно Python)

Пример скрипта окна Python для использования функции Near в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/city.gdb"

# Find the nearest road from each house
arcpy.analysis.Near('houses', 'roads')

Пример 2 Near (автономный скрипт)

В следующем скрипте Python показано, как используется функция Near в автономном скрипте.

# Name: Near.py
# Description: Finds nearest features from input feature class to near feature class.

import arcpy

# Set workspace environment
arcpy.env.workspace = "C:/data/city.gdb"

try:
    # set local variables
    in_features = "houses"
    near_features = "parks"

    # find features only within search radius
    search_radius = "5000 Meters"

    # find location nearest features
    location = "LOCATION"

    # avoid getting angle of neares features
    angle = "NO_ANGLE"

    # run the function
    arcpy.analysis.Near(in_features, near_features, search_radius, location, angle)

    # get geoprocessing messages
    print(arcpy.GetMessages())

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as err:
    print(err.args[0])

Пример 3 Near (автономный скрипт)

Следующий скрипт Python демонстрирует, как конвертировать угол на ближайший объект в азимут.

# Name: near_angle_to_azimuth.py

import arcpy

# Near tool does not calculate angle in azimuths
# This script, using the output of the tool, converts the angles
# to azimuth angles.

in_table = r"C:/data/city.gdb/near_table"

angles = arcpy.da.SearchCursor(in_table, ["NEAR_ANGLE"])

azimuth_angles = []

with angles as rows:
    for row in rows:
        angle = row[0]
        if angle <= 180 and angle > 90:
            azimuth_angles.append(360.0 - (angle - 90))
        else:
            azimuth_angles.append(abs(angle - 90))

# Use these azimuth angles as necessary.

Пример 4 Near (автономный скрипт)

Следующий скрипт Python демонстрирует постобработку с полученным результатом работы функции Near. Скрипт ищет для каждого ближайшего объекта, к каким входным объектам он ближе всего.

# Name: features_closest_to_input.py

"""
    This script finds, for each input feature, a list of near feature it is closest to.
    If near features 6, 7, 10 are closest to input feature 3 then the
    resulting dictionary will have a list [6, 7, 10] as value for key 3
"""

import os
import arcpy

in_fc = r"C:\data\cities.gdb\cities_many"

# create a dictionary to hold the list of near ids for each input id
nearest_dict = dict()

with arcpy.da.SearchCursor(in_fc, ["OID@", "NEAR_FID"]) as rows:
    for row in rows:
        nearest_id = row[0]  # get OID value for that row
        input_id = row[1]    # get NEAR_FID value

        if input_id in nearest_dict:
            # if a dict key already exists, append near id to value list for that key
            nearest_dict[input_id].append(nearest_id)
        else:
            # if the key does not exist then create a new list with near id
            # and add it to the dictionary
            nearest_dict[input_id] = [nearest_id]

print(nearest_dict)

# output will look like:
# {1: [13, 28], 2: [2, 9, 14, 20, 22], 3: [11, 12, 24, 25]}

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

Экстент, Текущая рабочая область

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

Basic: Да
Standard: Да
Advanced: Да

Ближайший объект (Инструменты Анализа)

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

Иллюстрация

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

Параметры

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

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

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

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