Краткая информация
Объекты Geometry определяют пространственное положение и связанную с ним геометрическую форму.
Описание
Во многих рабочих процессах геообработки может потребоваться запустить определенную операцию, используя информацию о координатах и геометрии, при этом не желая проходить процесс создания нового (временного) класса пространственных объектов, отображения класса пространственных объектов с помощью курсоров, использования класса пространственных объектов, и последующего удаления временного класса пространственных объектов. Чтобы упростить геообработку, вместо этого в качестве входных и выходных данных можно использовать объекты геометрии. Объекты геометрии могут создаваться сначала, используя классы 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 в виде строки. | String |
WKB (только чтение) | Возвращает WKB-представление для геометрии OGC.Он обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов. | Bytearray |
WKT (только чтение) | Возвращает WKT-представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде текстовой строки. Любые истинные кривые в геометрии будут уплотнены в аппроксимируют кривые в строки WKT. | String |
area (только чтение) | Площадь объекта полигона. Пусто для всех других типов объектов. | Double |
centroid (только чтение) | Возвращается истинное положение центроида, если он расположен внутри объекта, иначе возвращается точка надписи. Возвращает точечный объект. | Point |
extent (чтение и запись) | Экстент геометрии. | Extent |
firstPoint (только чтение) | Первая точка координат геометрии. | Point |
hullRectangle (только чтение) | Строка пар координат прямоугольника, образующего выпуклую оболочку, разделенная пробелами. | String |
isMultipart (только чтение) | True, если количество частей для этой геометрии больше одной. | Boolean |
labelPoint (только чтение) | Точка расположения надписи. labelPoint всегда расположен внутри объекта или на нем. | Point |
lastPoint (только чтение) | Последняя координата объекта. | Point |
length (только чтение) | Длина линейного объекта. Ноль для точечных и мультиточечных объектов. | Double |
length3D (чтение и запись) | 3D-длина линейного объекта. Ноль для точечных и мультиточечных объектов. | 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}) | Возвращает массив точечных объектов для определенной части геометрии или массы, содержащий несколько массивов, один для каждой части. |
intersect (other, dimension) | Строит геометрию, являющуюся геометрическим пересечением двух входных геометрий. Для создания различных типов формы можно использовать разную размерность. Пересечением двух геометрий с одинаковым типом формы будет геометрия, содержащая только перекрывающиеся области исходных геометрий. Для ускорения процесса проверьте, не являются ли данные две геометрии непересекающимися, перед вызовом intersect . |
measureOnLine (in_point, {use_percentage}) | Возвращает измерение расстояния от начальной точки этой линии до in_point. |
overlaps (second_geometry) | Показывает, если пересечение двух геометрий имеет тот же тип формы, что и входная геометрия и не эквивалентно любой из входных геометрий. На этом рисунке показаны только отношения True. |
pointFromAngleAndDistance (angle, distance, {method}) | Возвращает точку при заданном угле и расстоянии в градусах и метрах с использованием определенного типа измерения. |
positionAlongLine (value, {use_percentage}) | Возвращает точку на линии на указанном расстоянии от начала линии. |
projectAs (spatial_reference, {transformation_name}) | Проецирует геометрию и дополнительно применяет географическое преобразование. Для проецирования геометрия должна иметь пространственную привязку, значение UnknownCoordinateSystem не допускается. Новая система пространственной привязки, переданная методу, задает выходную систему координат. Если пространственная привязка неизвестна, координаты изменены не будут. Z-значения и измерения не меняются методом 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 | Вторая геометрия. | PointGeometry |
method | PLANAR измерения отражают проекцию географических данных на 2D поверхность (другими словами, они не будут учитывать кривизну Земли). Если требуется, то в качестве альтернативы можно выбрать типы измерений GEODESIC, GREAT_ELLIPTIC, LOXODROME и PRESERVE_SHAPE.
(Значение по умолчанию — GEODESIC) | String |
Возвращаемое значение
Тип данных | Объяснение |
tuple | Возвращает кортеж из угла (в градусах) и расстояния (в метрах) до другой точки. |
boundary ()
Возвращаемое значение
Тип данных | Объяснение |
Object | Границей полигона является полилиния. Границей полилинии является мультиточка, соответствующая конечным точкам линии. Границей точки или мультиточки является пустая точка или мультиточка. |
buffer (distance)
Параметр | Объяснение | Тип данных |
distance | Буферное расстояние. Буферное расстояние измеряется в тех же единицах, что и буферизуемая геометрия. Отрицательное расстояние можно указать только для геометрии полигонов. | Double |
Возвращаемое значение
Тип данных | Объяснение |
Polygon | Полигональная геометрия с буферизацией. |
clip (envelope)
Параметр | Объяснение | Тип данных |
envelope | Объект экстента, используемый для определения экстента обрезания. | Extent |
Возвращаемое значение
Тип данных | Объяснение |
Object | Выходная геометрия, обрезанная до определенного экстента. |
contains (second_geometry, {relation})
Параметр | Объяснение | Тип данных |
second_geometry | Вторая геометрия. | Object |
relation | Типы пространственных отношений.
(Значение по умолчанию — 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, or 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 | На результаты измерений PLANAR влияет проецирование географических данных на двухмерную поверхность, т. е. кривизна земной поверхности не учитывается. Как вариант, по желанию можно выбрать типы измерений GEODESIC, GREAT_ELLIPTIC, LOXODROME и PRESERVE_SHAPE .
(Значение по умолчанию — GEODESIC) | String |
units | Единицы, в которых будет рассчитываться площадь. Ключевые слова площадных единиц измерения: ACRES | ARES | HECTARES | SQUARECENTIMETERS | SQUAREDECIMETERS | SQUAREINCHES | SQUAREFEET | SQUAREKILOMETERS | SQUAREMETERS | SQUAREMILES | SQUAREMILLIMETERS | SQUAREYARDS | String |
Возвращаемое значение
Тип данных | Объяснение |
Double | Площадь геометрии объекта. По умолчанию в системах координат проекции площадь возвращается в единицах системы координат, а для географических систем координат площадь возвращается в квадратных метрах. |
getLength ({measurement_type}, {units})
Параметр | Объяснение | Тип данных |
measurement_type | На результаты измерений PLANAR влияет проецирование географических данных на двухмерную поверхность, т. е. кривизна земной поверхности не учитывается. Как вариант, по желанию можно выбрать типы измерений GEODESIC, GREAT_ELLIPTIC, LOXODROME и PRESERVE_SHAPE .
(Значение по умолчанию — GEODESIC) | String |
units | Единицы, в которых рассчитывается длина. Ключевые слова линейных единиц измерения:CENTIMETERS | DECIMETERS | FEET | INCHES | KILOMETERS | METERS | MILES | MILLIMETERS | NAUTICALMILES | YARDS | String |
Возвращаемое значение
Тип данных | Объяснение |
Double | Длина объекта. По умолчанию, в системах координат проекции длина возвращается в единицах системы координат, а для географических систем координат длина возвращается в квадратных метрах. |
getPart ({index})
Параметр | Объяснение | Тип данных |
index | Значение индекса геометрии. | Integer |
Возвращаемое значение
Тип данных | Объяснение |
Array | getPart возвращает массив точечных объектов для конкретной части геометрии при указанном индексе. Если индекс не указан, возвращается массив, содержащий массивы точечных объектов для каждой части геометрии. |
intersect (other, dimension)
Параметр | Объяснение | Тип данных |
other | Вторая геометрия. | Object |
dimension | Топологическая размерность (тип формы) итоговой геометрии.
| Integer |
Возвращаемое значение
Тип данных | Объяснение |
Object | Новая геометрия (точка, мультиточка, полилиния или полигон), являющаяся геометрическим пересечением двух входных геометрий. |
measureOnLine (in_point, {use_percentage})
Параметр | Объяснение | Тип данных |
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 измерения отражают проекцию географических данных на 2D поверхность (другими словами, они не будут учитывать кривизну Земли). Если требуется, то в качестве альтернативы можно выбрать типы измерений GEODESIC, GREAT_ELLIPTIC, LOXODROME и PRESERVE_SHAPE.
(Значение по умолчанию — GEODESIC) | String |
Возвращаемое значение
Тип данных | Объяснение |
PointGeometry | Возвращает точку при заданном угле и расстоянии в градусах и метрах. |
positionAlongLine (value, {use_percentage})
Параметр | Объяснение | Тип данных |
value | Расстояние вдоль линии. Если расстояние меньше нуля, возвращается начальная точка линии. Если расстояние больше длины линии, возвращается конечная точка линии. | Double |
use_percentage | Расстояние можно указать как фиксированную единицу измерения или отношение к длине линии. Если значение равно True, value используется как процент; если значение равно False, value используется как расстояние. Для обозначения процентов значение должно быть выражено числом двойной точности (double) в диапазоне от 0,0 (0 %) до 1,0 (100 %). (Значение по умолчанию — False) | Boolean |
Возвращаемое значение
Тип данных | Объяснение |
PointGeometry | Точка на линии на указанном расстоянии от начала линии. |
projectAs (spatial_reference, {transformation_name})
Параметр | Объяснение | Тип данных |
spatial_reference | Новая пространственная привязка. Это может быть объект SpatialReference или имя системы координат. | SpatialReference |
transformation_name | Имя географического преобразования. | String |
Возвращаемое значение
Тип данных | Объяснение |
Object | Проецированная геометрия. |
queryPointAndDistance (in_point, {as_percentage})
Параметр | Объяснение | Тип данных |
in_point | Входная точка (PointGeometry или Point). | PointGeometry |
as_percentage | Если False, измерение возвращается как расстояние; если True, измерение возвращается в процентном отношении. (Значение по умолчанию — False) | Boolean |
Возвращаемое значение
Тип данных | Объяснение |
tuple | Возвращает кортеж (tuple), включающий следующее:
|
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 | Типы пространственных отношений.
(Значение по умолчанию — 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))