Geometry—ArcGIS Pro | Документация

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

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

Обсуждение

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

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

Синтаксис

 Geometry (geometry, inputs, {spatial_reference}, {has_z}, {has_m})

Параметр	Описание	Тип данных
geometry	Тип геометрии: точка, полигон, полилиния или мультиточка.	String
inputs	Координаты, используемые для создания объекта. Тип данных может быть Point или Array объектов.	Object
spatial_reference	Пространственная привязка новой геометрии. (Значение по умолчанию — None)	SpatialReference
has_z	Статус Z: True для геометрии, если Z используются, и False – если нет. (Значение по умолчанию — False)	Boolean
has_m	Статус M: True для геометрии, если M используются, и False– если нет. (Значение по умолчанию — False)	Boolean

Свойства

Свойство	Описание	Тип данных
JSON (только чтение)	Возвращает представление геометрии Esri JSON в виде строки. Подсказка: Возвращаемая строка может быть конвертирована в словарь с помощью функции loads модуля json.	String
WKB (только чтение)	Возвращает WKB-представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов.	Bytearray
WKT (только чтение)	Возвращает WKT-представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде текстовой строки. Любые истинные кривые в геометрии будут уплотнены в аппроксимируют кривые в строки WKT.	String
area (только чтение)	Площадь объекта полигона. Ноль для всех остальных типов объектов.	Double
centroid (только чтение)	Возвращается истинное положение центроида, если он расположен внутри объекта, иначе возвращается точка надписи.	Point
extent (чтение и запись)	Экстент геометрии.	Extent
firstPoint (только чтение)	Первая точка координат геометрии.	Point
hasCurves (только чтение)	Возвращает True, если геометрия содержит кривую.	Boolean
hullRectangle (только чтение)	Строка пар координат прямоугольника, образующего выпуклую оболочку, разделенная пробелами.	String
isMultipart (только чтение)	Возвращает True, если число частей этой геометрии более одного.	Boolean
labelPoint (только чтение)	Точка расположения надписи. 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 (только чтение)	Тип геометрии: полигон, полилиния, точка, мультиточка, мультипатч, размер или аннотация.	String

Обзор метода

Метод	Описание
angleAndDistanceTo (other, {method})	Возвращает кортеж угла и расстояния до точки или полигона.
boundary ()	Выстраивает границы геометрии.
buffer (distance)	Выстраивает полигон на заданном расстоянии от геометрии.
clip (envelope)	Строит пересечение геометрии и заданного экстента.
contains (second_geometry, {relation})	Показывает, содержит ли базовая геометрия сравнение геометрии. contains является противоположностью within. На этом рисунке показаны только отношения True.
convexHull ()	Выстраивает геометрию минимального ограничивающего полигона, внешние углы которого выпуклые.
crosses (second_geometry)	Указывает на то, что две геометрии пересекаются в геометрии меньшего типа формы. Две полилинии пересекаются, если только они имеют точки соприкосновения, по крайней мере, одна из которых не является конечной точкой. Полилиния и полигон пересекаются, если они имеют общую линию или точку (для вертикальной линии) внутри полигона, который не эквивалентен всей полилинии. На этом рисунке показаны только отношения True.
cut (cutter)	Разбивает эту геометрию на части слева от режущей полилинии и справа от нее. При разрезании полилиния или полигон разбивается в месте пересечения с режущей полилинией. Каждая часть классифицируется как слева или справа от режущей линии. Данная классификация опирается на ориентацию режущей линии. Части целевой полилинии, которые не пересекают разрезающую полилинию, возвращаются как часть справа от результата для входной полилинии. Если геометрия не разрезается, то геометрия слева будет пустой (None).
densify (type, distance, {deviation})	Создает новую геометрию с добавленными вершинами.
difference (other)	Выстраивает геометрию, состоящую из региона, уникального для базовой геометрии, но не являющуюся частью другой геометрии. Ниже иллюстрируются результаты, где красный полигон является исходной геометрией.
disjoint (second_geometry)	Указывает, что базовая и сопоставляемая геометрия не имеют общих точек. Две геометрии пересекаются, если disjoint возвращает False. На этом рисунке показаны только отношения True.
distanceTo (other)	Возвращает минимальное расстояние между двумя геометриями. Расстояние измеряться в единицах системы координат геометрии. Если геометрии пересекаются, минимальное расстояние будет равно нулю. Обе геометрии должны иметь одинаковую проекцию.
equals (second_geometry)	Указывает, имеют ли основная и сравнительная геометрии одинаковый тип формы и определяют ли они один и то же набор точек на плоскости. Сравнение производится только в 2D; значения M и Z не учитываются. На этом рисунке показаны только отношения True.
generalize (max_offset)	Создает новую упрощенную геометрию, используя заданное значение максимального допуска смещения.
getArea ({type}, {units})	Возвращает площадь пространственного объекта, определяемую по типу измерения.
getLength ({measurement_type}, {units})	Возвращает длину пространственного объекта, определяемую по типу измерения.
getPart ({index})	Возвращает объект Array из объектов Point для определенной части геометрии, если указан индекс. Если индекс не указан, возвращается объект Array, содержащий Array из Point объектов для каждой части геометрии. Метод getPart эквивалентен индексированию объекта; то есть, obj.getPart(0) эквивалентен obj[0].
intersect (other, dimension)	Строит геометрию, являющуюся геометрическим пересечением двух входных геометрий. Для создания различных типов формы можно использовать разную размерность. Пересечением двух геометрий с одинаковым типом формы будет геометрия, содержащая только перекрывающиеся области исходных геометрий. Для ускорения процесса проверьте, не являются ли данные две геометрии disjoint, перед вызовом intersect.
measureOnLine (in_point, {use_percentage})	Возвращает измерение расстояния от начальной точки этой линии до in_point.
overlaps (second_geometry)	Показывает, если пересечение двух геометрий имеет тот же тип формы, что и входная геометрия и не эквивалентно любой из входных геометрий. На этом рисунке показаны только отношения True.
pointFromAngleAndDistance (angle, distance, {method})	Возвращает точку при заданном угле в градусах и расстоянии в единицах пространственной привязки, с использованием определенного типа измерения.
positionAlongLine (value, {use_percentage}, {geodesic})	Возвращает точку на линии, расположенную на заданном расстоянии от ее начала.
projectAs (spatial_reference, {transformation_name})	Проецирует геометрию и при необходимости применяет географическую трансформацию. Для проецирования геометрия должна иметь пространственную привязку, а не неизвестную систему координат. Новая система пространственной привязки, переданная методу, определяет выходную систему координат. Если какая-либо пространственная привязка неизвестна, координаты не будут изменены. Значение z и m не меняются методом projectAs.
queryPointAndDistance (in_point, {as_percentage})	Находит точку на полилинии, ближайшую к in_point, и расстояние между этими точками. Также возвращает информацию о стороне линии, на которой находится in_point, а также расстояние до ближайшей точки.
segmentAlongLine (start_measure, end_measure, {use_percentage})	Возвращает Polyline между начальным и конечным измерениями. Подобно Polyline.positionAlongLine, но будет возвращать сегмент полилинии между двумя точками на полилинии вместо одной.
snapToLine (in_point)	Возвращает новую точку на основе in_point, замкнутой на этой геометрии.
symmetricDifference (other)	Строит геометрию, являющуюся геометрическим объединением двух геометрий с вычитанием пересечения этих геометрий. Обе входные геометрии должны быть одного типа.
touches (second_geometry)	Указывает на то, что границы геометрии пересекаются. Две геометрии соприкасаются, если пересечение геометрий не является пустым, а пересечение их внутренних частей пусто. Например, точка касается полилинии, только, если точка совпадает с одной из конечных точек полилинии. На этом рисунке показаны только отношения True.
union (other)	Строит геометрию, являющуюся теоретико-множественным объединением входных геометрий. Обе объединяемые геометрии должны быть одного типа.
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. GEODESIC—The 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_ELLIPTIC—The 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. LOXODROME—The 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. PLANAR—Planar 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_SHAPE—This 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

Параметр

Описание

Тип данных

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.

GEODESIC—The 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_ELLIPTIC—The 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.
LOXODROME—The 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.
PLANAR—Planar 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_SHAPE—This 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

Параметр

Описание

Тип данных

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

Параметр

Описание

Тип данных

second_geometry

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

Object

relation

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

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

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

String

Возвращаемое значение

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

convexHull ()

Возвращаемое значение

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

crosses (second_geometry)

Параметр	Описание	Тип данных
second_geometry	Вторая геометрия.	Object

Возвращаемое значение

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

cut (cutter)

Параметр	Описание	Тип данных
cutter	Геометрия разрезающей полилинии	PolyLine

Возвращаемое значение

Тип данных	Описание
Geometry	Перечень двух геометрий

densify (type, distance, {deviation})

Параметр	Описание	Тип данных
type	Тип сгущения, DISTANCE, ANGLE или GEODESIC. DISTANCE—Создаёт новый объект, который является кусочно-линейной аппроксимацией входного объекта. ANGLE—Создаёт новый объект, который является кусочно-линейной аппроксимацией входного объекта. Вершины вводятся в точках, где угол между касательными в этих точках задан angle. GEODESIC—Уплотняет сегменты между входными вершинами и изменяет их форму так, чтобы выходные сегменты следовали наикратчайшему наземному пути, соединяющему входные вершины.	String
distance	Максимальное расстояние между вершинами. Фактическое расстояние между вершинами, как правило, будет меньше, чем максимальное расстояние, так как новые вершины будут равномерно распределены вдоль первоначального сегмента. При использовании type для DISTANCE или ANGLE, расстояние будет измеряться в единицах измерения системы координат геометрии. При использовании type для GEODESIC, расстояние будет измеряться в метрах.	Double
deviation	Уплотнение использует прямые линии для аппроксимации кривых. Вы используете deviation для контроля точности данной аппроксимации. Отклонение - это максимальное расстояние между новым сегментом и исходной кривой. Чем меньше значение, тем больше сегментов потребуется для аппроксимации кривой. При использовании type для DISTANCE, отклонение будет измеряться в единицах измерения системы координат геометрии. При использовании type для ANGLE, отклонение будет измеряться в радианах. При использовании type для GEODESIC, отклонение не используется.	Double

Возвращаемое значение

Тип данных	Описание
Geometry	Уплотнённая геометрия.

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) указывает на то, что обе эти геометрии имеют одинаковый тип формы и определяют один и тот же набор точек на плоскости.

generalize (max_offset)

Параметр	Описание	Тип данных
max_offset	Максимальный допуск смещения.	Double

Возвращаемое значение

Тип данных	Описание
Geometry	Упрощенная геометрия.

getArea ({type}, {units})

Параметр	Описание	Тип данных
type	The method used to measure area. GEODESIC—The 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_ELLIPTIC—The 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. LOXODROME—The 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. PLANAR—Planar 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_SHAPE—This 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
units	The units in which the area will be calculated. Learn more about area units SquareKilometers—Square kilometers Hectares—Hectares Ares—Ares SquareMeters—Square meters SquareDecimeters—Square decimeters SquareCentimeters—Square centimeters SquareMillimeters—Square millimeters SquareMiles—Square miles AcresInt—International acres SquareYardsInt—Square international yards SquareFeetInt—Square international feet SquareInchesInt—Square international inches SquareMilesUS—Square US survey miles AcresUS—Square US survey acres SquareYardsUS—Square US survey yards SquareFeetUS—Square US survey feet SquareInchesUS—Square US survey inches Unknown—Unknown	String

Параметр

Описание

Тип данных

type

The method used to measure area.

GEODESIC—The 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_ELLIPTIC—The 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.
LOXODROME—The 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.
PLANAR—Planar 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_SHAPE—This 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

units

The units in which the area will be calculated.

Learn more about area units

SquareKilometers—Square kilometers
Hectares—Hectares
Ares—Ares
SquareMeters—Square meters
SquareDecimeters—Square decimeters
SquareCentimeters—Square centimeters
SquareMillimeters—Square millimeters
SquareMiles—Square miles
AcresInt—International acres
SquareYardsInt—Square international yards
SquareFeetInt—Square international feet
SquareInchesInt—Square international inches
SquareMilesUS—Square US survey miles
AcresUS—Square US survey acres
SquareYardsUS—Square US survey yards
SquareFeetUS—Square US survey feet
SquareInchesUS—Square US survey inches
Unknown—Unknown

String

Возвращаемое значение

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

Тип данных

Описание

Double

Площадь объекта.

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

getLength ({measurement_type}, {units})

Параметр	Описание	Тип данных
measurement_type	The method used to measure length. GEODESIC—The 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_ELLIPTIC—The 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. LOXODROME—The 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. PLANAR—Planar 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_SHAPE—This 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
units	The units in which the length will be calculated. Learn more about linear units Kilometers—Kilometers Meters—Meters Decimeters—Decimeters Millimeters—Millimeters Centimeters—Centimeters NauticalMilesInt—International nautical miles MilesInt—Statute miles YardsInt—International yards FeetInt—International feet InchesInt—International inches NauticalMiles—US survey nautical miles Miles—US survey miles Yards—US survey yards Feet—US survey feet Inches—US survey inches DecimalDegrees—Decimal degrees Points—Points Unknown—Unknown	String

Параметр

Описание

Тип данных

measurement_type

The method used to measure length.

GEODESIC—The 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_ELLIPTIC—The 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.
LOXODROME—The 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.
PLANAR—Planar 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_SHAPE—This 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

units

The units in which the length will be calculated.

Learn more about linear units

Kilometers—Kilometers
Meters—Meters
Decimeters—Decimeters
Millimeters—Millimeters
Centimeters—Centimeters
NauticalMilesInt—International nautical miles
MilesInt—Statute miles
YardsInt—International yards
FeetInt—International feet
InchesInt—International inches
NauticalMiles—US survey nautical miles
Miles—US survey miles
Yards—US survey yards
Feet—US survey feet
Inches—US survey inches
DecimalDegrees—Decimal degrees
Points—Points
Unknown—Unknown

String

Возвращаемое значение

Тип данных	Описание
Double	Длина объекта. По умолчанию в системах координат проекции длина возвращается в единицах системы координат, а для географических систем координат длина возвращается в квадратных метрах.

Тип данных

Описание

Double

Длина объекта.

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

getPart ({index})

Параметр	Описание	Тип данных
index	The index position of the geometry.	Integer

Возвращаемое значение

Тип данных	Описание
Array	Полученный в результате объект Array.

intersect (other, dimension)

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

Возвращаемое значение

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

measureOnLine (in_point, {use_percentage})

Параметр	Описание	Тип данных
in_point	Точка (PointGeometry или Point), которая используется для измерения расстояния от начальной точки полилинии.	PointGeometry
use_percentage	Если False, измерение возвращается как расстояние; если True, измерение возвращается в процентном отношении. (Значение по умолчанию — False)	Boolean

Параметр

Описание

Тип данных

in_point

Точка (PointGeometry или Point), которая используется для измерения расстояния от начальной точки полилинии.

PointGeometry

use_percentage

Если False, измерение возвращается как расстояние; если True, измерение возвращается в процентном отношении.

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

Boolean

Возвращаемое значение

Тип данных	Описание
Double	Расстояние или процентное отношение.

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	Возвращает точку при заданном угле и расстоянии в градусах и метрах.

positionAlongLine (value, {use_percentage}, {geodesic})

Параметр	Описание	Тип данных
value	The distance along the line. If the distance is less than zero, the starting point of the line will be returned; if the distance is greater than the length of the line, the endpoint of the line will be returned.	Double
use_percentage	Specifies whether the distance is specified as a fixed unit of measure or a ratio of the length of the line. If True, value is used as a percentage; if False, value is used as a distance. For percentages, the value should be expressed as a double from 0.0 (0 percent) to 1.0 (100 percent). (Значение по умолчанию — False)	Boolean
geodesic	Specifies whether the distance measure is geodesic or planar. If True, the distance measure is treated as geodesic; if False, the distance measure is treated as planar. (Значение по умолчанию — False)	Boolean

Возвращаемое значение

Тип данных	Описание
PointGeometry	Точка на линии, расположенная на заданном расстоянии от ее начала.

projectAs (spatial_reference, {transformation_name})

Параметр	Описание	Тип данных
spatial_reference	The new spatial reference. This can be a SpatialReference object or the coordinate system name.	SpatialReference
transformation_name	The geotransformation name.	String

Возвращаемое значение

Тип данных	Описание
Object	Геометрия после проецирования.

queryPointAndDistance (in_point, {as_percentage})

Параметр	Описание	Тип данных
in_point	Входная точка (PointGeometry или Point).	PointGeometry
as_percentage	Если False, измерение возвращается как расстояние; если True, измерение возвращается в процентном отношении. (Значение по умолчанию — False)	Boolean

Параметр

Описание

Тип данных

in_point

Входная точка (PointGeometry или Point).

PointGeometry

as_percentage

Если False, измерение возвращается как расстояние; если True, измерение возвращается в процентном отношении.

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

Boolean

Возвращаемое значение

Тип данных	Описание
tuple	Возвращает кортеж (tuple), включающий следующее: Объект PointGeometry, являющийся ближайшей точкой на полилинии до in_point. Расстояние между начальной точкой линии и возвращаемой точкой на линии. Минимальное расстояние между линией и in_point. Логический параметр, указывающий на расположение in_point на правой стороне линии. Направление линии, определяющее правую и левую стороны.

Тип данных

Описание

tuple

Возвращает кортеж (tuple), включающий следующее:

Объект PointGeometry, являющийся ближайшей точкой на полилинии до in_point.
Расстояние между начальной точкой линии и возвращаемой точкой на линии.
Минимальное расстояние между линией и in_point.
Логический параметр, указывающий на расположение in_point на правой стороне линии. Направление линии, определяющее правую и левую стороны.

segmentAlongLine (start_measure, end_measure, {use_percentage})

Параметр	Описание	Тип данных
start_measure	Начальное расстояние от начала линии.	Double
end_measure	Конечное расстояние от начала линии.	Double
use_percentage	Начальное и конечное измерения можно указать как в фиксированных единицах измерения, так и в виде отношения. Если значение равно True, то start_measure и end_measure используются как проценты; если значение равно False, то start_measure и end_measure используются как расстояние. Для обозначения процентов измерения должны быть выражены числами двойной точности (double) в диапазоне от 0.0 (0 процентов) до 1,0 (100 процентов). (Значение по умолчанию — False)	Boolean

Возвращаемое значение

Тип данных	Описание
PolyLine	Сегмент линии между двумя точками.

snapToLine (in_point)

Параметр	Описание	Тип данных
in_point	Точка (PointGeometry или Point), которую надо замкнуть на линии.	PointGeometry

Возвращаемое значение

Тип данных	Описание
PointGeometry	Замкнутая точка.

symmetricDifference (other)

Параметр	Описание	Тип данных
other	Вторая геометрия.	Object

Возвращаемое значение

Тип данных	Описание
Object	Получившаяся геометрия.

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 указывает, что данная геометрия содержится внутри второй геометрии.

Пример кода

Пример Geometry

Когда вы задает выходной параметр инструмента геообработки как пустой объект Geometry, то инструмент вернет список объектов Geometry.

import arcpy

# Run the Copy Features tool, setting the output to the geometry object.
# geometries is returned as a list of geometry objects.
geometries = arcpy.CopyFeatures_management("c:/data/streets.shp",
                                           arcpy.Geometry())

# Walk through each geometry, totaling the length
length = 0
for geometry in geometries:
    length += geometry.length

print("Total length: {0}".format(length))

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

Отзыв по этому разделу?

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

Обсуждение

Синтаксис

Свойства

Подсказка:

Внимание:

Внимание:

Обзор метода

Методы

Пример кода

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

В этом разделе

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