Geometry Library

encoding 名前空間

google.maps.geometry.encoding Namespace

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

const {encoding} = await google.maps.importLibrary("geometry") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
decodePath
decodePath(encodedPath)
パラメータ: 
  • encodedPath:  string
戻り値:  Array<LatLng>
エンコードされたパスの文字列を一連の LatLng にデコードします。
encodePath
encodePath(path)
パラメータ: 
戻り値:  string
一連の LatLng をエンコード パス文字列にエンコードします。

spherical 名前空間

google.maps.geometry.spherical Namespace

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

const {spherical} = await google.maps.importLibrary("geometry") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
computeArea
computeArea(path[, radiusOfSphere])
パラメータ: 
戻り値:  number
閉じられたパスの符号なし領域を [0, 2×pi×radius2] の範囲で返します。計算された領域には半径と同じ単位が使用されます。radiusOfSphere のデフォルトは、地球の半径（メートル単位）です。この場合の面積は平方メートルです。Circle を渡すには、radius を正の値に設定する必要があります。また、円が球の 100% を超えて覆ってはなりません。また、LatLngBounds を渡す場合、南部の LatLng を北部の LatLng より北にすることはできません。
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
パラメータ: 
戻り値:  number
2 つの LatLng 間の距離をメートル単位で返します。必要に応じてカスタムの半径を指定することもできます。radius は、デフォルトでは地球の半径です。
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×radius2, 2×pi×radius2] の範囲で返します。計算された領域には半径と同じ単位が使用されます。radius のデフォルトは、地球の半径（メートル単位）です。この場合、面積の単位は平方メートルです。

面積は、並列トランスポート法を使って計算されます。単位球上で閉じたパスを中心とした並行輸送は、パスで囲まれた面積と等しい角度でねじられます。これは、各三角形に Girard、l'Huilier、Eriksson を使用する三角法よりもシンプルで正確で堅牢です。特に、ポリゴンのエッジ（対角線ではない）が 180 度に及ぶことが避けられない場合を除き、三角形は分割されないため、不安定性はありません。
interpolate
interpolate(from, to, fraction)
パラメータ: 
戻り値:  LatLng
出発地の LatLng と目的地の LatLng の間の、指定された地点の LatLng を返します。

poly 名前空間

google.maps.geometry.poly Namespace

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

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