PointGeometry

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

Объект PointGeometry – это геометрия, которая не имеет ни длины, ни площади в заданном масштабе.

Обсуждение

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

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

Вместо геометрических методов можно использовать следующие операторы:

Оператор PythonГеометрический метод

+

intersect

|

union

-

difference

^

symmetricDifference

==

equals

!=

not equals

Например, для объединения двух геометрических объектов, g3 = g1 | g2 является эквивалентом g3 = g1.union(g2).

Оператор + будет использовать тип геометрии (dimension) из первой геометрии для определения типа геометрии выходных данных.

Синтаксис

 PointGeometry  (inputs, {spatial_reference}, {has_z}, {has_m}, {has_id})
ПараметрОписаниеТип данных
inputs

A Point object used to create the object.

Point
spatial_reference

The spatial reference of the new geometry.

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

SpatialReference
has_z

Specifies whether the geometry will be z-enabled.

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

Boolean
has_m

Specifies whether the geometry will be m-enabled.

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

Boolean
has_id

Specifies whether the geometry will support point IDs.

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

Boolean

Свойства

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

ПрEsriедставление геометрии JSON в виде строки.

Подсказка:

Возвращаемая строка может быть конвертирована в словарь с помощью функции loads модуля json.

String
WKB
(только чтение)

Стандартное двоичное (well-known binary, WKB) представление для геометрии OGC. Это свойство обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов.

Bytearray
WKT
(только чтение)

Стандартное текстовое (well-known text, WKT) представление для геометрии OGC. Это свойство обеспечивает портативное представление значения геометрии в виде текстовой строки.

Любые истинные кривые в геометрии будут уплотнены в аппроксимируют кривые в строки WKT.

String
area
(только чтение)

Площадь объекта полигона. Эта область - ноль для всех остальных типов объектов.

Double
centroid
(только чтение)

Истинное положение центроида, если он расположен внутри объекта, иначе - точка надписи.

Point
extent
(чтение и запись)

Экстент геометрии.

Extent
firstPoint
(только чтение)

Первая точка координат геометрии.

Point
hasCurves
(только чтение)

Определяет, сдержит ли геометрия кривую.

Boolean
hullRectangle
(только чтение)

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

String
isMultipart
(только чтение)

Определяет, содержит ли геометрия несколько частей.

Boolean
labelPoint
(только чтение)

Точка расположения надписи. Эта точка всегда расположен внутри объекта или на нем.

Point
lastPoint
(только чтение)

Последняя координата объекта.

Point
length
(только чтение)

Длина линейного объекта. В вычислениях используется 2D декартова математика.

Для точечной и многоточечной геометрии длина будет равна нулю. Для полигональной геометрии длина будет равняться 2D длине границы.

Double
length3D
(только чтение)

3D-длина линейного объекта. В вычислениях используется 3D декартова математика.

Для точечной и многоточечной геометрии длина будет равна нулю. Для полигональной геометрии длина будет равняться 3D длине границы.

Внимание:

Операция не выполняет преобразование единиц измерения между горизонтальной и вертикальной системами координат. Предполагается, что координаты x, y и z используют одну линейную единицу измерения.

Внимание:

Это свойство доступно только для проекционных данных.

Double
partCount
(только чтение)

Количество частей пространственного объекта.

Integer
pointCount
(только чтение)

Общее количество точек объекта.

Integer
spatialReference
(только чтение)

Пространственная привязка геометрии.

SpatialReference
trueCentroid
(только чтение)

Центр тяжести пространственного объекта.

Point
type
(только чтение)

Тип геометрии: polygon, polyline, point или multipoint.

String

Обзор метода

МетодОписание
angleAndDistanceTo (other, {method})

Возвращает кортеж угла и расстояния до точки или полигона.

boundary ()

Выстраивает границы геометрии.

Оператор границ
buffer (distance)

Выстраивает полигон на заданном расстоянии от геометрии.

Оператор буфера
clip (envelope)

Строит пересечение геометрии и заданного экстента.

Оператор Clip
contains (second_geometry, {relation})

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

contains является противоположностью within.

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

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

Выстраивает геометрию минимального ограничивающего полигона, внешние углы которого выпуклые.

Оператор ConvexHull
crosses (second_geometry)

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

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

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

Возможные отношения пересечения (crosses)
difference (other)

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

Оператор разности
disjoint (second_geometry)

Указывает, что базовая и сопоставляемая геометрия не имеют общих точек.

Две геометрии пересекаются, если disjoint возвращает False.

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

Возможные отношения дизъюнктный (disjoint)
distanceTo (other)

Возвращает минимальное расстояние между двумя геометриями. Расстояние измеряться в единицах системы координат геометрии. Если геометрии пересекаются, минимальное расстояние будет равно нулю.

Обе геометрии должны иметь одинаковую проекцию.

equals (second_geometry)

Указывает, имеют ли основная и сравнительная геометрии одинаковый тип формы и определяют ли они один и то же набор точек на плоскости. Сравнение производится только в 2D; значения M и Z не учитываются.

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

Возможные отношения тождества (equals)
getGeohash (precision)

Конвертирует координаты широты и долготы PointGeometry географической системы координат в строку geohash с произвольной точностью в пределах ограничивающей рамки в гриде geohash.

getPart ({index})

Возвращает объект Array из объектов Point для определенной части геометрии, если указан индекс. Если индекс не указан, возвращается объект Array, содержащий Array из Point объектов для каждой части геометрии.

Метод getPart эквивалентен индексированию объекта; то есть, obj.getPart(0) эквивалентен obj[0].

intersect (other, dimension)

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

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

Оператор пересечения

Для ускорения процесса проверьте, не являются ли данные две геометрии disjoint, перед вызовом intersect.

move ({dx}, {dy}, {dz})

Перемещает геометрию на заданные расстояния вдоль осей x, y и z для создания новой геометрии.

overlaps (second_geometry)

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

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

Возможные отношения наложения
pointFromAngleAndDistance (angle, distance, {method})

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

projectAs (spatial_reference, {transformation_name})

Проецирует геометрию и при необходимости применяет географическую трансформацию.

Для проецирования у геометрии должна быть пространственная привязка, а не неизвестная система координат. Новая система пространственной привязки, переданная методу, определяет выходную систему координат. Если какая-либо пространственная привязка неизвестна, координаты не будут изменены. Значение z и m не меняются методом projectAs.

scale ({origin}, {sx}, {sy}, {sz})

Масштабирует геометрию из указанного источника с заданными коэффициентами по осям x, y и z для создания новой геометрии. Положение трансформированной точки (или вершины) определяется

( (x - origin_x) * scale_x + origin_x, (y - origin_y) * scale_y + origin_y, (z - origin_z) * scale_z + origin_z )

Преобразование применяется относительно начала координат, и начало координат остается неподвижным, в то время как геометрия расширяется или сжимается вокруг него. На положение и направление расширения или сжатия получаемой геометрии существенно влияет начало координат.

Ниже описываются возможные варианты начала координат и их влияние на выходные данные:

  • Начало координат находится вне геометрии (не внутри геометрии и не касается ее) - размер и положение геометрии изменятся, но геометрия сохранит относительное положение по отношению к другим геометриям, масштабированным таким же образом. Положения будут расширяться от исходной точки или сжиматься к ней.

    Начало координат находится вне геометрии

  • Началом координат является центроид геометрии (если центроид находится внутри геометрии или касается ее) - размер геометрии изменится, но ее местоположение останется привязанным к центроиду. Геометрия будет увеличиваться или уменьшаться вокруг центроида.

    Начало координат - центроид геометрии

  • Начало координат - вершина геометрии - размер геометрии изменится, но ее положение останется привязанным к выбранной вершине. Геометрия будет увеличиваться или уменьшаться по направлению к выбранной вершине.

    Начало координат - вершина геометрии

symmetricDifference (other)

Строит геометрию, являющуюся геометрическим объединением двух геометрий с вычитанием пересечения этих геометрий.

Обе входные геометрии должны быть одного типа.

оператор symmetricDifference
toCoordString (notation)

Конвертирует PointGeometry в заданную нотацию системы координат.

touches (second_geometry)

Указывает на то, что границы геометрии пересекаются.

Две геометрии соприкасаются, если пересечение геометрий не является пустым, а пересечение их внутренних частей пусто. Например, точка касается полилинии, только, если точка совпадает с одной из конечных точек полилинии.

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

Возможные отношения касания (touches)
union (other)

Строит геометрию, являющуюся теоретико-множественным объединением входных геометрий.

Обе объединяемые геометрии должны быть одного типа.

Оператор Union
within (second_geometry, {relation})

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

within является противоположностью оператора contains.

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

Возможные отношения "находится в"

Базовая геометрия находится внутри сравниваемой геометрии, если она является пересечением геометрий, и пересечение их внутренних частей не является пустым. within является оператором Клементини, за исключением случаев, когда базовая геометрия пуста.

Методы

angleAndDistanceTo (other, {method})
ПараметрОписаниеТип данных
other

The second geometry. If the geometry is a polygon, the distance is measured to the centroid of the polygon.

PointGeometry
method

The method used to measure distance.

  • GEODESICThe shortest line between any two points on the earth's surface on a spheroid (ellipsoid). One use for a geodesic line is to determine the shortest distance between two cities for an airplane's flight path. This is also known as a great circle line if based on a sphere rather than an ellipsoid.
  • GREAT_ELLIPTICThe line on a spheroid (ellipsoid) defined by the intersection at the surface by a plane that passes through the center of the spheroid and the start and endpoints of a segment. This is also known as a great circle when a sphere is used.
  • LOXODROMEThe line follows a single compass bearing, or azimuth. Great circle routes are often broken into a series of loxodromes, which simplifies navigation. This is also known as a rhumb line.
  • PLANARPlanar measurements use 2D Cartesian mathematics to calculate lengths and areas. This option is only available when measuring in a projected coordinate system and the 2D plane of that coordinate system will be used as the basis for the measurements. Planar measurements reflect the projection of geographic data onto a 2D surface, and do not account for the curvature of the earth.
  • PRESERVE_SHAPEThis type calculates the area or length of the geometry on the surface of the earth ellipsoid, for geometry defined in a projected or geographic coordinate system. This option preserves the shape of the geometry in its coordinate system.

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

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

Возвращает кортеж углов (в градусах) и расстояния (в метрах) до другой точки.

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

Границей полигона является полилиния. Границей полилинии является мультиточка, соответствующая конечным точкам линии. Границей точки или мультиточки является пустая точка или мультиточка.

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

Буферное расстояние.

Буферное расстояние измеряется в тех же единицах, что и буферизуемая геометрия.

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

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

Полигональная геометрия с буферизацией.

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

An Extent object used to define the clip extent.

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

Выходная геометрия вырезается до указанного экстента.

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

Вторая геометрия.

Object
relation

Типы пространственных отношений.

  • BOUNDARY У отношений нет ограничений для внутренних частей или границ.
  • CLEMENTINI Внутренние части геометрии должны пересекаться. Указание CLEMENTINI эквивалентно None. Используется по умолчанию.
  • PROPER Границы геометрии не должны пересекаться.

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

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

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

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

Получившаяся геометрия. Выпуклой оболочкой точки является сама эта точка.

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

Вторая геометрия.

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

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

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

Вторая геометрия.

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

Получившаяся геометрия.

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

Вторая геометрия.

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

Возвращенное логическое значение True указывает, что у двух геометрий нет общих точек.

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

Вторая геометрия.

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

Расстояние между двумя геометриями.

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

Вторая геометрия.

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

Полученное логическое значение Истина (True) указывает на то, что обе эти геометрии имеют одинаковый тип формы и определяют один и тот же набор точек на плоскости.

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

Длина точности хеш-строки, возвращаемой для PointGeometry. Минимальная длина 1, максимальная 20. По умолчанию – 8.

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

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

getGeohash возвращает строку geohash, основанную на координатах широты-долготы входной точечной геометрии и длине точности.

Для возвращения точного geohash пространственная привязка точечной геометрии должна быть в географической системе координат.


import arcpy

# Spatial reference set to GCS_WGS_1984
spatial_reference = arcpy.SpatialReference(4326)
pnt = arcpy.Point(-88.236, 40.096)
pnt_geometry = arcpy.PointGeometry(pnt, spatial_reference)
print(pnt_geometry.getGeohash(6))  # dp1k05
getPart ({index})
ПараметрОписаниеТип данных
index

The index position of the geometry.

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

Полученный в результате объект Array.

intersect (other, dimension)
ПараметрОписаниеТип данных
other

Вторая геометрия.

Object
dimension

Топологическая размерность (тип формы) итоговой геометрии.

  • 1Геометрия с нулевой размерностью (точка или мультиточка).
  • 2Одномерная геометрия (полилиния).
  • 4Двумерная геометрия (полигон).
Integer
Возвращаемое значение
Тип данныхОписание
Object

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

move ({dx}, {dy}, {dz})
ПараметрОписаниеТип данных
dx

The distance the geometry will be moved along the x-axis.

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

Double
dy

The distance the geometry will be moved along the y-axis.

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

Double
dz

The distance the geometry will be moved along the z-axis. The geometry must be z-aware and have z-values.

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

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

Выходная геометрия, перемещенная на заданные расстояния вдоль осей x, y и z.

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

Вторая геометрия.

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

Полученное логическое значение True указывает, что пересечение двух этих геометрий имеет такой же размер, как одна из входных геометрий.

pointFromAngleAndDistance (angle, distance, {method})
ПараметрОписаниеТип данных
angle

Угол поворота до возвращённой точки в градусах.

Double
distance

Расстояние в единицах измерения пространственной привязки для возвращаемой точки.

Double
method

На измерения PLANAR влияет проецирование географических данных на двухмерную поверхность (т.е. кривизна земной поверхности не учитывается). В качестве альтернативы можно выбрать типы измерений GEODESIC, GREAT_ELLIPTIC, LOXODROME или PRESERVE_SHAPE, если необходимо.

  • GEODESICКратчайшее расстояние между двумя любыми точками поверхности земли на сфероиде (эллипсоиде). Одна из областей применения геодезических линий – определение кратчайшего расстояния между двумя городами для траектории полета самолета. Также называется ортодромической линией, если в основе измерений лежит сфероид или эллипсоид.
  • GREAT_ELLIPTICЛиния на сфероиде (эллипсоиде), определяемая пересечением поверхности плоскостью, проходящей через центр сфероида, начальную и конечную точки сегмента. При использовании на сфере также называется ортодромией.
  • LOXODROMEЛоксодромия не является кратчайшим расстоянием между двумя точками, а задает линию постоянного пеленга или азимута. Маршруты ортодромии часто разбиваются на ряд линий локсодромии, что упрощает навигацию. Также называется локсодромой.
  • PLANARПлоскостные измерения используют двухмерную (2D) декартову математику для вычисления длин и площадей. Эта опция доступна только тогда, когда измерения производятся в системе координат проекции, и двухмерная плоскость этой системы координат будет использоваться как основание для измерений.
  • PRESERVE_SHAPEЭтот тип вычисляет площадь или длину геометрии по эллипсоиду земной поверхности для геометрии, заданной в системе координат проекции или географической системе координат. Эта опция сохраняет форму геометрии в своей системе координат.

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

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

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

projectAs (spatial_reference, {transformation_name})
ПараметрОписаниеТип данных
spatial_reference

The spatial reference of the projected geometry. This can be a SpatialReference object or the coordinate system name.

SpatialReference
transformation_name

The geotransformation name.

With ArcGIS Pro, if you do not specify a transformation, none will be applied. With ArcGIS Server, if you do not specify a transformation, a fallback transformation will be applied.

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

Геометрия после проецирования.

scale ({origin}, {sx}, {sy}, {sz})
ПараметрОписаниеТип данных
origin

The origin of the transformation. The argument can be either an arcpy.Point object or an arcpy.PointGeometry object.

The default origin, arcpy.Point(0.0, 0.0, 0.0), will usually be located outside the target geometry.

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

Point
sx

The factor that will be used to scale the geometry along the x-axis.

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

Double
sy

The factor that will be used to scale the geometry along the y-axis.

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

Double
sz

The factor that will be used to scale the geometry along the z-axis. The geometry must be z-aware and have z-values.

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

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

Выходная геометрия масштабируется от указанного начала координат с заданными коэффициентами по осям x, y и z.

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

Вторая геометрия.

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

Получившаяся геометрия.

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

The coordinate system notation to be generated.

  • DD Decimal degrees is used, for example, 34.05719570N 117.19647020W.
  • DDM Degrees decimal minutes is used, for example, 34 03.43174200N 117 11.78821200W.
  • DMS Degree Minute Seconds, is used, for example, 34 03 25.90452000N 117 11 47.29272000W.
  • GARS Global Area Reference System is used, for example, 126LJ47. It is based on latitude and longitude, and it divides and subdivides the world into cells.
  • GEOREF World Geographic Reference System is used, for example, EJCE4821203432.
  • MGRS Military Grid Reference System is used, for example, 11SMT8186968515.
  • USNG United States National Grid is used, for example, 11S MT 81869 68515.
  • UTM Universal Transverse Mercator is used, for example, 11S 481868 3768515. It is based on zone number, MGRS latitude band, and the easting and northing planar coordinate pair in that zone.
  • UTMNS Universal Transverse Mercator (no spaces) is used, for example, 11N4818683768515. It is based on zone number, hemisphere designator, and the easting and northing planar coordinate pair in that zone.
None
Возвращаемое значение
Тип данныхОписание
String

Точка в заданной нотации системы координат.

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

Вторая геометрия.

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

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

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

Вторая геометрия.

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

Получившаяся геометрия.

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

Вторая геометрия.

Object
relation

Типы пространственных отношений.

  • BOUNDARY У отношений нет ограничений для внутренних частей или границ.
  • CLEMENTINI Внутренние части геометрии должны пересекаться. Указание CLEMENTINI эквивалентно None. Используется по умолчанию.
  • PROPER Границы геометрии не должны пересекаться.

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

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

Возвращенное логическое значение True указывает, что данная геометрия содержится внутри второй геометрии.

Пример кода

Пример использования PointGeometry

Создание точечного класса объектов с нуля.

import arcpy

# A list of coordinate pairs
pointList = [[1, 2], [3, 5], [7, 3]]

# Create an empty Point object
point = arcpy.Point()

# A list to hold the PointGeometry objects
pointGeometryList = []

# For each coordinate pair, populate the Point object and create a new 
# PointGeometry object
for pt in pointList:
    point.X = pt[0]
    point.Y = pt[1]

    pointGeometry = arcpy.PointGeometry(point)
    pointGeometryList.append(pointGeometry)

# Create a copy of the PointGeometry objects, by using pointGeometryList as 
# input to the CopyFeatures tool.
arcpy.CopyFeatures_management(pointGeometryList, "c:/geometry/a.gdb/points")

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