math module

接受 BoundingBox 並將它轉換成多邊形。

function boundingBoxToPolygon(bounds: BoundingBox): Polygon

參數

傳回

BoundingBox 的多邊形表示。

將加速值從一個單位轉換成另一個單位。 支援的單位：milesPerSecondSquared、kmsPerSecondSquared、metersPerSecondSquared、英呎PerSecondSquared、kmsPerHoursSecond、milesPerHourSecond、knotsPerSecond、standardGravity

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

參數

傳回

從一個單位轉換到另一個單位的加速值。

將區域值從一個單位轉換成另一個單位。 支援的單位：squareMeters、ometer、ometers、squareFeet、squareYards、squareMiles、squareKilometers

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

參數

傳回

從一個單位轉換到另一個單位的區域值。

將距離從一個距離單位轉換成另一個單位。 支援的單位：英哩、nauticalMiles、碼、公尺、公里、英呎

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

參數

傳回

新單位中的距離。

將速度值從一個單位轉換成另一個單位。 支援的單位：kmsPerHour、milesPerHour、公尺PerSecond、英呎PerSecond、knots、mach

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

參數

傳回

從一個單位轉換到另一個單位的速度值。

將時間範圍值從一個單位轉換為另一個單位。 支援的單位：ms (毫秒) 、小時、分鐘、秒

function convertTimespan(timespan: number, fromUnits: string | TimeUnits, toUnits: string | TimeUnits, decimals?: number): 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

參數

傳回

以初始速度、行進距離和時間範圍為基礎的加速。

計算具有時間戳記屬性和選擇性速度屬性的兩個點特徵之間的加速。 如果提供速度，請忽略點之間的距離，因為路徑可能不是直線並計算：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

參數

傳回

兩個點特徵之間的加速，其具有時間戳記屬性和選擇性的速度屬性。 如果無法剖析時間戳記，則會傳回 NaN。

根據初始速度、最終速度和時間範圍計算加速。 公式：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

參數

傳回

以初始速度、最終速度和時間範圍為基礎的加速。

計算指定單位中幾何的近似區域

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

參數

傳回

指定單位中幾何的區域。

計算在指定位置陣列之間形成基數曲線的位置陣列。

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

參數

傳回

在指定的位置陣列之間形成基數曲線的位置陣列。

計算幾何邊緣上最接近指定點或位置的點。 傳回的點特徵會有 屬性 distance ，指定指定單位中兩個點之間的距離。 如果幾何是 Point，則會將該點位置用於結果。 如果幾何是 MultiPoint，則會使用個別位置的距離。 如果幾何是 Polygon 或 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 }>

參數

傳回

從位置、幾何或特徵陣列計算凸殼。

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

參數

傳回

從位置、幾何或特徵陣列的凸殼。

根據起始位置、標題、距離和距離單位類型來計算目的地位置。

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

參數

傳回

與原點距離指定距離的位置。

使用 Haversine 公式計算地球表面上兩個位置物件之間的距離。

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

參數

傳回

指定單位中兩個位置之間的最短距離。

擷取 WGS84 特定距離單位中地球的半徑。

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

參數

傳回

數位，表示特定距離單位中地球的半徑。

取得位置物件的陣列，並填入其之間的空間，並精確定位位置以形成近似的地理路徑。

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

參數

傳回

構成地理路徑的位置物件陣列，地理路徑跨越時間ridian 的地理路徑將包含 -180 到 180 範圍的經度。 當這是不想要的時，請參閱 getGeodesicPaths () 。

接受位置物件的陣列，並填入兩者之間的空間，並精確定位的位置，以形成以時間ridian 細分成多個子路徑的近似地理路徑。

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

參數

傳回

形成地理路徑的路徑陣列，比較至 getGeodesicPath，子路徑一律會包含 -180 到 180 範圍的經度

將標題從某個位置物件計算到另一個位置物件。

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

參數

傳回

介於 0 到 360 之間的標題。 0 度因北而已。

計算陣列中所有位置物件之間的距離。

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

參數

傳回

在指定單位的地球表面上，陣列中所有位置物件之間的所有位置之間的距離。

反正規化 antimeridian 上的路徑，這會使座標位於 antimeridian 的相反端的線條一律交叉。 請注意，跨越 antimeridian 的路徑將包含 -180 到 180 範圍以外的經度。 當不需要時，請參閱 getPathSplitByAntimeridian。

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

參數

傳回

位置物件的反正規化陣列，跨timeridian 的路徑將包含 -180 到 180 範圍以外的經度。

將 antimeridian 上的路徑分割成多個路徑。 如果不需要，請參閱 getPathDenormalizedAtAntimerian。

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

參數

傳回

路徑會依時間ridian 分割成多個路徑。

根據 Mercator 地圖投影，計算一個位置到另一個位置的圖元精確標題。 此標題的視覺效果正確。

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

參數

傳回

取得沿著路徑具有標題的平均間距點陣列。

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

參數

傳回

具有路徑標題的平均間距點陣列。

取得具有沿著路徑之指定距離的標題點。

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

參數

傳回

具有沿著路徑指定距離的點。

取得物件的位置，該物件是位置、點、點特徵或圓形。 如果是圓形，則會傳回其中心座標。

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

參數

傳回

物件的位置，該物件是位置、點或點特徵。 如果傳入不正確資料，則傳回 Null。

計算路徑上與路徑開頭距離所指定距離的位置物件。 如果指定的距離超過路徑的長度，則會傳回路徑的最後一個位置。

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

參數

傳回

位置物件，當追蹤路徑時，該位置物件與路徑的開頭距離。

擷取所提供幾何、特徵或幾何/特徵陣列中所有位置的陣列。

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[]

參數

傳回

所提供幾何、特徵或幾何/特徵陣列中所有位置的陣列。

取得路徑上平均間距位置的陣列。

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

參數

傳回

路徑上平均間距位置的陣列。

計算與中央點相等距離的位置物件陣列，以建立一般多邊形。

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

參數

傳回

形成一般多邊形的位置物件陣列。

計算與中央點相等距離的位置物件陣列，以在多個子路徑中建立一般多邊形中斷。

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

參數

傳回

形成一般多邊形的路徑陣列。 相較于 getRegularPolygonPath，子路徑一律會包含 -180 到 180 範圍的經度

根據提供的時間量，計算兩點之間的平均移動速度。

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

參數

傳回

根據提供的時間量，在兩點之間移動的平均速度。

計算具有包含時間戳記之屬性的兩個點特徵之間的平均移動速度。 時間戳記可以是;

• JavaScript Date 物件
• 數位，表示自 1970 年 1 月 1 日起的毫秒數。
• 使用下列其中一種格式的字串：
  • 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

參數

傳回

如果找不到有效的時間戳記，則為指定單位或 NaN 的速度。

計算兩個日期或時間戳記之間的時間範圍。 時間戳記可以是;

• JavaScript Date 物件
• 數位，表示自 1970 年 1 月 1 日起的毫秒數。
• 使用下列其中一種格式的字串：
  • 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

參數

傳回

兩個日期或時間戳記之間的時間範圍。 如果無法剖析時間戳記，則傳回 NaN。

計算指定時間範圍、速度和選擇性加速的距離。 公式：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

參數

傳回

指定時間範圍、速度和選擇性加速的距離。

計算兩個位置物件之間的小數距離位置物件。

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

參數

傳回

位於兩個位置物件之間的距離分數的位置，相對於第一個位置物件。

將全域 Mercator 圖元座標的陣列轉換成指定縮放層級的地理空間位置陣列。 全域圖元座標相對於地圖的左上角 [-180， 90]。

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

參數

傳回

位置的陣列。

將位置陣列轉換成指定縮放層級的全域 Mercator 圖元座標陣列。

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

參數

傳回

全域 Mercator 圖元的陣列。

將 -90 到 90 度之間的緯度值正規化。

function normalizeLatitude(lat: number): number

參數

傳回

將 -180 到 180 度之間的經度值正規化。

function normalizeLongitude(lng: number): number

參數

傳回

將時間戳記剖析為 JavaScript Date 物件。 時間戳記可以是;

• JavaScript Date 物件
• 數位，表示自 1970 年 1 月 1 日起的毫秒數。
• 使用下列其中一種格式的字串：
  • ISO8601 日期格式 (亦即 2012-04-23T18：25：43.511Z)
  • RFC282 / IETF 日期語法 (3.3 節)
  • OData 日期字串 (即 「/Date (1235764800000) /」)

function parseTimestamp(timestamp: Date | string | number): Date

參數

傳回

Date 物件，表示時間戳記，如果無法剖析時間戳記，則為 Null。

採用位置陣列，並針對指定的旋轉角度繞著指定位置旋轉。

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

參數

傳回

在位置或圖元陣列上執行Douglas-Peucker簡化。

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

參數

傳回

簡化點集的新陣列。