Coordinates

LatLng クラス

google.maps.LatLng クラス
ライブラリ "core"

LatLng は、地理座標（緯度と経度）のポイントです。

  • 緯度は -90 ～ 90 度の範囲になります。この範囲以外の値は、-90 ～ 90 の範囲に収まるように変換されます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
  • 経度は -180～180 度の範囲になります。この範囲以外の値は、この範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。
デフォルトの地図投影法では、経度が地図の X 座標に、緯度が Y 座標に関連付けられますが、緯度座標は常に最初に記述され、その後に経度が続きます。
LatLng の座標は変更できません。別のポイントを計算する場合は、新しいポイントを作成する必要があります。

LatLng オブジェクトを受け入れるほとんどのメソッドは LatLngLiteral オブジェクトも受け入れるため、次の 2 つは同等です。

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151});

コンストラクタは LatLngLiteral オブジェクトと LatLng オブジェクトも受け入れます。LatLng インスタンスがコンストラクタに渡されると、コピーが作成されます。

コンストラクタの呼び出しは次のとおりです。

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 

const {LatLng} = await google.maps.importLibrary("core");
LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
パラメータ:
  • latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap: number|boolean optional
  • noClampNoWrap: boolean optional
地理的位置を表す LatLng オブジェクトを作成します。緯度は [-90, 90] の範囲で指定します。経度は、[-180, 180) の範囲内で度単位で指定します。この範囲外の値を有効にするには、noClampNoWrap を true に設定します。緯度と経度の順序に注意してください。
equals
equals(other)
パラメータ:
戻り値: boolean
2 つの LatLng の比較関数。座標が互いに 1e-9 以内にある場合は true、それ以外の場合は false を返します。
lat
lat()
パラメータ: なし
戻り値: number
緯度を度数で返します。
lng
lng()
パラメータ: なし
戻り値: number
経度を度数で返します。
toJSON
toJSON()
パラメータ: なし
戻り値: LatLngLiteral
JSON 表現に変換します。この関数は、JSON.stringify を介して使用することを目的としています。
toString
toString()
パラメータ: なし
戻り値: string
文字列表現に変換します。
toUrlValue
toUrlValue([precision])
パラメータ:
  • precision: number optional
戻り値: string
この LatLng の「lat,lng」形式の文字列を返します。lat/lng 値はデフォルトで小数第 6 位に丸めます。

LatLngLiteral インターフェース

google.maps.LatLngLiteral インターフェース

多くの場所で、LatLng オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは、Maps API で検出されると LatLng オブジェクトに変換されます。

例:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

LatLng オブジェクト リテラルは、Geometry ライブラリではサポートされていません。
lat
タイプ: number
緯度。値は [-90, 90] の範囲に収められます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
lng
タイプ: number
経度。[-180, 180] の範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。

LatLngBounds クラス

google.maps.LatLngBounds クラス
ライブラリ "core"

LatLngBounds インスタンスは、地理座標の長方形を表します。これには、経度 180 度の経線をまたぐ長方形も含まれます。

const {LatLngBounds} = await google.maps.importLibrary("core");
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
パラメータ:
矩形を、南西の隅と北東の隅の位置から作成します。
MAX_BOUNDS 地球の最大境界の LatLngBounds。これらの境界は地球全体を囲みます。
contains
contains(latLng)
パラメータ:
戻り値: boolean
指定された緯度 / 経度がこの境界内にある場合は true を返します。
equals
equals(other)
パラメータ:
戻り値: boolean
この境界が指定された境界とほぼ等しい場合は true を返します。
extend
extend(point)
パラメータ:
戻り値: LatLngBounds
指定された地点が含まれるようにこの境界を拡大します。
getCenter
getCenter()
パラメータ: なし
戻り値: LatLng
この LatLngBounds の中心を計算します。
getNorthEast
getNorthEast()
パラメータ: なし
戻り値: LatLng
この境界の北東端を返します。
getSouthWest
getSouthWest()
パラメータ: なし
戻り値: LatLng
この境界の南西端を返します。
intersects
intersects(other)
パラメータ:
戻り値: boolean
この境界が他の境界とポイントを共有している場合は true を返します。
isEmpty
isEmpty()
パラメータ: なし
戻り値: boolean
境界が空の場合に返します。
toJSON
toJSON()
パラメータ: なし
戻り値: LatLngBoundsLiteral
JSON 表現に変換します。この関数は、JSON.stringify を介して使用することを目的としています。
toSpan
toSpan()
パラメータ: なし
戻り値: LatLng
指定された地図の境界を lat/lng 境界に変換します。
toString
toString()
パラメータ: なし
戻り値: string
文字列に変換します。
toUrlValue
toUrlValue([precision])
パラメータ:
  • precision: number optional
戻り値: string
この境界の「lat_lo,lng_lo,lat_hi,lng_hi」形式の文字列を返します。ここで、「lo」は境界ボックスの南西の角に対応し、「hi」はそのボックスの北東の角に対応します。
union
union(other)
パラメータ:
戻り値: LatLngBounds
この境界と指定された境界を連結した境界が含まれるように、この境界を拡大します。

LatLngBoundsLiteral インターフェース

google.maps.LatLngBoundsLiteral インターフェース

API 全体で、LatLngBounds オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは自動的に LatLngBounds オブジェクトに変換されます。south、west、north、east をすべて設定する必要があります。設定しないと、例外がスローされます。
east
タイプ: number
東経（度単位）。[-180, 180] の範囲外の値は、[-180, 180) の範囲にラップされます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。
north
タイプ: number
北緯（度単位）。値は [-90, 90] の範囲に収められます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
south
タイプ: number
南緯（度単位）。値は [-90, 90] の範囲に収められます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
west
タイプ: number
西経（度単位）。[-180, 180] の範囲外の値は、[-180, 180) の範囲にラップされます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。

LatLngAltitude クラス

google.maps.LatLngAltitude class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

LatLngAltitude は、緯度、経度、高度の地理座標における 3D ポイントです。

  • 緯度は -90 ～ 90 度の範囲になります。この範囲以外の値は、-90 ～ 90 の範囲に収まるように変換されます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
  • 経度は -180～180 度の範囲になります。この範囲以外の値は、この範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。
  • 高度はメートル単位で測定されます。正の値は地上からの高さを表し、負の値は地下の深さを表します。

const {LatLngAltitude} = await google.maps.importLibrary("core");
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
パラメータ:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 初期化値。
  • noClampNoWrap: boolean optional 初期化値を保持するかどうか。初期化値が [-90, 90] の範囲の有効な緯度値または [-180, 180] の範囲の有効な経度値でない場合でも保持されます。デフォルトは false で、緯度のクランプと経度のラップが有効になります。
altitude
readonly
タイプ: number
高度を返します。
lat
readonly
タイプ: number
緯度を返します。
lng
readonly
タイプ: number
経度を返します。
equals
equals(other)
パラメータ:
戻り値: boolean 2 つのオブジェクトが等しいかどうか。
2 つの LatLngAltitude の比較関数。座標が互いに 1e-9 以内にある場合は true、それ以外の場合は false を返します。
toJSON
toJSON([key])
パラメータ:
  • key: string optional
戻り値: LatLngAltitudeLiteral
プレーン オブジェクトに変換します。

LatLngAltitudeLiteral インターフェース

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

多くの場所で、LatLngAltitude オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは、Maps API で検出されると LatLngAltitude オブジェクトに変換されます。
altitude
タイプ: number
地表からの距離（メートル単位）。負の値は地表の下を意味します。
lat
タイプ: number
緯度。値は [-90, 90] の範囲に収められます。つまり、指定された値が -90 未満の場合、-90 に設定されます。値が 90 を超える場合は 90 に設定されます。
lng
タイプ: number
経度。[-180, 180] の範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を一周していることを反映しています。

Point クラス

google.maps.Point クラス
ライブラリ "core" 

const {Point} = await google.maps.importLibrary("core");
Point
Point(x, y)
パラメータ:
  • x: number
  • y: number
2 次元平面上の点。
x
タイプ: number
x 座標。
y
タイプ: number
y 座標。
equals
equals(other)
パラメータ:
戻り値: boolean
2 つの地点を比較します。
toString
toString()
パラメータ: なし
戻り値: string
この地点の文字列表現を返します。

Size クラス

google.maps.Size クラス
ライブラリ "core" 

const {Size} = await google.maps.importLibrary("core");
Size
Size(width, height[, widthUnit, heightUnit])
パラメータ:
  • width: number
  • height: number
  • widthUnit: string optional
  • heightUnit: string optional
2 次元のサイズ。幅は X 軸上の距離、高さは Y 軸上の距離です。
height
タイプ: number
y 軸に沿った高さ（ピクセル単位）。
width
タイプ: number
x 軸に沿った幅（ピクセル単位）。
equals
equals(other)
パラメータ:
  • other: Size optional
戻り値: boolean
2 つのサイズを比較します。
toString
toString()
パラメータ: なし
戻り値: string
このサイズの文字列表現を返します。

Padding インターフェース

google.maps.Padding インターフェース
bottom
省略可
タイプ: number optional
下部のパディング（ピクセル単位）。
left
省略可
タイプ: number optional
左側のパディング（ピクセル単位）。
right
省略可
タイプ: number optional
右側のパディング（ピクセル単位）。
top
省略可
タイプ: number optional
上部のパディング（ピクセル単位）。

CircleLiteral インターフェース

google.maps.CircleLiteral interface
extends CircleOptions

円を表すオブジェクト リテラル。
center
円の中心。
radius
タイプ: number
地表上の半径（メートル単位）。
継承: clickable、 draggable、 editable、 fillColor、 fillOpacity、 map、 strokeColor、 strokeOpacity、 strokePosition、 strokeWeight、 visible、 zIndex

Orientation3D クラス

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

Orientation3D は、ヘディング、チルト、ロールに沿った標準的な数学的回転変換に使用される 3 次元ベクトルです。

  • heading は、[0, 360) 度の範囲の角度です。
  • tilt は [0, 360) 度の範囲の角度です。
  • roll は [0, 360) 度の範囲の角度です。

const {Orientation3D} = await google.maps.importLibrary("core");
Orientation3D
Orientation3D(value)
パラメータ:
heading
readonly
タイプ: number
デフォルト: 0
Z 軸（地表に対して垂直）を中心とした回転。値 0（デフォルト）は北に相当します。正の回転は Z 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。この範囲以外の値は、この範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。530 の値も 170 に変換されます。
roll
readonly
タイプ: number
デフォルト: 0
Y 軸を中心とした回転。正の回転は Y 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。この範囲以外の値は、この範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 530 も 170 に変換されます。
tilt
readonly
タイプ: number
デフォルト: 0
X 軸を中心とした回転。正の回転は X 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。この範囲以外の値は、この範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 530 も 170 に変換されます。
equals
equals(other)
パラメータ:
戻り値: boolean 2 つのオブジェクトが等しいかどうか。
比較関数。
toJSON
toJSON([key])
パラメータ:
  • key: string optional
戻り値: Orientation3DLiteral
プレーン オブジェクトに変換します。

Orientation3DLiteral インターフェース

google.maps.Orientation3DLiteral インターフェース

多くの場所で、Orientation3D オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは、Maps API で検出されると Orientation3D オブジェクトに変換されます。
heading
省略可
タイプ: number optional
Z 軸（地表に対して垂直）を中心とした回転。値 0（デフォルト）は北に相当します。正の回転は Z 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。
roll
省略可
タイプ: number optional
Y 軸を中心とした回転。正の回転は Y 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。
tilt
省略可
タイプ: number optional
X 軸を中心とした回転。正の回転は X 軸を中心とした時計回りで、0 ～ 360 度の範囲で指定します。

Vector3D クラス

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

Vector3D は、ローカルの x 軸、y 軸、z 軸に沿って 3 次元オブジェクトの境界をスケーリングするなど、標準的な数学演算に使用される 3 次元ベクトルです。

  • x は実数です。
  • y は実数です。
  • z は実数です。

const {Vector3D} = await google.maps.importLibrary("core");
Vector3D
Vector3D(value)
パラメータ:
x
readonly
タイプ: number
3 次元ベクトルの X 成分。
y
readonly
タイプ: number
3 次元ベクトルの Y 成分。
z
readonly
タイプ: number
3 次元ベクトルの Z 成分。
equals
equals(other)
パラメータ:
  • other: Vector3D|Vector3DLiteral optional 別の Vector3D オブジェクトまたは Vector3DLiteral オブジェクト。
戻り値: boolean
比較関数。
toJSON
toJSON([key])
パラメータ:
  • key: string optional
戻り値: Vector3DLiteral
プレーン オブジェクトに変換します。

Vector3DLiteral インターフェース

google.maps.Vector3DLiteral インターフェース

多くの場所で、Vector3D オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは、Maps API で検出されると Vector3D オブジェクトに変換されます。
x
タイプ: number
3 次元ベクトルの X 成分。
y
タイプ: number
3 次元ベクトルの Y 成分。
z
タイプ: number
3 次元ベクトルの Z 成分。