Geometry Library

encoding 名前空間

google.maps.geometry.encoding namespace
library "geometry"

ポリラインのエンコード/デコード用のユーティリティ。

const {encoding} = await google.maps.importLibrary("geometry");
decodePath
decodePath(encodedPath)
パラメータ:
  • encodedPath: string
戻り値: Array<LatLng>
エンコードされたパスの文字列を一連の LatLng にデコードします。
encodePath
encodePath(path)
パラメータ:
戻り値: string
一連の LatLng をエンコード パス文字列にエンコードします。

spherical 名前空間

google.maps.geometry.spherical namespace
library "geometry"

測地線の角度、距離、面積を計算するユーティリティ関数。デフォルトの半径は地球の半径（6,378,137 m）です。

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
パラメータ:
戻り値: number
閉じられたパスの符号なしの面積を [0, 2×pi×radius²] の範囲で返します。計算される面積は、半径と同じ単位を使用します。radiusOfSphere のデフォルトは地球の半径（メートル単位）です。この場合、面積は平方メートル単位になります。Circle を渡すには、radius を 0 以上の値に設定する必要があります。また、円が球の 100% を超えて覆うことはできません。また、LatLngBounds を渡す場合、南側の LatLng を北側の LatLng より北にすることはできません。
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
パラメータ:
戻り値: number
2 つの LatLng 間の距離をメートル単位で返します。必要に応じて、カスタム半径を指定できます。半径のデフォルトは地球の半径です。
computeHeading
computeHeading(from, to)
パラメータ:
戻り値: number
ある LatLng から別の LatLng への方向を返します。方角は、北から時計回りの角度で [-180,180] の範囲で表されます。
computeLength
computeLength(path[, radius])
パラメータ:
戻り値: number
指定されたパスの長さを返します。
computeOffset
computeOffset(from, distance, heading[, radius])
パラメータ:
戻り値: LatLng
指定された方向（北から時計回りの度数で表される）に、起点から一定の距離を移動した結果の LatLng を返します。
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
パラメータ:
戻り値: LatLng|null
LatLng の目的地、移動距離（メートル）、元の進行方向を指定すると、出発地の位置情報を返します。方角は、北から時計回りの角度で表されます。この関数は、解がない場合は null を返します。
computeSignedArea
computeSignedArea(loop[, radius])
パラメータ:
戻り値: number
閉じたパスの符号付き面積を返します。反時計回りは正で、範囲は [-2×pi×radius², 2×pi×radius²] です。計算された面積は、半径と同じ単位を使用します。半径のデフォルトは地球の半径（メートル単位）です。この場合、面積は平方メートル単位になります。

面積は平行移動法を使用して計算されます。単位球上の閉じたパスの周りの平行移動は、パスで囲まれた面積に等しい角度だけねじれます。この方法は、各三角形で Girard、l'Huilier、Eriksson を使用する三角測量よりもシンプルで、正確かつ堅牢です。特に、三角形分割を行わないため、多角形のエッジ（対角線ではない）が 180 度にまたがるという避けられない場合を除き、不安定になることはありません。
interpolate
interpolate(from, to, fraction)
パラメータ:
戻り値: LatLng
出発地の LatLng と目的地の LatLng の間の指定された比率に位置する LatLng を返します。
AlphatraversePath
traversePath(path, fraction)
パラメータ:
戻り値: LatLngLiteral
指定されたパスに沿って、指定された割合の位置を返します。LatLngAltitude オブジェクトを渡す場合、現時点では高度は無視されますが、今後のバージョンでは高度が考慮される可能性があります。

poly 名前空間

google.maps.geometry.poly namespace
library "geometry"

ポリゴンやポリラインに関する計算を行うユーティリティ関数。

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
パラメータ:
戻り値: boolean
指定された地点が指定されたポリゴンの内部にあるかどうかを計算します。
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
パラメータ:
戻り値: boolean
指定された地点が、指定された許容範囲内で、ポリライン上またはポリラインの近く、あるいはポリゴンの境界線上または境界線の近くにあるかどうかを計算します。指定された地点の緯度と経度、およびエッジ上の最も近い地点の差が許容値より小さい場合、true を返します。許容値のデフォルトは 10-9 度です。