Coordinates

LatLng 類別

google.maps.LatLng 類別

LatLng 是地理座標的一個點：緯度和經度。

  • 緯度介於 -90 到 90 度 (含首尾)。凡是超出這個範圍的值，都會調整為 [-90, 90] 的範圍。這表示如果指定的值小於 -90，則會設為 -90。如果值大於 90，則會設為 90。
  • 經度-180度到180度（含）之間的範圍。凡是超出這個範圍的值，都會納入換行值，因此落在範圍內。舉例來說，值 -190 會轉換為 170。系統會將 190 的值轉換為 -170。這代表經度在全球各地周圍的經度。
雖然預設的地圖投影會將經度與地圖的 x 座標，將緯度與地圖的 y 座標建立關聯，但緯度座標一律為第一個，後面接著經度。
請注意，您無法修改 LatLng 的座標。如要計算其他點，您必須建立新的 Point。

大多數接受 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])
參數： 
  • latOrLatLngOrLatLngLiteral：number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap：number|boolean optional
  • noClampNoWrap：boolean optional
建立代表地理位置的 LatLng 物件。緯度的測量單位為範圍 [-90, 90]。以度為單位 ( [-180, 180])，以度為單位指定經度。將 noClampNoWrap 設為 true，即可啟用這個範圍以外的值。請注意緯度和經度的順序。
equals
equals(other)
參數： 
傳回價值：  boolean
Comparison 函式。
lat
lat()
參數：無
傳回價值：  number
傳回緯度 (以度為單位)。
lng
lng()
參數：無
傳回價值：  number
傳回經度 (以度為單位)。
toJSON
toJSON()
參數：無
傳回價值：  LatLngLiteral
轉換為 JSON 表示法。這個函式的用途是透過 JSON.stringify 使用。
toString
toString()
參數：無
傳回價值：  string
轉換為字串形式。
toUrlValue
toUrlValue([precision])
參數： 
  • precision：number optional
傳回價值：  string
以「lat,lng」形式傳回此 LatLng 的字串。根據預設，我們會將 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])
參數： 
從西南角和東北角的點建構矩形。
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
延伸此界限以包含這個界限和指定界限結合的範圍。
MAX_BOUNDS 最大地球邊界的 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)
參數： 
傳回值：  boolean兩個物件是否相等。
Comparison 函式。
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 D 平面上的一點。
x
類型：  number
X 座標
y
類型：  number
Y 座標
equals
equals(other)
參數： 
傳回價值：  boolean
比較兩個點
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
2D 尺寸，其中寬度是 X 軸的距離，高度為 Y 軸的距離。
height
類型：  number
沿著 Y 軸的高度 (單位為像素)。
width
類型：  number
沿著 X 軸的寬度 (單位為像素)。
equals
equals(other)
參數： 
傳回價值：  boolean
比較兩個大小。
toString
toString()
參數：無
傳回價值：  string
傳回此大小的字串形式。

邊框間距介面

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