math module

リファレンス

パッケージ:: azure-maps-control

クラス

参照ポイントのセットから生成された Affine Transform クラス。

列挙型

AccelerationUnits	加速度の測定単位。
AreaUnits	エリアの測定単位。
DistanceUnits	距離の測定単位。
SpeedUnits	速度の測定単位。
TimeUnits	時間の測定単位。

機能

boundingBoxToPolygon(BoundingBox)	BoundingBox を取得し、多角形に変換します。
convertAcceleration(number, string \| AccelerationUnits, string \| AccelerationUnits, number)	加速度値を 1 つの単位から別の単位に変換します。サポートされる単位: milesPerSecondSquared、kmsPerSecondSquared、metersPerSecondSquared、feetPerSecondSquared yardsPerSecondSquared、kmsPerHoursSecond、milesPerHourSecond、knotsPerSecond、standardGravity
convertArea(number, string, string, number)	領域の値を 1 つの単位から別の単位に変換します。サポートされるユニット: squareMeters、acres、ヘクタール、squareFeet、squareYards、squareMiles、squareKilometers
convertDistance(number, string \| DistanceUnits, string \| DistanceUnits, number)	距離を 1 つの距離単位から別の距離単位に変換します。サポートされる単位: マイル、海里マイル、ヤード、メートル、キロメートル、フィート
convertSpeed(number, string \| SpeedUnits, string \| SpeedUnits, number)	速度値を 1 つの単位から別の単位に変換します。サポートされる単位: kmsPerHour、milesPerHour、metersPerSecond、feetPerSecond、ノット、mach
convertTimespan(number, string \| TimeUnits, string \| TimeUnits, number)	タイムスパン値を 1 つの単位から別の単位に変換します。サポートされる単位: ms (ミリ秒)、時間、分、秒
getAcceleration(number, number, number, string \| SpeedUnits, string \| DistanceUnits, string \| TimeUnits, string \| AccelerationUnits, number)	初期速度、移動距離、およびタイムスパンに基づいて加速度を計算します。数式: a = 2(d - vt)/t^2
getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string \| SpeedUnits, string \| AccelerationUnits, number)	タイムスタンププロパティと必要に応じて速度プロパティを持つ 2 つのポイントフィーチャ間の加速度を計算します。速度が指定されている場合は、パスが直線になっていない可能性があるため、ポイント間の距離を無視して計算します。速度が指定されていない場合、または最初のポイントでのみ提供される場合は、a = (v2 - v1)/(t2 - t1) ポイント間の直線距離を計算し、計算: a = 2(d - vt)/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` 指定した単位内の 2 つのポイント間の距離を指定するプロパティがあります。ジオメトリが Point の場合、そのポイントの位置が結果に使用されます。ジオメトリが MultiPoint の場合、個々の位置までの距離が使用されます。ジオメトリが Polygon または 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)	地表面上の 2 つの位置オブジェクト間の距離を、Haversine 数式を使用して計算します。
getEarthRadius(string \| DistanceUnits)	WGS84 の特定の距離単位内の地球の半径を取得します。
getGeodesicPath(LineString \| Position[], number)	位置オブジェクトの配列を取得し、それらの間のスペースを正確に配置された位置で埋め込み、近似測地線パスを形成します。
getGeodesicPaths(LineString \| Position[], number)	位置オブジェクトの配列を受け取り、それらの間のスペースを正確に配置された位置で埋め込み、antimeridian によって複数のサブパスに分割された近似測地線パスを形成します。
getHeading(Position \| Point, Position \| Point)	ある位置オブジェクトから別の位置オブジェクトへの見出しを計算します。
getLengthOfPath(LineString \| Position[], string \| DistanceUnits)	配列内のすべての位置オブジェクト間の距離を計算します。
getPathDenormalizedAtAntimerian(LineString \| Position[])	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)	中心点から等距離の位置オブジェクトの配列を計算し、antimeridian によって複数のサブパスに分割された通常のポリゴンを作成します。
getSpeed(Position \| Point \| Feature<Point, any>, Position \| Point \| Feature<Point, any>, number, string \| TimeUnits, string \| SpeedUnits, number)	指定された時間に基づいて、2 つのポイント間の平均移動速度を計算します。
getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string \| SpeedUnits, number)	タイムスタンプを含むプロパティを持つ 2 つのポイントフィーチャ間の平均移動速度を計算します。タイムスタンプには次の値を指定できます。 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)	2 つの日付またはタイムスタンプの間のタイムスパンを計算します。タイムスタンプは次の場合があります。 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)	2 つの位置オブジェクト間の小数部の距離である位置オブジェクトを計算します。
mercatorPixelsToPositions(Pixel[], number)	グローバルメルカトルピクセル座標の配列を、指定したズームレベルの地理空間位置の配列に変換します。グローバルピクセル座標は、マップの左上隅を基準にしています [-180, 90]。
mercatorPositionsToPixels(Position[], number)	位置の配列を、指定したズームレベルのグローバルメルカトルピクセル座標の配列に変換します。
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。

戻り値

Polygon

BoundingBox の多角形表現。

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

加速度値を 1 つの単位から別の単位に変換します。サポートされる単位: milesPerSecondSquared、kmsPerSecondSquared、metersPerSecondSquared、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)

領域の値を 1 つの単位から別の単位に変換します。サポートされるユニット: squareMeters、acres、ヘクタール、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)

距離を 1 つの距離単位から別の距離単位に変換します。サポートされる単位: マイル、海里マイル、ヤード、メートル、キロメートル、フィート

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)

速度値を 1 つの単位から別の単位に変換します。サポートされる単位: 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)

タイムスパン値を 1 つの単位から別の単位に変換します。サポートされる単位: 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/秒が使用されます。

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)

タイムスタンププロパティと必要に応じて速度プロパティを持つ 2 つのポイントフィーチャ間の加速度を計算します。速度が指定されている場合は、パスが直線になっていない可能性があるため、ポイント間の距離を無視して計算します。速度が指定されていない場合、または最初のポイントでのみ提供される場合は、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

タイムスタンププロパティと必要に応じて速度プロパティを持つ 2 つのポイントフィーチャ間の加速度。タイムスタンプを解析できない場合は 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

戻り値

Position[]

指定した位置の配列の間にカーディナルスプラインを形成する位置の配列。

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

ジオメトリのエッジ上の指定したポイントまたは位置に最も近いポイントを計算します。返されるポイントフィーチャには、 distance 指定した単位内の 2 つのポイント間の距離を指定するプロパティがあります。ジオメトリが 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 }>

パラメーター

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

凸包を計算する位置、ジオメトリ、または特徴の配列。

戻り値

Polygon

位置、ジオメトリ、またはフィーチャの配列からの凸包。

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

距離測定の単位。既定値はメートルです。

戻り値

Position

原点から指定した距離を示す位置。

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

地表面上の 2 つの位置オブジェクト間の距離を、Haversine 数式を使用して計算します。

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

パラメーター

origin: Position | Point

間の距離を計算する最初の位置。

destination: Position | Point

間の距離を計算する 2 番目の位置。

units: string | DistanceUnits

距離測定の単位。既定値はメートルです。

戻り値

number

指定した単位内の 2 つの位置間の最短距離。

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)

位置オブジェクトの配列を受け取り、それらの間のスペースを正確に配置された位置で埋め込み、antimeridian によって複数のサブパスに分割された近似測地線パスを形成します。

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 のパスを非正規化します。これにより、常に交差するアンタイムライダーの反対側に座標を持つ線が作成されます。タイムライダーを通過するパスには、-180 ~ 180 の範囲外の経度が含まれていることに注意してください。これが望ましくない場合は、getPathSplitByAntimeridian を参照してください。

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

パラメーター

path: LineString | Position[]

非正規化する位置オブジェクトまたはラインストリングの配列

戻り値

Position[]

位置オブジェクトの非正規化された配列。antimeridian を横断するパスには、-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

位置を抽出するデータオブジェクト。

戻り値

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

距離測定の単位。既定値はメートルです。

戻り値

Position

パスに従うときにパスの開始位置から指定した距離の位置オブジェクト。

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

パラメーター

origin: Position | Point

通常の多角形の中心。

radius: number

通常の多角形の半径。

numberOfPositions: number

多角形に必要な位置の数。

units: string | DistanceUnits

距離測定の単位。既定値はメートルです。

offset: number

多角形を回転させるオフセット。 0 の場合、最初の位置は North と一致します。

戻り値

Position[]

通常の多角形を形成する位置オブジェクトの配列。

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

中心点から等距離の位置オブジェクトの配列を計算し、antimeridian によって複数のサブパスに分割された通常のポリゴンを作成します。

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 の場合、最初の位置は North と一致します。

戻り値

Position[][]

通常の多角形を形成するパスの配列。 getRegularPolygonPath と比較すると、サブパスには常に -180 ~ 180 の範囲の経度が含まれます

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

指定された時間に基づいて、2 つのポイント間の平均移動速度を計算します。

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/秒が使用されます。

decimals: number

結果を丸める小数点以下の桁数。

戻り値

number

指定された時間に基づく 2 つのポイント間の平均移動速度。

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

タイムスタンプを含むプロパティを持つ 2 つのポイントフィーチャ間の平均移動速度を計算します。タイムスタンプには次の値を指定できます。

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/秒が使用されます。

decimals: number

結果を丸める小数点以下の桁数。

戻り値

number

指定した単位の速度。有効なタイムスタンプが見つからない場合は NaN。

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

2 つの日付またはタイムスタンプの間のタイムスパンを計算します。タイムスタンプは次の場合があります。

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

2 つの日付またはタイムスタンプの間のタイムスパン。タイムスタンプを解析できない場合は 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/秒が使用されます。

accelerationUnits: string

省略可能。加速度値の単位。指定しない場合は、m/s^2 が使用されます。

decimals: number

結果を丸める小数点以下の桁数。

戻り値

number

指定されたタイムスパン、速度、および必要に応じて加速度で移動した距離。

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

2 つの位置オブジェクト間の小数部の距離である位置オブジェクトを計算します。

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

パラメーター

origin: Position | Point

中間点間を計算する最初の位置。

destination: Position | Point

中間点を計算する 2 番目の位置。

fraction: number

中間点を計算する小数部パラメーター。既定値は 0.5 です。

戻り値

Position

最初の位置オブジェクトを基準にして、2 つの位置オブジェクト間の距離の割合を表す位置。

mercatorPixelsToPositions(Pixel[], number)

グローバルメルカトルピクセル座標の配列を、指定したズームレベルの地理空間位置の配列に変換します。グローバルピクセル座標は、マップの左上隅を基準にしています [-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[]

グローバルメルカトルピクセルの配列。

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

タイムスタンプを表す Date オブジェクト。タイムスタンプを解析できなかった場合は null。

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

位置の配列を取得し、指定した回転角度に対して指定した位置を中心に回転します。

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

パラメーター

positions: Position[]

回転する位置の配列。

origin: Position | Point

周囲の位置を回転させる位置。

angle: number

位置の配列を時計回りに度単位で回転する量。

戻り値

Position[]

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

位置またはピクセルの配列に対してDouglas-Peucker簡略化を実行します。

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

パラメーター

points: (Position | Pixel)[]

簡略化する位置またはピクセルポイント。

tolerance: number

簡略化で使用する許容値。

戻り値

(Position | Pixel)[]

ポイントの簡略化されたセットの新しい配列。

次の方法で共有

math module

クラス

列挙型

機能

関数の詳細

boundingBoxToPolygon(BoundingBox)

パラメーター

戻り値

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

パラメーター

戻り値

convertArea(number, string, string, number)

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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

パラメーター

戻り値

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)

パラメーター

戻り値

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)

パラメーター

戻り値

getEarthRadius(string | DistanceUnits)

パラメーター

戻り値

getGeodesicPath(LineString | Position[], number)

パラメーター

戻り値

getGeodesicPaths(LineString | Position[], number)

パラメーター

戻り値

getHeading(Position | Point, Position | Point)

パラメーター

戻り値

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

パラメーター

戻り値

getPathDenormalizedAtAntimerian(LineString | Position[])

パラメーター

戻り値

getPathSplitByAntimeridian(LineString | Position[])

パラメーター

戻り値

getPixelHeading(Position | Point, Position | Point)

パラメーター

戻り値

getPointsWithHeadingsAlongPath(LineString | Position[], number)

パラメーター

戻り値

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

パラメーター