math module

Классы

AffineTransform

Класс Affine Transform, созданный из набора ссылочных точек.

Перечисления

AccelerationUnits

Единицы измерения для ускорения.

AreaUnits

Единицы измерения для областей.

DistanceUnits

Единицы измерения для расстояний.

SpeedUnits

Единицы измерения для скорости.

TimeUnits

Единицы измерения за время.

Функции

boundingBoxToPolygon(BoundingBox)

Принимает BoundingBox и преобразует его в многоугольник.

convertAcceleration(number, string | AccelerationUnits, string | AccelerationUnits, number)

Преобразует значение ускорения из одной единицы в другую. Поддерживаемые единицы: milesPerSecondSquared, kmsPerSecondSquared, метровPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kmsPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity

convertArea(number, string, string, number)

Преобразует значение области из одной единицы в другую. Поддерживаемые единицы: squareMeters, акров, гектаров, squareFeet, squareYards, squareMiles, squareKilometers

convertDistance(number, string | DistanceUnits, string | DistanceUnits, number)

Преобразует расстояние от одного единицы расстояния к другому. Поддерживаемые единицы: мили, морские мили, ярды, метров, километров, футов

convertSpeed(number, string | SpeedUnits, string | SpeedUnits, number)

Преобразует значение скорости из одной единицы в другую. Поддерживаемые единицы: kmsPerHour, milesPerHour, metersPerSecond, feetPerSecond, узлы, mach

convertTimespan(number, string | TimeUnits, string | TimeUnits, number)

Преобразует значение интервала времени из одной единицы в другую. Поддерживаемые единицы: мс (миллисекунд), часы, минуты, секунды

getAcceleration(number, number, number, string | SpeedUnits, string | DistanceUnits, string | TimeUnits, string | AccelerationUnits, number)

Вычисляет ускорение на основе начальной скорости, расстояния перемещения и интервала времени. Формула: a = 2*(d - v*t)/t^2

getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string | SpeedUnits, string | AccelerationUnits, number)

Вычисляет ускорение между двумя точечными функциями со свойством метки времени и при необходимости свойством скорости. Если заданы скорости, игнорируйте расстояние между точками, так как путь может не быть прямым и вычислить: a = (v2 - v1)/(t2 - t1), если скорость не указана или указана только в первой точке, вычислите расстояние прямой линии между точками и вычислите: a = 2*(d - v*t)/t^2

getAccelerationFromSpeeds(number, number, number, string | SpeedUnits, string | TimeUnits, string | AccelerationUnits, number)

Вычисляет ускорение на основе начальной скорости, конечной скорости и интервала времени. Формула: a = 2* (v2 - v1)/t

getArea(atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, AreaUnits, number)

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

getCardinalSpline(Position[], number, number, boolean)

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

getClosestPointOnGeometry(Position | Point | Feature<Point, any> | Shape, atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, string | DistanceUnits, number)

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

getConvexHull(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Вычисляет выпуклый корпус из массива позиций, геометрических объектов или признаков.

getDestination(Position | Point, number, number, string | DistanceUnits)

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

getDistanceTo(Position | Point, Position | Point, string | DistanceUnits)

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

getEarthRadius(string | DistanceUnits)

Извлекает радиус земли в определенной единице расстояния для WGS84.

getGeodesicPath(LineString | Position[], number)

Принимает массив позиций объектов и заполняет пространство между ними точно расположенными позициями, чтобы сформировать приблизительный геодесессический путь.

getGeodesicPaths(LineString | Position[], number)

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

getHeading(Position | Point, Position | Point)

Вычисляет заголовок из одного объекта позиции в другой.

getLengthOfPath(LineString | Position[], string | DistanceUnits)

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

getPathDenormalizedAtAntimerian(LineString | Position[])

Денормализирует путь на antimeridian, это делает линии с координатами на противоположной стороне аtimeridian, чтобы всегда пересекать его. Обратите внимание, что путь пересечения antimeridian будет содержать долготу за пределами -180 до 180 диапазонов. Если это не требуется, см. раздел getPathSplitByAntimeridian.

getPathSplitByAntimeridian(LineString | Position[])

Разделение пути на antimeridian на несколько путей. Если это не требуется, см. раздел getPathDenormalizedAtAntimerian.

getPixelHeading(Position | Point, Position | Point)

Вычисляет точный заголовок пикселя из одной позиции в другую на основе проекции карты Меркатора. Этот заголовок является визуально точным.

getPointsWithHeadingsAlongPath(LineString | Position[], number)

Получает массив равномерно расположенных точек с заголовками вдоль пути.

getPointWithHeadingAlongPath(LineString | Position[], number, string | DistanceUnits)

Получает точку с заголовком указанного расстояния вдоль пути.

getPosition(Position | Point | Feature<Point, any> | Shape)

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

getPositionAlongPath(LineString | Position[], number, string | DistanceUnits)

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

getPositions(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Извлекает массив всех позиций в предоставленной геометрии, признаке или массиве геометрических или признаков.

getPositionsAlongPath(LineString | Position[], number)

Получает массив равномерно расположенных позиций вдоль пути.

getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)

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

getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)

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

getSpeed(Position | Point | Feature<Point, any>, Position | Point | Feature<Point, any>, number, string | TimeUnits, string | SpeedUnits, number)

Вычисляет среднюю скорость перемещения между двумя точками на основе указанного количества времени.

getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string | SpeedUnits, number)

Вычисляет среднюю скорость перемещения между двумя точечными компонентами, имеющими свойство, содержащее метку времени. Метка времени может иметь значение;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
getTimespan(Date | string | number, Date | string | number, TimeUnits, number)

Вычисляет интервал времени между двумя датами или метками времени. Метки времени могут быть;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
getTravelDistance(string, number, number, number, string | TimeUnits, string | SpeedUnits, string, number)

Вычисляет расстояние, указанное для заданного интервала времени, скорости и при необходимости ускорения. Формула: d = vt + 0,5a*t^2

interpolate(Position | Point, Position | Point, number)

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

mercatorPixelsToPositions(Pixel[], number)

Преобразует массив глобальных координат пикселей Mercator в массив геопространственных позиций на указанном уровне масштабирования. Глобальные координаты пикселей относятся к левому верхнему углу карты [-180, 90].

mercatorPositionsToPixels(Position[], number)

Преобразует массив позиций в массив глобальных координат пикселей Меркатора на указанном уровне масштабирования.

normalizeLatitude(number)

Нормализует значение широты от –90 до 90 градусов.

normalizeLongitude(number)

Нормализует значение долготы от -180 до 180 градусов.

parseTimestamp(Date | string | number)

Анализирует метку времени в объект Date JavaScript. Метки времени могут быть;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
rotatePositions(Position[], Position | Point, number)

Принимает массив позиций и поворачивает их вокруг заданной позиции для заданного угла поворота.

simplify((Position | Pixel)[], number)

Выполните Douglas-Peucker упрощение массива позиций или пикселей.

Сведения о функции

boundingBoxToPolygon(BoundingBox)

Принимает BoundingBox и преобразует его в многоугольник.

function boundingBoxToPolygon(bounds: BoundingBox): Polygon

Параметры

bounds
BoundingBox

BoundingBox для преобразования в многоугольник.

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

Многоугольное представление BoundingBox.

convertAcceleration(number, string | AccelerationUnits, string | AccelerationUnits, number)

Преобразует значение ускорения из одной единицы в другую. Поддерживаемые единицы: milesPerSecondSquared, kmsPerSecondSquared, метровPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kmsPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity

function convertAcceleration(acceleration: number, fromUnits: string | AccelerationUnits, toUnits: string | AccelerationUnits, decimals?: number): number

Параметры

acceleration

number

Преобразуемое значение ускорения.

fromUnits

string | AccelerationUnits

Единицы ускорения, в которые входит значение.

toUnits

string | AccelerationUnits

Единицы ускорения для преобразования.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Преобразователь ускорения из одной единицы в другую.

convertArea(number, string, string, number)

Преобразует значение области из одной единицы в другую. Поддерживаемые единицы: squareMeters, акров, гектаров, squareFeet, squareYards, squareMiles, squareKilometers

function convertArea(area: number, fromUnits: string, toUnits: string, decimals?: number): number

Параметры

area

number

Значение области для преобразования.

fromUnits

string

Единицы измерения области, в которые находится значение.

toUnits

string

Единицы измерения области для преобразования.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Значение области, преобразователь из одной единицы в другую.

convertDistance(number, string | DistanceUnits, string | DistanceUnits, number)

Преобразует расстояние от одного единицы расстояния к другому. Поддерживаемые единицы: мили, морские мили, ярды, метров, километров, футов

function convertDistance(distance: number, fromUnits: string | DistanceUnits, toUnits: string | DistanceUnits, decimals?: number): number

Параметры

distance

number

Число, представляющее расстояние для преобразования.

fromUnits

string | DistanceUnits

Единицы расстояния, в которые находится исходное расстояние.

toUnits

string | DistanceUnits

Требуемые единицы расстояния для преобразования.

decimals

number

Указывает количество десятичных разрядов для округления результата. Если не определено, округление не будет выполняться.

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

number

Расстояние в новых единицах.

convertSpeed(number, string | SpeedUnits, string | SpeedUnits, number)

Преобразует значение скорости из одной единицы в другую. Поддерживаемые единицы: kmsPerHour, milesPerHour, metersPerSecond, feetPerSecond, узлы, mach

function convertSpeed(speed: number, fromUnits: string | SpeedUnits, toUnits: string | SpeedUnits, decimals?: number): number

Параметры

speed

number

Значение скорости для преобразования.

fromUnits

string | SpeedUnits

Единицы скорости для преобразования.

toUnits

string | SpeedUnits

Единицы скорости для преобразования.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Значение скорости, преобразовательное из одной единицы в другую.

convertTimespan(number, string | TimeUnits, string | TimeUnits, number)

Преобразует значение интервала времени из одной единицы в другую. Поддерживаемые единицы: мс (миллисекунд), часы, минуты, секунды

function convertTimespan(timespan: number, fromUnits: string | TimeUnits, toUnits: string | TimeUnits, decimals?: number): number

Параметры

timespan

number

Значение времени для преобразования.

fromUnits

string | TimeUnits

Единицы времени для преобразования.

toUnits

string | TimeUnits

Единицы времени для преобразования.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Значение времени, преобразовательное из одной единицы в другую.

getAcceleration(number, number, number, string | SpeedUnits, string | DistanceUnits, string | TimeUnits, string | AccelerationUnits, number)

Вычисляет ускорение на основе начальной скорости, расстояния перемещения и интервала времени. Формула: a = 2*(d - v*t)/t^2

function getAcceleration(initialSpeed: number, distance: number, timespan: number, speedUnits?: string | SpeedUnits, distanceUnits?: string | DistanceUnits, timeUnits?: string | TimeUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Параметры

initialSpeed

number

Начальная скорость.

distance

number

Расстояние, которое было пройдено.

timespan

number

Интервал времени, который был путешествовал.

speedUnits

string | SpeedUnits

Единицы сведений о скорости. Если не указано значение m/s, используется.

distanceUnits

string | DistanceUnits

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

timeUnits

string | TimeUnits

Единицы сведений о временном диапазоне. Если не указаны секунды, используются.

accelerationUnits

string | AccelerationUnits

Единицы для возврата значения ускорения. Если не указано значение m/s^2, используется.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Ускорение на основе начальной скорости, расстояния перемещения и интервала времени.

getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string | SpeedUnits, string | AccelerationUnits, number)

Вычисляет ускорение между двумя точечными функциями со свойством метки времени и при необходимости свойством скорости. Если заданы скорости, игнорируйте расстояние между точками, так как путь может не быть прямым и вычислить: a = (v2 - v1)/(t2 - t1), если скорость не указана или указана только в первой точке, вычислите расстояние прямой линии между точками и вычислите: a = 2*(d - v*t)/t^2

function getAccelerationFromFeatures(origin: Feature<Point, any>, destination: Feature<Point, any>, timestampProperty: string, speedProperty?: string, speedUnits?: string | SpeedUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Параметры

origin

Feature<Point, any>

Начальная точка, из которой вычисляется ускорение.

destination

Feature<Point, any>

Окончательная точка, из которой вычисляется ускорение.

timestampProperty

string

Имя свойства для компонентов, содержащих сведения о метке времени.

speedProperty

string

Имя свойства для функций, содержащих сведения о скорости.

speedUnits

string | SpeedUnits

Единицы сведений о скорости. Если не задано значение m/s, используется.

accelerationUnits

string | AccelerationUnits

Единицы для возврата значения ускорения. Если не указано значение m/s^2, используется.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Ускорение между двумя точечными функциями со свойством метки времени и при необходимости свойством скорости. Возвращает naN, если не удается проанализировать метку времени.

getAccelerationFromSpeeds(number, number, number, string | SpeedUnits, string | TimeUnits, string | AccelerationUnits, number)

Вычисляет ускорение на основе начальной скорости, конечной скорости и интервала времени. Формула: a = 2* (v2 - v1)/t

function getAccelerationFromSpeeds(initialSpeed: number, finalSpeed: number, timespan: number, speedUnits?: string | SpeedUnits, timeUnits?: string | TimeUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Параметры

initialSpeed

number

Начальная скорость.

finalSpeed

number

Окончательная скорость.

timespan

number

Интервал времени, который был путешествовал.

speedUnits

string | SpeedUnits

Единицы сведений о скорости. Если не указаны счетчики, используются.

timeUnits

string | TimeUnits

Единицы сведений о временном диапазоне. Если не указаны секунды, используются.

accelerationUnits

string | AccelerationUnits

Единицы для возврата значения ускорения. Если не указано значение m/s^2, используется.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Ускорение на основе начальной скорости, конечной скорости и интервала времени.

getArea(atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, AreaUnits, number)

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

function getArea(data: atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, areaUnits?: AreaUnits, decimals?: number): number

Параметры

data

Geometry | Feature<Geometry, any> | Shape

areaUnits
AreaUnits

Единица измерения области. Значение по умолчанию — squareMeters.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Область геометрии в указанных единицах.

getCardinalSpline(Position[], number, number, boolean)

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

function getCardinalSpline(positions: Position[], tension?: number, nodeSize?: number, close?: boolean): Position[]

Параметры

positions

Position[]

Массив позиций для вычисления сплайна.

tension

number

Число, указывающее на жесткость кривой. Может быть любым числом, хотя обычно используется значение от 0 до 1. По умолчанию: 0.5

nodeSize

number

Количество узлов для вставки между каждой позицией. Значение по умолчанию: 15

close

boolean

Логическое значение, указывающее, должен ли сплайн быть замкнутым кольцом. Значение по умолчанию — false

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

Массив позиций, образующих кардинал сплайн между указанным массивом позиций.

getClosestPointOnGeometry(Position | Point | Feature<Point, any> | Shape, atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, string | DistanceUnits, number)

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

function getClosestPointOnGeometry(pt: Position | Point | Feature<Point, any> | Shape, geom: atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, units?: string | DistanceUnits, decimals?: number): Feature<Point, { distance: number }>

Параметры

pt

Position | Point | Feature<Point, any> | Shape

Точка или позиция для поиска ближайшей точки на краю геометрии.

geom

Geometry | Feature<Geometry, any> | Shape

Геометрия для поиска ближайшей точки.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метры.

decimals

number

Число десятичных разрядов для округления результата.

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

Feature<Point, { distance: number }>

getConvexHull(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Вычисляет выпуклый корпус из массива позиций, геометрических объектов или признаков.

function getConvexHull(data: Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape): Polygon

Параметры

data

Position[] | Geometry | Feature<Geometry, any> | FeatureCollection | GeometryCollection | Geometry[] | Array<Feature<Geometry, any> | Shape> | Shape

Массив позиций, геометрий или признаков для вычисления выпуклого корпуса.

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

Выпуклый корпус из массива позиций, геометрических объектов или признаков.

getDestination(Position | Point, number, number, string | DistanceUnits)

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

function getDestination(origin: Position | Point, heading: number, distance: number, units?: string | DistanceUnits): Position

Параметры

origin

Position | Point

Позиция, к которому относится назначение.

heading

number

Угол заголовка от 0 до 360 градусов. 0 - Север, 90 - Восток, 180 - Юг, 270 - Запад.

distance

number

Расстояние от места назначения.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метры.

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

Позиция, которая является указанным расстоянием от источника.

getDistanceTo(Position | Point, Position | Point, string | DistanceUnits)

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

function getDistanceTo(origin: Position | Point, destination: Position | Point, units?: string | DistanceUnits): number

Параметры

origin

Position | Point

Первая позиция для вычисления расстояния между ними.

destination

Position | Point

Вторая позиция для вычисления расстояния между ними.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метры.

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

number

Наименьшее расстояние между двумя позициями в указанных единицах.

getEarthRadius(string | DistanceUnits)

Извлекает радиус земли в определенной единице расстояния для WGS84.

function getEarthRadius(units?: string | DistanceUnits): number

Параметры

units

string | DistanceUnits

Единица измерения расстояния. По умолчанию: счетчики

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

number

Число, представляющее радиус земли в определенной единице расстояния.

getGeodesicPath(LineString | Position[], number)

Принимает массив позиций объектов и заполняет пространство между ними точно расположенными позициями, чтобы сформировать приблизительный геодесессический путь.

function getGeodesicPath(path: LineString | Position[], nodeSize?: number): Position[]

Параметры

path

LineString | Position[]

Массив объектов положения, образующих путь для заполнения.

nodeSize

number

Количество узлов для вставки между каждой позицией. Значение по умолчанию: 15

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

Массив объектов положения, образующих геодесессические пути, геодесессический путь, пересекающий анимеридиан, будет содержать долготу за пределами диапазона –180–180. См. раздел getGeodesicPaths(), если этот параметр не является нежелательным.

getGeodesicPaths(LineString | Position[], number)

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

function getGeodesicPaths(path: LineString | Position[], nodeSize?: number): Position[][]

Параметры

path

LineString | Position[]

Массив объектов положения, образующих путь для заполнения.

nodeSize

number

Количество узлов для вставки между каждой позицией. Значение по умолчанию: 15

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

Position[][]

Массив путей, образующих геодесессические пути, сравнение с getGeodesicPath, вложенные пути всегда будут содержать долготу в диапазоне от -180 до 180

getHeading(Position | Point, Position | Point)

Вычисляет заголовок из одного объекта позиции в другой.

function getHeading(origin: Position | Point, destination: Position | Point): number

Параметры

origin

Position | Point

Точка происхождения.

destination

Position | Point

Назначение для вычисления относительного заголовка.

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

number

Заголовок в градусах от 0 до 360. 0 градусов баллов из-за Севера.

getLengthOfPath(LineString | Position[], string | DistanceUnits)

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

function getLengthOfPath(path: LineString | Position[], units?: string | DistanceUnits): number

Параметры

path

LineString | Position[]

Массив объектов положения, составляющих путь для вычисления длины.

units

string | DistanceUnits

Единица измерения расстояния. По умолчанию: счетчики

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

number

Расстояние между всеми позициями между всеми объектами положения в массиве на поверхности земли в указанных единицах.

getPathDenormalizedAtAntimerian(LineString | Position[])

Денормализирует путь на antimeridian, это делает линии с координатами на противоположной стороне аtimeridian, чтобы всегда пересекать его. Обратите внимание, что путь пересечения antimeridian будет содержать долготу за пределами -180 до 180 диапазонов. Если это не требуется, см. раздел getPathSplitByAntimeridian.

function getPathDenormalizedAtAntimerian(path: LineString | Position[]): Position[]

Параметры

path

LineString | Position[]

Массив объектов позиции или строк для денормализации

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

Денормализованный массив объектов положения, путь пересечения анимеридиана будет содержать долготу за пределами диапазона -180 до 180.

getPathSplitByAntimeridian(LineString | Position[])

Разделение пути на antimeridian на несколько путей. Если это не требуется, см. раздел getPathDenormalizedAtAntimerian.

function getPathSplitByAntimeridian(path: LineString | Position[]): Position[][]

Параметры

path

LineString | Position[]

Массив объектов позиции или строки для разделения

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

Position[][]

Путь, разделенный на несколько путей по antimeridian.

getPixelHeading(Position | Point, Position | Point)

Вычисляет точный заголовок пикселя из одной позиции в другую на основе проекции карты Меркатора. Этот заголовок является визуально точным.

function getPixelHeading(origin: Position | Point, destination: Position | Point): number

Параметры

origin

Position | Point

destination

Position | Point

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

number

getPointsWithHeadingsAlongPath(LineString | Position[], number)

Получает массив равномерно расположенных точек с заголовками вдоль пути.

function getPointsWithHeadingsAlongPath(path: LineString | Position[], numPoints: number): Array<Feature<Point, { heading: number }>>

Параметры

path

LineString | Position[]

Путь к получению позиций.

numPoints

number

Количество точек для получения.

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

Array<Feature<Point, { heading: number }>>

Массив равномерно расположенных точек с заголовками вдоль пути.

getPointWithHeadingAlongPath(LineString | Position[], number, string | DistanceUnits)

Получает точку с заголовком указанного расстояния вдоль пути.

function getPointWithHeadingAlongPath(path: LineString | Position[], distance: number, units?: string | DistanceUnits): Feature<Point, { heading: number }>

Параметры

path

LineString | Position[]

Путь для получения точки.

distance

number

Расстояние вдоль пути, чтобы получить точку в.

units

string | DistanceUnits

Единицы расстояния.

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

Feature<Point, { heading: number }>

Точка с заголовком указанного расстояния вдоль пути.

getPosition(Position | Point | Feature<Point, any> | Shape)

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

function getPosition(data: Position | Point | Feature<Point, any> | Shape): Position

Параметры

data

Position | Point | Feature<Point, any> | Shape

Объект данных, из который извлекается позиция.

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

Позиция объекта, который является позицией, точкой или функцией точки. Возвращает значение NULL, если переданные недопустимые данные.

getPositionAlongPath(LineString | Position[], number, string | DistanceUnits)

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

function getPositionAlongPath(path: LineString | Position[], distance: number, units?: string | DistanceUnits): Position

Параметры

path

LineString | Position[]

Многострочный или массив координат положения, формирующий путь.

distance

number

Расстояние вдоль пути (от начала) для вычисления позиции.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метр.

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

Объект положения, который является указанным расстоянием от начала пути при выполнении пути.

getPositions(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Извлекает массив всех позиций в предоставленной геометрии, признаке или массиве геометрических или признаков.

function getPositions(data: Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape): Position[]

Параметры

data

Position[] | Geometry | Feature<Geometry, any> | FeatureCollection | GeometryCollection | Geometry[] | Array<Feature<Geometry, any> | Shape> | Shape

Геометрии или признаки, из которого извлекаются позиции.

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

Массив всех позиций в предоставленной геометрии, признаке или массиве геометрических или признаков.

getPositionsAlongPath(LineString | Position[], number)

Получает массив равномерно расположенных позиций вдоль пути.

function getPositionsAlongPath(path: LineString | Position[], numPositions: number): Position[]

Параметры

path

LineString | Position[]

Путь к получению позиций.

numPositions

number

Количество позиций для получения.

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

Массив равномерно расположенных позиций вдоль пути.

getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)

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

function getRegularPolygonPath(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[]

Параметры

origin

Position | Point

Центр регулярного многоугольника.

radius

number

Радиус регулярного многоугольника.

numberOfPositions

number

Количество позиций многоугольника должно быть.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метр.

offset

number

Смещение для поворота многоугольника. Если 0 первая позиция будет выровнена с Севером.

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

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

getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)

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

function getRegularPolygonPaths(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[][]

Параметры

origin

Position | Point

Центр регулярного многоугольника.

radius

number

Радиус регулярного многоугольника.

numberOfPositions

number

Количество позиций многоугольника должно быть.

units

string | DistanceUnits

Единица измерения расстояния. Значение по умолчанию — метр.

offset

number

Смещение для поворота многоугольника. Если 0 первая позиция будет выровнена с Севером.

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

Position[][]

Массив путей, образующих обычный многоугольник. По сравнению с getRegularPolygonPath вложенные пути всегда будут содержать долготу в диапазоне от -180 до 180

getSpeed(Position | Point | Feature<Point, any>, Position | Point | Feature<Point, any>, number, string | TimeUnits, string | SpeedUnits, number)

Вычисляет среднюю скорость перемещения между двумя точками на основе указанного количества времени.

function getSpeed(origin: Position | Point | Feature<Point, any>, destination: Position | Point | Feature<Point, any>, timespan: number, timeUnits?: string | TimeUnits, speedUnits?: string | SpeedUnits, decimals?: number): number

Параметры

origin

Position | Point | Feature<Point, any>

Начальная точка, из которой вычисляется скорость.

destination

Position | Point | Feature<Point, any>

Последняя точка, из которой вычисляется скорость.

timespan

number

timeUnits

string | TimeUnits

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

speedUnits

string | SpeedUnits

Единицы, возвращаемые значением скорости. Если не задано значение m/s, используются.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Средняя скорость перемещения между двумя точками на основе предоставленного количества времени.

getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string | SpeedUnits, number)

Вычисляет среднюю скорость перемещения между двумя точечными компонентами, имеющими свойство, содержащее метку времени. Метка времени может иметь значение;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
function getSpeedFromFeatures(origin: Feature<Point, any>, destination: Feature<Point, any>, timestampProperty: string, speedUnits?: string | SpeedUnits, decimals?: number): number

Параметры

origin

Feature<Point, any>

Начальная точка, из которой вычисляется скорость.

destination

Feature<Point, any>

Последняя точка, из которой вычисляется скорость.

timestampProperty

string

Имя свойства для компонентов, которые содержат сведения о метке времени.

speedUnits

string | SpeedUnits

Единицы, возвращаемые значением скорости. Если не задано значение m/s, используются.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Скорость в указанных единицах или NaN, если допустимые метки времени не найдены.

getTimespan(Date | string | number, Date | string | number, TimeUnits, number)

Вычисляет интервал времени между двумя датами или метками времени. Метки времени могут быть;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
function getTimespan(startTime: Date | string | number, endTime: Date | string | number, units?: TimeUnits, decimals?: number): number

Параметры

startTime

Date | string | number

Начальная дата или время.

endTime

Date | string | number

Конечная дата или время.

units
TimeUnits

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

decimals

number

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

number

Интервал времени между двумя датами или метками времени. Возвращает значение NaN, если не удается проанализировать метки времени.

getTravelDistance(string, number, number, number, string | TimeUnits, string | SpeedUnits, string, number)

Вычисляет расстояние, указанное для заданного интервала времени, скорости и при необходимости ускорения. Формула: d = vt + 0,5a*t^2

function getTravelDistance(distanceUnits: string, timespan: number, speed: number, acceleration?: number, timeUnits?: string | TimeUnits, speedUnits?: string | SpeedUnits, accelerationUnits?: string, decimals?: number): number

Параметры

distanceUnits

string

Единицы расстояния, в которых возвращается расстояние.

timespan

number

Интервал времени для вычисления расстояния.

speed

number

Начальная или константная скорость.

acceleration

number

Необязательный элемент. Ускорение, которое увеличивает скорость с течением времени.

timeUnits

string | TimeUnits

Единицы интервала времени. Если не указаны секунды, используются.

speedUnits

string | SpeedUnits

Единицы значения скорости. Если не задано значение m/s, используются.

accelerationUnits

string

Необязательный элемент. Единицы значения ускорения. Если не задано значение m/s^2, используется.

decimals

number

Число десятичных разрядов для округления результата.

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

number

Расстояние, пройденное для заданного интервала времени, скорости и при необходимости ускорения.

interpolate(Position | Point, Position | Point, number)

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

function interpolate(origin: Position | Point, destination: Position | Point, fraction?: number): Position

Параметры

origin

Position | Point

Первая позиция для вычисления середины между точками.

destination

Position | Point

Вторая позиция для вычисления средней точки между ними.

fraction

number

Дробный параметр для вычисления средней точки. Значение по умолчанию 0.5.

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

Позиция, которая лежит на расстоянии между двумя объектами положения относительно первого объекта позиции.

mercatorPixelsToPositions(Pixel[], number)

Преобразует массив глобальных координат пикселей Mercator в массив геопространственных позиций на указанном уровне масштабирования. Глобальные координаты пикселей относятся к левому верхнему углу карты [-180, 90].

function mercatorPixelsToPositions(pixels: Pixel[], zoom: number): Position[]

Параметры

pixels

Pixel[]

Массив координат пикселей.

zoom

number

Масштаб.

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

Массив позиций.

mercatorPositionsToPixels(Position[], number)

Преобразует массив позиций в массив глобальных координат пикселей Меркатора на указанном уровне масштабирования.

function mercatorPositionsToPixels(positions: Position[], zoom: number): Pixel[]

Параметры

positions

Position[]

Массив позиций.

zoom

number

Масштаб.

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

Pixel[]

Массив глобальных пикселей Mercator.

normalizeLatitude(number)

Нормализует значение широты от –90 до 90 градусов.

function normalizeLatitude(lat: number): number

Параметры

lat

number

Значение широты для нормализации.

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

number

normalizeLongitude(number)

Нормализует значение долготы от -180 до 180 градусов.

function normalizeLongitude(lng: number): number

Параметры

lng

number

Значение долготы для нормализации.

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

number

parseTimestamp(Date | string | number)

Анализирует метку времени в объект Date JavaScript. Метки времени могут быть;

  • Объект JavaScript Date
  • Число, представляющее число миллисекунда с 1 января 1970 года.
  • Строка, использующая один из следующих форматов:
    • Формат даты ISO8601 (например, 2012-04-23T18:25:43.511Z)
    • Синтаксис даты RFC282 / IETF (раздел 3.3)
    • Строка даты OData (т. е. "/Date(1235764800000)/")
function parseTimestamp(timestamp: Date | string | number): Date

Параметры

timestamp

Date | string | number

Значение метки времени для синтаксического анализа.

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

Date

Объект Date, представляющий метку времени или значение NULL, если метка времени не удалось проанализировать.

rotatePositions(Position[], Position | Point, number)

Принимает массив позиций и поворачивает их вокруг заданной позиции для заданного угла поворота.

function rotatePositions(positions: Position[], origin: Position | Point, angle: number): Position[]

Параметры

positions

Position[]

Массив позиций для поворота.

origin

Position | Point

Позиция для поворота позиций вокруг.

angle

number

Величина поворота массива позиций в градусах по часовой стрелке.

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

simplify((Position | Pixel)[], number)

Выполните Douglas-Peucker упрощение массива позиций или пикселей.

function simplify(points: (Position | Pixel)[], tolerance: number): (Position | Pixel)[]

Параметры

points

(Position | Pixel)[]

Положение или пиксельные точки для упрощения.

tolerance

number

Допустимое использование в упрощении.

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

(Position | Pixel)[]

Новый массив упрощенного набора точек.