ArcMap

Расстояние между точками

Сводка

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

Иллюстрация

Иллюстрация инструмента Расстояние между точками

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

  • Инструмент создает таблицу расстояний между двумя наборами точек. Если используется радиус поиска по умолчанию, вычисляются расстояния от всех входных точек до всех ближайших точек. Выходная таблица может быть достаточно большой. Например, если в классах входных и ближайших объектов хранится по 1000 точек, выходная таблица может содержать миллион записей.

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

  • Результаты записываются в выходную таблицу, содержащую следующую информацию:

    • INPUT_FID – идентификатор входных объектов.
    • NEAR_FID – идентификатор ближайших объектов.
    • DISTANCE – расстояние от входного до ближайшего объекта. Значения в этом поле указываются в линейных единицах измерения системы координат входных объектов.

  • И Входные объекты, и Ближайшие объекты могут быть одним и тем же набором данных. В том случае, если входной и ближайший объекты – это одна запись, этот результат будет пропущен, чтобы не сообщать, что каждый объект находится на расстоянии 0 единиц от самого себя.

Синтаксис

arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})
ПараметрОбъяснениеТип данных
in_features

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

Feature Layer
near_features

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

Feature Layer
out_table

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

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

Расстояние, в пределах которого проводится поиск потенциальных ближайших объектов. В выходной класс записываются только те ближайшие объекты, которые расположены в окружности, определяемой заданным радиусом. Если значение не задано, то есть параметр Радиус поиска оставлен пустым по умолчанию, в вычислениях участвуют все ближайшие пространственные объекты. По умолчанию для радиуса поиска используются единицы измерения, заданные для входных объектов. Эти единицы можно изменить на любые другие. Однако это не скажется на единицах измерения выходного поля DISTANCE (расстояние), которые наследуются из системы координат входных объектов.

Linear Unit

Пример кода

PointDistance, пример 1 (окно Python)

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

import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
PointDistance, пример 2 (автономный скрипт)

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

# Description: Finds distance of each near point from each input point and outputs to a table.
  
# import system modules
import arcpy
  
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
  
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)

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

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

  • Basic: Нет
  • Standard: Нет
  • Advanced: Да

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