Point

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

Представление пары x,y, возможно, с измерением, высотой и ID.

Обсуждение

Объект Point не содержит информацию о пространственной привязке и обычно используется для построения других объектов геометрии, в частности, объектов PointGeometry, Polyline, Polygon и Multipoint. В примере ниже объект Point используется для создания объекта PointGeometry.

pt = arcpy.Point(-12683890.6, 5811151.5)
pt_geometry = arcpy.PointGeometry(pt, spatial_reference=arcpy.SpatialReference(3857))

Синтаксис

 Point ({X}, {Y}, {Z}, {M}, {ID})
ПараметрОписаниеТип данных
X

The x-coordinate of the point.

(Значение по умолчанию — 0.0)

Double
Y

The y-coordinate of the point.

(Значение по умолчанию — 0.0)

Double
Z

The z-coordinate of the point.

(Значение по умолчанию — None)

Double
M

The m-value of the point.

(Значение по умолчанию — None)

Double
ID

The shape ID of the point.

(Значение по умолчанию — 0)

Integer

Свойства

СвойствоОписаниеТип данных
ID
(чтение и запись)

Целое число используется для однозначной идентификации точки.

Integer
M
(чтение и запись)

Значение измерения точки.

Double
X
(чтение и запись)

Горизонтальная координата точки.

Double
Y
(чтение и запись)

Вертикальная координата точки.

Double
Z
(чтение и запись)

Значение высоты точки.

Double

Обзор метода

МетодОписание
clone (point_object)

Клонируйте объект Point.

contains (second_geometry, {relation})

Указывает, содержит ли базовая геометрия геометрию сравнения.

Метод contains противоположен методу within.

На этом рисунке показаны только отношения True.

Возможно содержит отношения

crosses (second_geometry)

Указывает, пересекаются ли две геометрии в геометрии меньшего типа формы.

Две полилинии пересекаются, если у них есть только общие точки, по крайней мере одна из которых не является конечной точкой. Полилиния и полигон пересекаются, если они имеют общую полилинию или точку (для вертикальной линии) внутри полигона, которая не эквивалентна всей полилинии.

На этом рисунке показаны только отношения True.

Возможные перекрестные отношения

disjoint (second_geometry)

Определяет, имеют ли базовая и сравнительная геометрии общие точки.

Когда этот метод возвращает 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

A Point object.

Point
contains (second_geometry, {relation})
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
relation

Specifies the spatial relationship type that will be used.

  • BOUNDARYThe relationship has no restrictions for interiors or boundaries.
  • CLEMENTINI Interiors of geometries must intersect. This option is equivalent to specifying None. This is the default.
  • PROPER Boundaries of geometries must not intersect.

(Значение по умолчанию — None)

String
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, содержит ли данная геометрия вторую геометрию.

crosses (second_geometry)
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, пересекаются ли две геометрии в геометрии меньшего типа формы.

disjoint (second_geometry)
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, имеют ли две геометрии общие точки.

equals (second_geometry)
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, имеют ли две геометрии один и тот же тип формы и определяют ли они один и тот же набор точек на плоскости.

overlaps (second_geometry)
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, имеет ли пересечение двух геометрий ту же размерность, что и одна из входных геометрий.

touches (second_geometry)
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, пересекаются ли границы геометрий.

within (second_geometry, {relation})
ПараметрОписаниеТип данных
second_geometry

A second geometry.

Object
relation

Specifies the spatial relationship type that will be used.

  • BOUNDARYThe relationship has no restrictions for interiors or boundaries.
  • CLEMENTINI Interiors of geometries must intersect. This option is equivalent to specifying None. This is the default.
  • PROPER Boundaries of geometries must not intersect.

(Значение по умолчанию — None)

String
Возвращаемое значение
Тип данныхОписание
Boolean

Возвращает, находится ли базовая геометрия в пределах геометрии сравнения.

Пример кода

Пример объекта Point

Создайте объект Point и выведите некоторые его свойства.

import arcpy

# Create point object
point = arcpy.Point(2000, 2500)

# Print point properties
print("Point properties:")
print(" X:  {0}".format(point.X))
print(" Y:  {0}".format(point.Y))
Point, пример 2

Проверьте объекты Point, возвращаемые объектом Polygon.

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))

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