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 オブジェクトを受け入れるため、以下は同じです。

 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])
パラメータ: 
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
地理的位置を表す LatLng オブジェクトを作成します。緯度は、[-90, 90] の範囲の度数で指定します。経度は [-180, 180] の範囲の度数で指定します。この範囲外の値を有効にするには、noClampNoWraptrue に設定します。緯度と経度の順序に注意してください。
equals
equals(other)
パラメータ: 
戻り値:  boolean
比較関数。
lat
lat()
パラメータ: なし
戻り値:  number
緯度を度数で返します。
lng
lng()
パラメータ: なし
戻り値:  number
経度を度数で返します。
toJSON
toJSON()
パラメータ: なし
戻り値:  LatLngLiteral
JSON 表現に変換します。この関数は JSON.stringify で使用することが想定されています。
toString
toString()
パラメータ: なし
戻り値:  string
文字列表現に変換します。
toUrlValue
toUrlValue([precision])
パラメータ: 
  • precisionnumber 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 オブジェクト リテラルはジオメトリ ライブラリではサポートされていません。

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])
パラメータ: 
矩形を、南西の隅と北東の隅の位置から作成します。
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])
パラメータ: 
  • precisionnumber optional
戻り値:  string
この境界に対して「lat_lo,lng_lo,lat_hi,lng_hi」という形式の文字列を返します。「lo」は境界ボックスの南西の角、「hi」はそのボックスの北東の角を表します。
union
union(other)
パラメータ: 
戻り値:  LatLngBounds
この境界と指定された境界を連結した境界が含まれるように、この境界を拡大します。

LatLngBoundsLiteral インターフェース

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

API 全体で、LatLngBounds オブジェクトの代わりにオブジェクト リテラルを使用できます。これらは自動的に LatLngBounds オブジェクトに変換されます。southwestnortheast をすべて設定する必要があります。設定されていない場合、例外がスローされます。

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])
パラメータ: 
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 初期化値。
  • noClampNoWrapboolean optional 初期化値を保持するかどうかを指定します。初期化値が [-90, 90] の範囲の有効な緯度値や [-180, 180] の範囲の有効な経度値であるとは限りません。デフォルトは false で、緯度のクランプと経度の折り返しを有効にします。
altitude
タイプ:  number
高度を返します。
lat
タイプ:  number
緯度を返します。
lng
タイプ:  number
経度を返します。
equals
equals(other)
パラメータ: 
  • otherLatLngAltitude 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)
パラメータ: 
  • xnumber
  • ynumber
2 次元平面上の 1 つの点。
x
タイプ:  number
x 座標。
y
タイプ:  number
y 座標。
equals
equals(other)
パラメータ: 
戻り値:  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])
パラメータ: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
2 次元のサイズ。幅は X 軸の距離、高さは Y 軸の距離です。
height
タイプ:  number
y 軸に沿った高さ(ピクセル単位)。
width
タイプ:  number
x 軸に沿った幅(ピクセル単位)。
equals
equals(other)
パラメータ: 
戻り値:  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
地表面上の半径(メートル単位)。
継承: clickabledraggableeditablefillColorfillOpacitymapstrokeColorstrokeOpacitystrokePositionstrokeWeightvisiblezIndex