Считывание геометрии

Каждый объект в классе объектов содержит набор точек, определяющий вершины полигона или линии, либо единичную координату, определяющую точечный объект. К этим точкам можно получить доступ с помощью объектов геометрии (Polygon, Polyline, PointGeometry или MultiPoint), возвращающих их в массив объектов Point.

Объекты могут иметь несколько частей. Свойство partCount объекта геометрии возвращает количество его частей. Метод getPart возвращает массив точечных объектов для конкретной части геометрии при указанном индексе. Если индекс не указан, возвращается массив, содержащий массивы точечных объектов для каждой части геометрии.

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

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

Составной объект включает несколько физических частей, но связан только с одним набором атрибутов в базе данных. Например, штат Гавайи в слое штатов может считаться составным объектом. Хотя он и состоит из нескольких островов, в базе данных он будет записан как один объект.

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

Более подробно о написании геометрии

Использование токенов геометрии

Токенами геометрии можно также пользоваться как ярлыками вместо доступа к полным объектам геометрии. Дополнительные токены геометрии можно использовать для доступа к конкретным сведениям о геометрии. Доступ к полной геометрии требует больше времени. Если требуются только конкретные свойства геометрии, используйте токены, чтобы предоставить быстрый доступ к свойствам геометрии. Например, SHAPE@XY возвращает набор координат x и y, представляющих центроиды объектов.

ТокенОбъяснение

SHAPE@

Объект geometry (геометрия) для пространственного объекта.

SHAPE@XY

Кортеж x, y координат центроида объекта.

SHAPE@TRUECENTROID

Кортеж x, y координат центроида объекта. Выдает такой же результат, что и SHAPE@XY.

SHAPE@X

Значение двойной точности координаты х объекта.

SHAPE@Y

Значение двойной точности координаты y объекта.

SHAPE@Z

Значение двойной точности координаты z объекта.

SHAPE@M

Значение двойной точности m для объекта.

SHAPE@JSON

Строка Esri JSON, представляющая геометрию.

SHAPE@WKB

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

SHAPE@WKT

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

SHAPE@AREA

Значение двойной точности для площади объекта.

SHAPE@LENGTH

Значение двойной точности для длины объекта.

Считывание геометрии точек

В примерах ниже SearchCursor используется для печати координат всех объектов.

Поисковый курсор на точечном классе объектов
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
for row in arcpy.da.SearchCursor(infc, ["SHAPE@XY"]):
    # Print x,y coordinates of each point feature
    x, y = row[0]
    print("{}, {}".format(x, y))
Точечная геометрия

С описанным выше классом скрипт возвратит следующую информацию:

2.0 4.0
8.0 10.0
7.0 5.0

Считывание геометрии мультиточек

Курсор поиска для класса мультиточечных объектов
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
for row in arcpy.da.SearchCursor(infc, ["OID@", "SHAPE@"]):
    # Print the current multipoint's ID
    print("Feature {}:".format(row[0]))
    # For each point in the multipoint feature,
    #  print the x,y coordinates
    for pnt in row[1]:
        print("{}, {}".format(pnt.X, pnt.Y))
Мультиточечная геометрия

С описанным выше классом скрипт возвратит следующую информацию:

Feature 0:
3.0 8.0
4.0 4.0
6.0 6.0
Feature 1:
5.0 9.0
8.0 10.0
Feature 2:
9.0 5.0

Считывание геометрий полилиний или полигонов

Поисковый курсор на классе полигональных или линейных объектов
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
for row in arcpy.da.SearchCursor(infc, ["OID@", "SHAPE@"]):
    # Print the current polygon or polyline's ID
    print("Feature {}:".format(row[0]))
    partnum = 0
    # Step through each part of the feature
    for part in row[1]:
        # Print the part number
        print("Part {}:".format(partnum))
        # Step through each vertex in the feature
        for pnt in part:
            if pnt:
                # Print x,y coordinates of current point
                print("{}, {}".format(pnt.X, pnt.Y))
            else:
                # If pnt is None, this represents an interior ring
                print("Interior Ring:")
        partnum += 1
Полигональная геометрия

С описанным выше классом скрипт возвратит следующую информацию. Объект 0 ― это полигон из одной части, объект 1 ― это полигон из двух частей, объект 2 ― это полигон из одной части со внутренним кольцом.

Feature 0:
Part 0:
3.0 8.0
1.0 8.0
2.0 10.0
3.0 8.0
Feature 1:
Part 0:
5.0 3.0
3.0 3.0
3.0 5.0
5.0 3.0
Part 1:
7.0 5.0
5.0 5.0
5.0 7.0
7.0 5.0
Feature 2:
Part 0:
9.0 11.0
9.0 8.0
6.0 8.0
6.0 11.0
9.0 11.0
Interior Ring:
7.0 10.0
7.0 9.0
8.0 9.0
8.0 10.0
7.0 10.0