math module
Классы
AffineTransform |
Класс Affine Transform, созданный из набора ссылочных точек. |
Перечисления
AccelerationUnits |
Единицы измерения для ускорения. |
AreaUnits |
Единицы измерения для областей. |
DistanceUnits |
Единицы измерения для расстояний. |
SpeedUnits |
Единицы измерения для скорости. |
TimeUnits |
Единицы измерения за время. |
Функции
bounding |
Принимает BoundingBox и преобразует его в многоугольник. |
convert |
Преобразует значение ускорения из одной единицы в другую. Поддерживаемые единицы: milesPerSecondSquared, kmsPerSecondSquared, метровPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kmsPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity |
convert |
Преобразует значение области из одной единицы в другую. Поддерживаемые единицы: squareMeters, акров, гектаров, squareFeet, squareYards, squareMiles, squareKilometers |
convert |
Преобразует расстояние от одного единицы расстояния к другому. Поддерживаемые единицы: мили, морские мили, ярды, метров, километров, футов |
convert |
Преобразует значение скорости из одной единицы в другую. Поддерживаемые единицы: kmsPerHour, milesPerHour, metersPerSecond, feetPerSecond, узлы, mach |
convert |
Преобразует значение интервала времени из одной единицы в другую. Поддерживаемые единицы: мс (миллисекунд), часы, минуты, секунды |
get |
Вычисляет ускорение на основе начальной скорости, расстояния перемещения и интервала времени. Формула: a = 2*(d - v*t)/t^2 |
get |
Вычисляет ускорение между двумя точечными функциями со свойством метки времени и при необходимости свойством скорости. Если заданы скорости, игнорируйте расстояние между точками, так как путь может не быть прямым и вычислить: a = (v2 - v1)/(t2 - t1), если скорость не указана или указана только в первой точке, вычислите расстояние прямой линии между точками и вычислите: a = 2*(d - v*t)/t^2 |
get |
Вычисляет ускорение на основе начальной скорости, конечной скорости и интервала времени. Формула: a = 2* (v2 - v1)/t |
get |
Вычисляет приблизительную область геометрии в указанных единицах. |
get |
Вычисляет массив позиций, образующих кардинал сплайн между указанным массивом позиций. |
get |
Вычисляет ближайшую точку на краю геометрии до указанной точки или позиции.
Возвращаемая функция точки будет иметь |
get |
Вычисляет выпуклый корпус из массива позиций, геометрических объектов или признаков. |
get |
Вычисляет целевую позицию на основе начальной позиции, заголовка, расстояния и типа единицы измерения расстояния. |
get |
Вычислите расстояние между двумя объектами положения на поверхности земли с помощью формулы Haversine. |
get |
Извлекает радиус земли в определенной единице расстояния для WGS84. |
get |
Принимает массив позиций объектов и заполняет пространство между ними точно расположенными позициями, чтобы сформировать приблизительный геодесессический путь. |
get |
Принимает массив позиций объектов и заполняет пространство между ними точно расположенными позициями, чтобы сформировать приблизительный геодесессический путь, разбитый анимеридианом на несколько вложенных путей. |
get |
Вычисляет заголовок из одного объекта позиции в другой. |
get |
Вычисляет расстояние между всеми объектами положения в массиве. |
get |
Денормализирует путь на antimeridian, это делает линии с координатами на противоположной стороне аtimeridian, чтобы всегда пересекать его. Обратите внимание, что путь пересечения antimeridian будет содержать долготу за пределами -180 до 180 диапазонов. Если это не требуется, см. раздел getPathSplitByAntimeridian. |
get |
Разделение пути на antimeridian на несколько путей. Если это не требуется, см. раздел getPathDenormalizedAtAntimerian. |
get |
Вычисляет точный заголовок пикселя из одной позиции в другую на основе проекции карты Меркатора. Этот заголовок является визуально точным. |
get |
Получает массив равномерно расположенных точек с заголовками вдоль пути. |
get |
Получает точку с заголовком указанного расстояния вдоль пути. |
get |
Возвращает позицию объекта, который является позицией, точкой, признаком точки или кругом. Если это круг, будет возвращена его центральная координата. |
get |
Вычисляет объект позиции на пути, который является указанным расстоянием от начала пути. Если указанное расстояние больше длины пути, будет возвращено последнее положение пути. |
get |
Извлекает массив всех позиций в предоставленной геометрии, признаке или массиве геометрических или признаков. |
get |
Получает массив равномерно расположенных позиций вдоль пути. |
get |
Вычисляет массив объектов положения, равных расстоянию от центральной точки, чтобы создать обычный многоугольник. |
get |
Вычисляет массив объектов положения, равных расстоянию от центральной точки, чтобы создать обычный многоугольник, разбитый анимеридианом на несколько вложенных путей. |
get |
Вычисляет среднюю скорость перемещения между двумя точками на основе указанного количества времени. |
get |
Вычисляет среднюю скорость перемещения между двумя точечными компонентами, имеющими свойство, содержащее метку времени. Метка времени может иметь значение;
|
get |
Вычисляет интервал времени между двумя датами или метками времени. Метки времени могут быть;
|
get |
Вычисляет расстояние, указанное для заданного интервала времени, скорости и при необходимости ускорения. Формула: d = vt + 0,5a*t^2 |
interpolate(Position | Point, Position | Point, number) | Вычисляет позиционный объект, представляющий собой дробное расстояние между двумя объектами положения. |
mercator |
Преобразует массив глобальных координат пикселей Mercator в массив геопространственных позиций на указанном уровне масштабирования. Глобальные координаты пикселей относятся к левому верхнему углу карты [-180, 90]. |
mercator |
Преобразует массив позиций в массив глобальных координат пикселей Меркатора на указанном уровне масштабирования. |
normalize |
Нормализует значение широты от –90 до 90 градусов. |
normalize |
Нормализует значение долготы от -180 до 180 градусов. |
parse |
Анализирует метку времени в объект Date JavaScript. Метки времени могут быть;
|
rotate |
Принимает массив позиций и поворачивает их вокруг заданной позиции для заданного угла поворота. |
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
Параметры
- 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
Параметры
- 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
Возвращаемое значение
Position[]
Массив позиций, образующих кардинал сплайн между указанным массивом позиций.
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 }>
Параметры
Точка или позиция для поиска ближайшей точки на краю геометрии.
- units
-
string | DistanceUnits
Единица измерения расстояния. Значение по умолчанию — метры.
- decimals
-
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
Параметры
- 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
Параметры
- 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
Возвращаемое значение
Position[]
Массив объектов положения, образующих геодесессические пути, геодесессический путь, пересекающий анимеридиан, будет содержать долготу за пределами диапазона –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
Параметры
Возвращаемое значение
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[]
Массив объектов позиции или строк для денормализации
Возвращаемое значение
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
Параметры
Возвращаемое значение
number
getPointsWithHeadingsAlongPath(LineString | Position[], number)
Получает массив равномерно расположенных точек с заголовками вдоль пути.
function getPointsWithHeadingsAlongPath(path: LineString | Position[], numPoints: number): Array<Feature<Point, { heading: number }>>
Параметры
- path
-
LineString | Position[]
Путь к получению позиций.
- numPoints
-
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
Единицы расстояния.
Возвращаемое значение
Точка с заголовком указанного расстояния вдоль пути.
getPosition(Position | Point | Feature<Point, any> | Shape)
Возвращает позицию объекта, который является позицией, точкой, признаком точки или кругом. Если это круг, будет возвращена его центральная координата.
function getPosition(data: Position | Point | Feature<Point, any> | Shape): Position
Параметры
Возвращаемое значение
Позиция объекта, который является позицией, точкой или функцией точки. Возвращает значение 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
Геометрии или признаки, из которого извлекаются позиции.
Возвращаемое значение
Position[]
Массив всех позиций в предоставленной геометрии, признаке или массиве геометрических или признаков.
getPositionsAlongPath(LineString | Position[], number)
Получает массив равномерно расположенных позиций вдоль пути.
function getPositionsAlongPath(path: LineString | Position[], numPositions: number): Position[]
Параметры
- path
-
LineString | Position[]
Путь к получению позиций.
- numPositions
-
number
Количество позиций для получения.
Возвращаемое значение
Position[]
Массив равномерно расположенных позиций вдоль пути.
getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)
Вычисляет массив объектов положения, равных расстоянию от центральной точки, чтобы создать обычный многоугольник.
function getRegularPolygonPath(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[]
Параметры
- radius
-
number
Радиус регулярного многоугольника.
- numberOfPositions
-
number
Количество позиций многоугольника должно быть.
- units
-
string | DistanceUnits
Единица измерения расстояния. Значение по умолчанию — метр.
- offset
-
number
Смещение для поворота многоугольника. Если 0 первая позиция будет выровнена с Севером.
Возвращаемое значение
Position[]
Массив объектов положения, образующих обычный многоугольник.
getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)
Вычисляет массив объектов положения, равных расстоянию от центральной точки, чтобы создать обычный многоугольник, разбитый анимеридианом на несколько вложенных путей.
function getRegularPolygonPaths(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[][]
Параметры
- 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
Параметры
Последняя точка, из которой вычисляется скорость.
- 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
Параметры
- 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
Параметры
- fraction
-
number
Дробный параметр для вычисления средней точки. Значение по умолчанию 0.5.
Возвращаемое значение
Позиция, которая лежит на расстоянии между двумя объектами положения относительно первого объекта позиции.
mercatorPixelsToPositions(Pixel[], number)
Преобразует массив глобальных координат пикселей Mercator в массив геопространственных позиций на указанном уровне масштабирования. Глобальные координаты пикселей относятся к левому верхнему углу карты [-180, 90].
function mercatorPixelsToPositions(pixels: Pixel[], zoom: number): Position[]
Параметры
- pixels
-
Pixel[]
Массив координат пикселей.
- zoom
-
number
Масштаб.
Возвращаемое значение
Position[]
Массив позиций.
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[]
Массив позиций для поворота.
- angle
-
number
Величина поворота массива позиций в градусах по часовой стрелке.
Возвращаемое значение
Position[]
simplify((Position | Pixel)[], number)
Выполните Douglas-Peucker упрощение массива позиций или пикселей.
function simplify(points: (Position | Pixel)[], tolerance: number): (Position | Pixel)[]
Параметры
- tolerance
-
number
Допустимое использование в упрощении.
Возвращаемое значение
Новый массив упрощенного набора точек.