Краткая информация
Объект point часто используется с курсорами. Точечные объекты вместо массива точечных объектов возвращают единственный объект point. Все другие типы объектов – полигоны, полилинии и мультиточки – возвращают массив точечных объектов или, если объект имеет несколько частей, выходной массив содержит массивы точечных объектов.
Описание
Point не является классом геометрии, но обычно используется для построения геометрии. В приведенном ниже примере, Point используется для создания объекта PointGeometry.
point = arcpy.Point(25282, 43770)
ptGeometry = arcpy.PointGeometry(point)
Синтаксис
Point ({X}, {Y}, {Z}, {M}, {ID})
Параметр | Объяснение | Тип данных |
X | X-координата точки. (Значение по умолчанию — 0.0) | Double |
Y | Y-координата точки. (Значение по умолчанию — 0.0) | Double |
Z | Z-координата точки. (Значение по умолчанию — None) | Double |
M | M-значение точки. (Значение по умолчанию — None) | Double |
ID | ID формы точки. (Значение по умолчанию — 0) | Integer |
Свойства
Свойство | Объяснение | Тип данных |
ID (чтение и запись) | Целое число, используемое для уникальной идентификации точки | Integer |
M (чтение и запись) | Значение измерения в точке. | Double |
X (чтение и запись) | Горизонтальная координата точки. | Double |
Y (чтение и запись) | Вертикальная координата точки. | Double |
Z (чтение и запись) | Значение высоты точки. | Double |
Обзор метода
Метод | Объяснение |
clone (point_object) | Клонирует точечный объект. |
contains (second_geometry, {relation}) | Показывает, содержит ли базовая геометрия сравнение геометрии. contains является противоположностью within. На этом рисунке показаны только отношения True. |
crosses (second_geometry) | Указывает на то, что две геометрии пересекаются в геометрии меньшего типа формы. Две полилинии пересекаются, если только они имеют точки соприкосновения, по крайней мере, одна из которых не является конечной точкой. Полилиния и полигон пересекаются, если они имеют общую линию или точку (для вертикальной линии) внутри полигона, который не эквивалентен всей полилинии. На этом рисунке показаны только отношения True. |
disjoint (second_geometry) | Указывает, что базовая и сопоставляемая геометрия не имеют общих точек. Две геометрии пересекаются, если disjoint возвращает False. На этом рисунке показаны только отношения True. |
equals (second_geometry) | Указывает, имеют ли основная и сравнительная геометрии одинаковый тип формы и определяют ли они один и то же набор точек на плоскости. Сравнение производится только в 2D; значения M и Z не учитываются. На этом рисунке показаны только отношения True. |
overlaps (second_geometry) | Показывает, если пересечение двух геометрий имеет тот же тип формы, что и входная геометрия и не эквивалентно любой из входных геометрий. На этом рисунке показаны только отношения True. |
touches (second_geometry) | Указывает на то, что границы геометрии пересекаются. Две геометрии соприкасаются, если пересечение геометрий не является пустым, а пересечение их внутренних частей пусто. Например, точка касается полилинии, только, если точка совпадает с одной из конечных точек полилинии. На этом рисунке показаны только отношения True. |
within (second_geometry, {relation}) | Показывает, если базовая геометрия находится внутри сравнения геометрии. within является противоположностью оператора contains. На этом рисунке показаны только отношения True. Базовая геометрия находится внутри сравниваемой геометрии, если она является пересечением геометрий, и пересечение их внутренних частей не является пустым. within является оператором Клементини, за исключением случаев, когда базовая геометрия пуста. |
Методы
clone (point_object)
Параметр | Объяснение | Тип данных |
point_object | Точечный объект. | Point |
contains (second_geometry, {relation})
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
relation | Типы пространственных отношений.
(Значение по умолчанию — None) | String |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что данная геометрия содержит вторую геометрию. |
crosses (second_geometry)
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает пересечение двух геометрий в геометрии меньшего типы формы. |
disjoint (second_geometry)
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что у двух геометрий нет общих точек. |
equals (second_geometry)
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
Возвращаемое значение
Тип данных | Объяснение |
Boolean |
Полученное логическое значение Истина (True) указывает на то, что обе эти геометрии имеют одинаковый тип формы и определяют один и тот же набор точек на плоскости. |
overlaps (second_geometry)
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Полученное логическое значение True указывает, что пересечение двух этих геометрий имеет такой же размер, как одна из входных геометрий. |
touches (second_geometry)
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что границы геометрий пересекаются. |
within (second_geometry, {relation})
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
relation | Типы пространственных отношений.
(Значение по умолчанию — None) | String |
Возвращаемое значение
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что данная геометрия содержится внутри второй геометрии. |
Пример кода
Point, пример
Создает объект Point и отображает его свойства.
import arcpy
# Create point object
point = arcpy.Point(2000, 2500)
# Print point properties
print("Point properties:")
print(" ID: {0}".format(point.ID))
print(" X: {0}".format(point.X))
print(" Y: {0}".format(point.Y))
Point, пример 2
Изучает объекты point в полигональном объекте array, возвращенном из объекта geometry.
import arcpy
# Create cursor to retrieve Hawaii shape
feature_class = "c:/data/Hawaii.shp"
cursor = arcpy.da.SearchCursor(feature_class, ["SHAPE@"])
for row in cursor:
# Get the geometry object from the shape field
print("Number of Hawaiian islands: {0}".format(row[0].partCount))
# GetPart returns an array of point objects for each part.
for island in row[0].getPart():
print("Vertices in island: {0}".format(island.count))
for point in island:
print("X: {0}, Y: {1})".format(point.X, point.Y))