Coordinates

LatLng クラス

google.maps.LatLng クラス

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") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。

コンストラクタ
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) パラメータ:  other:  LatLng 戻り値:  boolean 比較関数。
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 クラス

LatLngBounds インスタンスは、経度 180 度経線をまたぐ長方形など、地理座標の長方形を表します。

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

コンストラクタ
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) パラメータ:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional 矩形を、南西の隅と北東の隅の位置から作成します。

定数
MAX_BOUNDS	地球の最大境界を表す LatLngBounds。これらの境界は地球全体を網羅します。

メソッド
contains	contains(latLng) パラメータ:  latLng:  LatLng|LatLngLiteral 戻り値:  boolean 指定された緯度/経度がこの範囲内にある場合、true を返します。
equals	equals(other) パラメータ:  other:  LatLngBounds|LatLngBoundsLiteral optional 戻り値:  boolean この境界が指定された境界とほぼ等しい場合、true を返します。
extend	extend(point) パラメータ:  point:  LatLng|LatLngLiteral 戻り値:  LatLngBounds 指定された地点が含まれるようにこの境界を拡大します。
getCenter	getCenter() パラメータ: なし 戻り値:  LatLng この LatLngBounds の中心を計算します。
getNorthEast	getNorthEast() パラメータ: なし 戻り値:  LatLng この境界の北東端を返します。
getSouthWest	getSouthWest() パラメータ: なし 戻り値:  LatLng この境界の南西端を返します。
intersects	intersects(other) パラメータ:  other:  LatLngBounds|LatLngBoundsLiteral 戻り値:  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) パラメータ:  other:  LatLngBounds|LatLngBoundsLiteral 戻り値:  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 クラス

LatLngAltitude は、緯度、経度、高度の地理座標で表される 3D ポイントです。

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

このクラスは LatLngAltitudeLiteral を実装します。

このクラスは LatLngLiteral を実装します。

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

コンストラクタ
LatLngAltitude	LatLngAltitude(value[, noClampNoWrap]) パラメータ:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 初期化値。 noClampNoWrap:  boolean optional 初期値を保持するかどうか。[-90, 90] の範囲内の有効な緯度値や [-180, 180] の範囲内の有効な経度値でない場合でも保持します。デフォルトは false で、緯度のクランプと経度のラップが有効になります。

プロパティ
altitude	タイプ:  number 高度を返します。
lat	タイプ:  number 緯度を返します。
lng	タイプ:  number 経度を返します。

メソッド
equals	equals(other) パラメータ:  other:  LatLngAltitude optional 別の LatLngAltitude オブジェクト。 戻り値:  boolean 2 つのオブジェクトが等しいかどうか。 比較関数。
toJSON	toJSON() パラメータ: なし 戻り値:  LatLngAltitudeLiteral このオブジェクトの JSON 表現。

LatLngAltitudeLiteral インターフェース

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

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

このインターフェースは LatLngLiteral を拡張します。

プロパティ
altitude	タイプ:  number デフォルト: 0 地表からの距離（メートル単位）。負の値は地表の下を意味します。
lat	タイプ:  number 緯度。値は [-90, 90] の範囲に制限されます。つまり、指定された値が -90 未満の場合は、-90 に設定されます。値が 90 より大きい場合は 90 に設定されます。
lng	タイプ:  number 経度。[-180, 180] の範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 190 は -170 に変換されます。これは、経度が地球を囲んでいることを反映しています。

Point クラス

google.maps.Point クラス

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

コンストラクタ
Point	Point(x, y) パラメータ:  x:  number y:  number 2 次元の平面上の点。

プロパティ
x	タイプ:  number x 座標。
y	タイプ:  number y 座標。

メソッド
equals	equals(other) パラメータ:  other:  Point optional 戻り値:  boolean 2 つの地点を比較します。
toString	toString() パラメータ: なし 戻り値:  string この地点の文字列表現を返します。

Size クラス

google.maps.Size クラス

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

コンストラクタ
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 戻り値:  boolean 2 つのサイズを比較します。
toString	toString() パラメータ: なし 戻り値:  string このサイズの文字列表現を返します。

Padding インターフェース

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

プロパティ
bottom optional	タイプ:  number optional 下部のパディング（ピクセル単位）。
left optional	タイプ:  number optional 左側のパディング（ピクセル単位）。
right optional	タイプ:  number optional 右側のパディング（ピクセル単位）。
top optional	タイプ:  number optional 上部のパディング（ピクセル単位）。

CircleLiteral インターフェース

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

円を表すオブジェクト リテラル。

このインターフェースは CircleOptions を拡張します。

プロパティ
center	タイプ:  LatLng|LatLngLiteral 円の中心。
radius	タイプ:  number 地球表面上の半径（メートル単位）。
継承: clickable、 draggable、 editable、 fillColor、 fillOpacity、 map、 strokeColor、 strokeOpacity、 strokePosition、 strokeWeight、 visible、 zIndex

Orientation3D クラス

google.maps.Orientation3D クラス

注: v=alpha チャネルでのみ利用できます。

Orientation3D は、方位、傾斜、ロールに沿った標準的な数学的な回転変換に使用される 3 次元ベクトルです。

• heading は、[0, 360] 度の範囲内の角度です。
• tilt は、[0, 360] 度の範囲内の角度です。
• roll は、0 度以上 360 度未満の角度です。

このクラスは Orientation3DLiteral を実装します。

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

コンストラクタ
Orientation3D	Orientation3D(value) パラメータ:  value:  Orientation3D|Orientation3DLiteral 初期化値。

プロパティ
heading	タイプ:  number デフォルト: 0 z 軸（地球の表面に対して垂直な軸）の回転。値 0（デフォルト）は北を表します。正の回転は z 軸の周りを時計回りに行い、0 ～ 360 度の角度で指定します。この範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 530 も 170 に変換されます。
roll	タイプ:  number デフォルト: 0 Y 軸を中心に回転します。正の回転は Y 軸の周りを時計回りに行い、0 ～ 360 度の角度で指定します。この範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 530 も 170 に変換されます。
tilt	タイプ:  number デフォルト: 0 X 軸を中心に回転します。正の回転は、X 軸の周りを時計回りに回転し、0 ～ 360 度の角度で指定します。この範囲外の値は、範囲内に収まるように変換されます。たとえば、値 -190 は 170 に変換されます。値 530 も 170 に変換されます。

メソッド
equals	equals(other) パラメータ:  other:  Orientation3D|Orientation3DLiteral optional 別の Orientation3D オブジェクト。 戻り値:  boolean 2 つのオブジェクトが等しいかどうか。 比較関数。
toJSON	toJSON() パラメータ: なし 戻り値:  Orientation3DLiteral JSON 表現に変換します。この関数は、JSON.stringify を介して使用することを目的としています。

Orientation3DLiteral インターフェース

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

注: v=alpha チャネルでのみ利用できます。

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

プロパティ
heading optional	タイプ:  number optional z 軸（地球の表面に対して垂直な軸）の回転。値 0（デフォルト）は北を表します。正の回転は z 軸の周りを時計回りに行い、0 ～ 360 度の角度で指定します。
roll optional	タイプ:  number optional Y 軸を中心に回転します。正の回転は Y 軸の周りを時計回りに行い、0 ～ 360 度の角度で指定します。
tilt optional	タイプ:  number optional X 軸を中心に回転します。正の回転は、X 軸の周りを時計回りに回転し、0 ～ 360 度の角度で指定します。

Vector3D クラス

google.maps.Vector3D クラス

注: v=alpha チャネルでのみ利用できます。

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

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

このクラスは Vector3DLiteral を実装します。

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

コンストラクタ
Vector3D	Vector3D(value) パラメータ:  value:  Vector3D|Vector3DLiteral 初期化値。

プロパティ
x	タイプ:  number 3 次元ベクトルの X 成分。
y	タイプ:  number 3 次元ベクトルの Y 成分。
z	タイプ:  number 3 次元ベクトルの Z 成分。

メソッド
equals	equals(other) パラメータ:  other:  Vector3D|Vector3DLiteral optional 別の Vector3D オブジェクトまたは Vector3DLiteral オブジェクト。 戻り値:  boolean 比較関数。
toJSON	toJSON() パラメータ: なし 戻り値:  Vector3DLiteral JSON 表現に変換します。この関数は、JSON.stringify を介して使用することを目的としています。

Vector3DLiteral インターフェース

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

注: v=alpha チャネルでのみ利用できます。

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

プロパティ
x	タイプ:  number 3 次元ベクトルの X 成分。
y	タイプ:  number 3 次元ベクトルの Y 成分。
z	タイプ:  number 3 次元ベクトルの Z 成分。