math module

클래스

AffineTransform

참조 지점 집합에서 생성된 Affine Transform 클래스입니다.

열거형

AccelerationUnits

가속을 위한 측정 단위입니다.

AreaUnits

영역의 측정 단위입니다.

DistanceUnits

거리에 대한 측정 단위입니다.

SpeedUnits

속도에 대한 측정 단위입니다.

TimeUnits

시간 단위입니다.

함수

boundingBoxToPolygon(BoundingBox)

BoundingBox를 사용하여 다각형으로 변환합니다.

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

가속 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: milesPerSecondSquared, kmPerSecondSquared, metersPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kmPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity

convertArea(number, string, string, number)

영역 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: squareMeters, 에이커, 헥타르, squareFeet, squareYards, squareMiles, squareKilometers

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

거리를 한 거리 단위에서 다른 거리 단위로 변환합니다. 지원되는 단위: 마일, nauticalMiles, 야드, 미터, 킬로미터, 피트

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

속도 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: kmPerHour, milesPerHour, metersPerSecond, feetPerSecond, knots, mach

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

시간 범위 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: ms(밀리초), 시간, 분, 초

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)

타임스탬프 속성과 필요에 따라 속도 속성이 있는 두 점 기능 간의 가속을 계산합니다. 속도가 제공되면 경로가 직선이 아닐 수 있으므로 점 사이의 거리를 무시하고 계산합니다. 속도가 제공되지 않거나 첫 번째 지점에서만 제공되는 경우 = (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)

위치, 기하 도형 또는 기능 배열에서 Convex Hull을 계산합니다.

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의 경로를 비정규화합니다. 이렇게 하면 항메리디안의 반대쪽에 좌표가 있는 선이 항상 교차합니다. antimeridian을 건너는 경로는 -180에서 180 범위 외부의 경도를 포함합니다. 원하는 것이 아닌 경우 getPathSplitByAntimeridian을 참조하세요.

getPathSplitByAntimeridian(LineString | Position[])

antimeridian의 경로를 여러 경로로 분할합니다. 원하는 것이 아닌 경우 getPathDenormalizedAtAntimerian을 참조하세요.

getPixelHeading(Position | Point, Position | Point)

Mercator 맵 프로젝션에 따라 한 위치에서 다른 위치로의 픽셀 정확한 제목을 계산합니다. 이 제목은 시각적으로 정확합니다.

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 개체
  • 1970년 1월 1일 이후의 밀리초 수를 나타내는 숫자입니다.
  • 다음 형식 중 하나를 사용하는 문자열입니다.
    • 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 개체
  • 1970년 1월 1일 이후의 밀리초 수를 나타내는 숫자입니다.
  • 다음 형식 중 하나를 사용하는 문자열입니다.
    • 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)

지정된 확대/축소 수준에서 위치 배열을 전역 Mercator 픽셀 좌표 배열로 변환합니다.

normalizeLatitude(number)

-90도에서 90도 사이의 위도 값을 정규화합니다.

normalizeLongitude(number)

-180도에서 180도 사이의 경도 값을 정규화합니다.

parseTimestamp(Date | string | number)

타임스탬프를 JavaScript Date 개체로 구문 분석합니다. 타임스탬프는 다음과 같습니다.

  • JavaScript Date 개체
  • 1970년 1월 1일 이후의 밀리초 수를 나타내는 숫자입니다.
  • 다음 형식 중 하나를 사용하는 문자열입니다.
    • 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, kmPerSecondSquared, metersPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kmPerHoursSecond, 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)

거리를 한 거리 단위에서 다른 거리 단위로 변환합니다. 지원되는 단위: 마일, nauticalMiles, 야드, 미터, 킬로미터, 피트

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)

속도 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: kmPerHour, milesPerHour, metersPerSecond, feetPerSecond, knots, 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)

시간 범위 값을 한 단위에서 다른 단위로 변환합니다. 지원되는 단위: ms(밀리초), 시간, 분, 초

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)

타임스탬프 속성과 필요에 따라 속도 속성이 있는 두 점 기능 간의 가속을 계산합니다. 속도가 제공되면 경로가 직선이 아닐 수 있으므로 점 사이의 거리를 무시하고 계산합니다. 속도가 제공되지 않거나 첫 번째 지점에서만 제공되는 경우 = (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)

위치, 기하 도형 또는 기능 배열에서 Convex Hull을 계산합니다.

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의 경로를 비정규화합니다. 이렇게 하면 항메리디안의 반대쪽에 좌표가 있는 선이 항상 교차합니다. 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)

Mercator 맵 프로젝션에 따라 한 위치에서 다른 위치로의 픽셀 정확한 제목을 계산합니다. 이 제목은 시각적으로 정확합니다.

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 개체
  • 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

매개 변수

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 개체
  • 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

매개 변수

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)

지정된 확대/축소 수준에서 위치 배열을 전역 Mercator 픽셀 좌표 배열로 변환합니다.

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)

타임스탬프를 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

매개 변수

timestamp

Date | string | number

구문 분석할 타임스탬프 값입니다.

반환

Date

타임스탬프를 구문 분석할 수 없는 경우 타임스탬프 또는 null을 나타내는 Date 개체입니다.

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

간소화된 점 집합의 새 배열입니다.