Geometry Library

encoding 名前空間

google.maps.geometry.encoding 名前空間

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

const {encoding} = await google.maps.importLibrary("geometry") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。

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

球面クラス

google.maps.geometry.spherical クラス

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

const {spherical} = await google.maps.importLibrary("geometry") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。

静的メソッド
computeArea	computeArea(path[, radiusOfSphere]) パラメータ:  path:  Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral>|Circle|CircleLiteral|LatLngBounds|LatLngBoundsLiteral radiusOfSphere:  number optional 戻り値:  number 閉じたパスの符号なしの面積を返します。範囲は [0、2×π×半径²] です。計算された面積には、半径と同じ単位が使用されます。radiusOfSphere はデフォルトで地球の半径（メートル単位）に設定されます。この場合、面積は平方メートル単位になります。Circle を渡すには、radius を正の値に設定する必要があります。また、円は球の 100% を超えて覆ってはなりません。また、LatLngBounds を渡す場合、南の LatLng は北の LatLng より北にすることはできません。
computeDistanceBetween	computeDistanceBetween(from, to[, radius]) パラメータ:  from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral radius:  number optional 戻り値:  number 2 つの LatLng 間の距離をメートル単位で返します。必要に応じて、カスタムの半径を指定できます。半径はデフォルトで地球の半径になります。
computeHeading	computeHeading(from, to) パラメータ:  from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral 戻り値:  number ある LatLng から別の LatLng への向きを返します。方角は、真北から時計回りの角度で表し、[-180,180] の範囲内で指定します。
computeLength	computeLength(path[, radius]) パラメータ:  path:  Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> radius:  number optional 戻り値:  number 指定されたパスの長さを返します。
computeOffset	computeOffset(from, distance, heading[, radius]) パラメータ:  from:  LatLng|LatLngLiteral distance:  number heading:  number radius:  number optional 戻り値:  LatLng 指定された方角（北から時計回りの度数で表される）で始点から移動した距離に相当する LatLng を返します。
computeOffsetOrigin	computeOffsetOrigin(to, distance, heading[, radius]) パラメータ:  to:  LatLng|LatLngLiteral distance:  number heading:  number radius:  number optional 戻り値:  LatLng|null 目的地の LatLng、移動した距離、元の向きが指定されている場合に、出発地を返します。方角は、真北から時計回りの角度で表されます。解がない場合、この関数は null を返します。
computeSignedArea	computeSignedArea(loop[, radius]) パラメータ:  loop:  Array<LatLng|LatLngLiteral>|MVCArray<LatLng|LatLngLiteral> radius:  number optional 戻り値:  number 閉じたパスの符号付き面積を返します。反時計回りは正の値で、[-2×pi×半径²、2×pi×半径²] の範囲内です。計算された面積には、半径と同じ単位が使用されます。半径はデフォルトで地球の半径（メートル単位）に設定されます。この場合、面積は平方メートル単位になります。 面積は平行移動法を使用して計算されます。単位球上の閉じた経路の周りの平行移動は、経路で囲まれた面積に等しい角度でねじれます。これは、各三角形で Girard、l'Huilier、Eriksson を使用する三角測量よりも簡単で、より正確で堅牢です。特に、三角形分割を行わないため、ポリゴンのエッジ（対角線ではない）が 180 度にまたがる不可避なケースを除き、不安定になることはありません。
interpolate	interpolate(from, to, fraction) パラメータ:  from:  LatLng|LatLngLiteral to:  LatLng|LatLngLiteral fraction:  number 戻り値:  LatLng 起点の LatLng と終点の LatLng の間の距離の指定した部分にある LatLng を返します。

poly クラス

google.maps.geometry.poly クラス

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

const {poly} = await google.maps.importLibrary("geometry") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。

静的メソッド
containsLocation	containsLocation(point, polygon) パラメータ:  point:  LatLng|LatLngLiteral polygon:  Polygon 戻り値:  boolean 指定された点が指定されたポリゴン内にあるかどうかを計算します。
isLocationOnEdge	isLocationOnEdge(point, poly[, tolerance]) パラメータ:  point:  LatLng|LatLngLiteral poly:  Polygon|Polyline tolerance:  number optional 戻り値:  boolean 指定した地点がポリラインの線上か付近、またはポリゴンの境界線上か付近に存在するかどうかを、指定した許容値内で計算します。指定されたポイントの緯度と経度と、境界線上の最も近いポイントとの差が許容値未満の場合、true を返します。許容度はデフォルトで 10^-9 度に設定されています。