Geometry Library

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

名前空間のエンコード

google.maps.geometry.encoding 名前空間

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

&libraries=geometry URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {encoding} = await google.map.importLibrary("geometry") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

decodePath
decodePath(encodedPath)
パラメータ:
  • encodedPath: string
戻り値: Array<LatLng>
エンコードされたパスの文字列を一連の LatLng にデコードします。
encodePath
encodePath(path)
戻り値: string
一連の LatLng をエンコード パス文字列にエンコードします。

spherical 名前空間

google.maps.geometry.spherical 名前空間

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

&libraries=geometry URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {spherical} = await google.map.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 間の距離をメートル単位で返します。オプションでカスタム半径を指定できます。半径はデフォルトで地球の半径です。
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] の範囲で返します。計算された領域は、半径と同じ単位を使用します。半径はデフォルトで、地球の半径(メートル単位)になります。この場合、面積は平方メートルになります。

面積は平行移動法により計算されます。これは、単位球の閉じられた経路を中心とする平行移動が、経路で囲まれた領域に等しい角度で曲がります。この操作は、各三角形で Girard、l'Huilier、Erikson を使用した三角形よりも簡単で、正確で堅牢です。特に、三角形の形ではないため、ポリゴンの対角線(対角線ではない)が 180 度を超える場合、避けられない場合、不安定さはありません。
interpolate
interpolate(from, to, fraction)
パラメータ:
戻り値: LatLng
出発地の LatLng と目的地の LatLng との間の中間で指定された LatLng の LatLng を返します。

poly 名前空間

google.maps.geometry.poly 名前空間

ポリゴンとポリラインを使用する計算用のユーティリティ関数。

&libraries=geometry URL パラメータを使用して読み込みます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

v=beta を使用している場合は、const {poly} = await google.map.importLibrary("geometry") を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。

containsLocation
containsLocation(point, polygon)
パラメータ:
戻り値: boolean
指定された地点が、指定されたポリゴン内にあるかどうかを計算します。
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
パラメータ:
戻り値: boolean
指定の地点が、指定された許容範囲内でポリラインまたはポリゴンの境界線上にあるか、その付近かを計算します。指定されたポイントの経度と緯度の差が許容値よりも小さい場合、true を返します。許容値は、デフォルトで 10 ~9 度です。