ol/geom/LineString~LineString
import LineString from 'ol/geom/LineString.js';
Геометрия линии.
-
new LineString(coordinates, layout)
-
Имя Тип Описание coordinatesArray<Координата> | Array.<number> Координаты. Для внутреннего использования также принимаются плоские координаты в сочетании с
layout.layoutМакет геометрии | undefined Макет.
События:
-
change(BaseEvent) - Общее событие изменения. Срабатывает при увеличении счётчика ревизий. -
error(BaseEvent) - Общее событие ошибки. Срабатывает при возникновении ошибки. -
propertychange(ObjectEvent) - Срабатывает при изменении свойства.
-
Расширяет
Методы
-
appendCoordinate(coordinate)
-
Добавить переданную координату к координатам линии.
Имя Тип Описание coordinateКоордината Координата.
-
applyTransform(transformFn) унаследованно
-
Применить функцию преобразования к координатам геометрии. Геометрия изменяется на месте. Если вы не хотите, чтобы геометрия изменялась на месте, сначала
clone()её, а затем используйте эту функцию для клона.Имя Тип Описание transformFnФункция преобразования Функция преобразования. Вызывается с плоским массивом координат геометрии.
-
changed() унаследованно
-
Увеличивает счетчик ревизии и отправляет событие 'change'.
-
clone(){LineString}
-
Создаёт полную копию геометрии.
Возвращает:
Клон.
-
dispatchEvent(event){boolean | undefined} унаследованно
-
Отправляет событие и вызывает всех слушателей, отслеживающих события этого типа. Параметр события может быть строкой или объектом с свойством
type.Имя Тип Описание eventБазовое событие | строка Объект события.
Возвращает:
false, если кто-то вызвал preventDefault для объекта события или если любой из слушателей вернул false.
-
forEachSegment(callback){T | boolean}
-
Итерируется по каждому сегменту, вызывая предоставленную функцию обратного вызова. Если обратный вызов возвращает истинное значение, функция возвращает это значение немедленно. В противном случае функция возвращает
false.Имя Тип Описание callbackфункция Функция, вызываемая для каждого сегмента. Функция получит два аргумента, начальную и конечную координаты сегмента.
Возвращает:
Значение.
-
get(key){*} унаследованно
-
Получает значение.
Имя Тип Описание keyстрока Имя ключа.
Возвращает:
Значение.
-
getClosestPoint(point, closestPoint){Координата} унаследованно
-
Возвращает ближайшую точку геометрии к переданной точке как
coordinate.Имя Тип Описание pointКоордината Точка.
closestPointКоордината | undefined Ближайшая точка.
Возвращает:
Ближайшая точка.
-
getCoordinateAt(fraction, dest){Координата}
-
Возвращает координату в заданной доли вдоль линии.
fraction— число от 0 до 1, где 0 — начало линии, а 1 — конец.Имя Тип Описание fractionчисло Доля.
destКоордината | undefined Необязательная координата, значения которой будут изменены. Если не указано, будет возвращена новая координата.
Возвращает:
Координата интерполированной точки.
-
getCoordinateAtM(m, extrapolate){Координата | null}
-
Возвращает координату в
mс помощью линейной интерполяции, илиnull, если такая координата не существует.extrapolateуправляет экстраполяцией за пределы диапазона Ms в MultiLineString. Еслиextrapolateравноtrue, то Ms, меньшие первой M, вернут первую координату, а Ms, большие последней M, вернут последнюю координату.Имя Тип Описание mчисло M.
extrapolateлогическое | undefined Экстраполировать. По умолчанию
false.Возвращает:
Координата.
-
getCoordinates(){Array<Coordinate>}
-
Возвращает координаты линии.
Возвращаемое значение:
Координаты.
-
Получить область геометрии.
Имя Тип Описание extentExtent | undefined Область.
Возвращаемое значение:
Область Extent.
-
getFirstCoordinate(){Coordinate} inherited
-
Возвращает первую координату геометрии.
Возвращаемое значение:
Первая координата.
-
Получить список имён свойств объекта.
Возвращаемое значение:
Список имён свойств.
-
getLastCoordinate(){Coordinate} inherited
-
Возвращает последнюю координату геометрии.
Возвращаемое значение:
Последняя точка.
-
getLayout(){GeometryLayout} inherited
-
Возвращает
layoutгеометрии.Возвращаемое значение:
Разметка.
-
getLength(){number}
-
Возвращает длину линии на проецированной плоскости.
Возвращаемое значение:
Длина (на проецированной плоскости).
-
Получить объект со всеми именами и значениями свойств.
Возвращаемое значение:
Объект.
-
getRevision(){number} inherited
-
Получить номер версии этого объекта. Каждый раз, когда объект изменяется, его номер версии увеличивается.
Возвращаемое значение:
Версия.
-
getType(){Type}
-
Получить тип этой геометрии.
Возвращаемое значение:
Тип геометрии.
-
intersectsCoordinate(coordinate){boolean} inherited
-
Возвращает true, если эта геометрия включает указанную координату. Если координата находится на границе геометрии, возвращает false.
Имя Тип Описание coordinateCoordinate Координата.
Возвращаемое значение:
Содержит координату.
-
intersectsExtent(extent){boolean}
-
Проверить пересечение геометрии и переданной области.
Имя Тип Описание extentExtent Область.
Возвращаемое значение:
true, если геометрия и область пересекаются.
-
Прослушивание определённого типа события.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращаемое значение:
Уникальный ключ для обработчика. Если вызван с массивом типов событий в качестве первого аргумента, возвращение будет массивом ключей.
-
Прослушивание одного раза для определенного типа события.
Имя Тип Описание 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<Координата> Координаты.
layoutМакет геометрии | undefined Макет.
-
setProperties(values, silent) унаследованно
-
Устанавливает набор пар ключ-значение. Обратите внимание, что это изменяет все существующие свойства и добавляет новые (это не удаляет какие-либо существующие свойства).
Имя Тип Описание valuesObject.<string, *> Значения.
silentboolean | undefined Обновить без срабатывания события.
-
simplify(tolerance){Геометрия} унаследованно
-
Создать упрощённую версию этой геометрии. Для ломаных линий используется алгоритм Douglas Peucker. Для полигонов используется упрощение на основе квантования для сохранения топологии.
Имя Тип Описание tolerancenumber Расстояние допуска для упрощения.
Возвращает:
Новая, упрощенная версия исходной геометрии.
-
transform(source, destination){this} унаследованно
-
Преобразовать каждую координату геометрии из одной системы координат в другую. Геометрия изменяется на месте. Например, линия преобразуется в линию, а окружность — в окружность. Если вы не хотите изменять геометрию на месте, сначала
clone()её, а затем используйте эту функцию для копии.Имя Тип Описание 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_LineString-LineString.html