ol/geom/Polygon~Многоугольник
import Polygon from 'ol/geom/Polygon.js';
Геометрия многоугольника.
-
новый Многоугольник(координаты, разметка, концы)
-
Имя Тип Описание coordinates!Массив<Массив<Координата>> | !Массив.<число> Массив линейных колец, определяющих многоугольник. Первое линейное кольцо массива определяет внешнюю границу или поверхность многоугольника. Каждое последующее линейное кольцо определяет отверстие на поверхности многоугольника. Линейное кольцо — это массив координат вершин, где первая и последняя координаты эквивалентны. (Для внутреннего использования также принимаются плоские координаты в сочетании с
layoutиends.)layoutРазметка геометрии | undefined Разметка.
endsМассив.<число> | undefined Концы (для внутреннего использования с плоскими координатами).
События:
-
change(Базовое событие) — Общее событие изменения. Срабатывает при увеличении счетчика пересмотра. -
error(Базовое событие) — Общее событие об ошибке. Срабатывает при возникновении ошибки. -
propertychange(Объектное событие) — Срабатывает при изменении свойства.
-
Наследует от
Методы
-
appendLinearRing(linearRing)
-
Добавить переданное линейное кольцо к этому многоугольнику.
Имя Тип Описание linearRingЛинейноеКольцо Линейное кольцо.
-
applyTransform(transformFn) унаследованно
-
Применить функцию преобразования к координатам геометрии. Геометрия изменяется на месте. Если вы не хотите изменять геометрию на месте, сначала
clone()её, а затем используйте эту функцию на клоне.Имя Тип Описание transformFnФункцияПреобразования Функция преобразования. Вызывается с плоским массивом координат геометрии.
-
changed() унаследованно
-
Увеличивает счетчик ревизий и отправляет событие 'change'.
-
clone(){Многоугольник}
-
Создает полную копию геометрии.
Возвращает:
Клон.
-
dispatchEvent(event){boolean | undefined} унаследованно
-
Отправляет событие и вызывает всех слушателей, ожидающих события этого типа. Параметр event может быть либо строкой, либо объектом с свойством
type.Имя Тип Описание eventБазовоеСобытие | строка Объект события.
Возвращает:
false, если кто-то вызвал preventDefault в объекте события или если какой-либо из слушателей вернул false.
-
get(key){*} унаследованно
-
Получает значение.
Имя Тип Описание keyстрока Имя ключа.
Возвращает:
Значение.
-
getArea(){число}
-
Возвращает площадь многоугольника на проекционной плоскости.
Возвращает:
Площадь (на проекционной плоскости).
-
getClosestPoint(point, closestPoint){Координата} унаследованно
-
Возвращает ближайшую точку геометрии к переданной точке как
coordinate.Имя Тип Описание pointКоордината Точка.
closestPointКоордината | undefined Ближайшая точка.
Возвращает:
Ближайшая точка.
-
getCoordinates(right){Массив<Массив<Координата>>}
-
Получить массив координат для этой геометрии. Этот массив имеет структуру массива координат GeoJSON для многоугольников.
Имя Тип Описание rightлогический | undefined Ориентировать координаты в соответствии с правилом правой руки (против часовой стрелки для внешних и по часовой стрелке для внутренних колец). Если
false, координаты будут ориентированы в соответствии с правилом левой руки (по часовой стрелке для внешних и против часовой стрелки для внутренних колец). По умолчанию ориентация координат зависит от того, как была построена геометрия.Возвращает:
Координаты.
-
getExtent(extent){Охватывает} унаследованно
-
Получить область геометрии.
Имя Тип Описание extentОхватывает | undefined Область.
Возвращает:
Охватывает Область.
-
getFirstCoordinate(){Координата} унаследованно
-
Возвращает первую координату геометрии.
Возвращает:
Первая координата.
-
getInteriorPoint(){Точка}
-
Возвращает внутреннюю точку многоугольника.
Возвращает:
Внутренняя точка как координата XYM, где M — длина горизонтального пересечения, к которому принадлежит точка.
-
Получить список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getLastCoordinate(){Координата} inherited
-
Возвратить последнюю координату геометрии.
Возвращает:
Последняя точка.
-
getLayout(){Тип геометрии} inherited
-
Возвратить
layoutгеометрии.Возвращает:
Тип.
-
getLinearRing(index){Линейный контур | null}
-
Возвратить N-й линейный контур многоугольной геометрии. Возвращает
null, если переданный индекс находится за пределами допустимого диапазона. Внешний линейный контур доступен по индексу0, а внутренние контуры — по индексу1и далее.Имя Тип Описание indexчисло Индекс.
Возвращает:
Линейный контур.
-
getLinearRingCount(){число}
-
Возвратить количество контуров многоугольника, включая внешний и внутренние.
Возвращает:
Количество контуров.
-
getLinearRings(){Array<Линейный контур>}
-
Возвратить линейные контуры многоугольника.
Возвращает:
Линейные контуры.
-
Получить объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRevision(){число} inherited
-
Получить номер версии этого объекта. Каждый раз при изменении объекта его номер версии увеличивается.
Возвращает:
Версия.
-
getType(){Тип}
-
Получить тип этой геометрии.
Возвращает:
Тип геометрии.
-
intersectsCoordinate(координата){логическое} inherited
-
Возвращает true, если эта геометрия содержит указанную координату. Если координата находится на границе геометрии, возвращает false.
Имя Тип Описание coordinateКоордината Координата.
Возвращает:
Содержит координату.
-
intersectsExtent(охватывающая область){логическое}
-
Проверить пересечение геометрии и переданной охватывающей области.
Имя Тип Описание extentОхватывающая область Охватывающая область.
Возвращает:
true, если геометрия и охватывающая область пересекаются.
-
on(тип, обработчик){Ключ события | Array<Ключ события>} inherited
-
Прислушаться к определённому типу события.
Имя Тип Описание typeстрока | Массив<строка> Тип события или массив типов событий.
listenerфункция Функция-обработчик.
Возвращает:
Уникальный ключ для обработчика. Если вызвано с массивом типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
once(тип, обработчик){Ключ события | Array<Ключ события>} inherited
-
Прослушивание определённого типа события один раз.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-слушатель.
Возвращаемое значение:
Уникальный ключ для слушателя. Если вызван с массивом типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
rotate(angle, anchor) унаследованное
-
Поворот геометрии вокруг заданной координаты. Это изменяет координаты геометрии на месте.
Имя Тип Описание anglenumber Угол поворота против часовой стрелки в радианах.
anchorКоордината Центр поворота.
-
scale(sx, sy, anchor) унаследованное
-
Масштабирование геометрии (с необязательной точкой начала). Это изменяет координаты геометрии на месте.
Имя Тип Описание sxnumber Коэффициент масштабирования по оси X.
synumber | undefined Коэффициент масштабирования по оси Y (по умолчанию равен sx).
anchorКоордината | undefined Точка начала масштабирования (по умолчанию - центр области геометрии).
-
set(key, value, silent) унаследованное
-
Устанавливает значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновление без срабатывания события.
-
setCoordinates(coordinates, layout)
-
Устанавливает координаты многоугольника.
Имя Тип Описание coordinatesArray<Array<Координата>> Координаты.
layoutМакет геометрии | undefined Макет.
-
setProperties(values, silent) унаследованное
-
Устанавливает набор пар "ключ-значение". Обратите внимание, что это изменяет все существующие свойства и добавляет новые (не удаляет какие-либо существующие свойства).
Имя Тип Описание valuesObject.<string, *> Значения.
silentboolean | undefined Обновление без срабатывания события.
-
simplify(tolerance){Геометрия} унаследованное
-
Создаёт упрощённую версию этой геометрии. Для линий используется алгоритм Даугаса-Пекера. Для полигонов используется упрощение на основе квантования для сохранения топологии.
Имя Тип Описание tolerancenumber Расстояние допуска для упрощения.
Возвращаемое значение:
Новая, упрощённая версия исходной геометрии.
-
transform(source, destination){this} унаследованное
-
Преобразовать каждую координату геометрии из одной системы координат в другую. Геометрия изменяется на месте. Например, линия будет преобразована в линию, а круг в круг. Если вы не хотите изменять геометрию на месте, сначала скопируйте её, а затем используйте эту функцию для копии.
Имя Тип Описание sourceТип проекции Текущая проекция. Может быть строковым идентификатором или объектом
Projection.destinationТип проекции Желаемая проекция. Может быть строковым идентификатором или объектом
Projection.Возвращаемое значение:
Эта геометрия. Обратите внимание, что исходная геометрия изменяется на месте.
-
translate(deltaX, deltaY) унаследованное
-
Переведите геометрию. Это изменяет координаты геометрии на месте. Если вы хотите новую геометрию, сначала
clone()эту геометрию.Имя Тип Описание deltaXчисло Дельта X.
deltaYчисло Дельта Y.
-
un(тип, слушатель) унаследованный
-
Отменить прослушивание определенного типа события.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция-слушатель.
-
unset(ключ, без звука) унаследованный
-
Сбрасывает свойство.
Имя Тип Описание keyстрока Имя ключа.
silentлогическое | undefined Сбросить без запуска события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_geom_Polygon-Polygon.html