LatLng 類別
google.maps.LatLng
類別
LatLng
是地理座標的一個點:緯度和經度。
- 緯度介於 -90 到 90 度 (含首尾)。凡是超出這個範圍的值,都會調整為 [-90, 90] 的範圍。這表示如果指定的值小於 -90,則會設為 -90。如果值大於 90,則會設為 90。
- 經度-180度到180度(含)之間的範圍。凡是超出這個範圍的值,都會納入換行值,因此落在範圍內。舉例來說,值 -190 會轉換為 170。系統會將 190 的值轉換為 -170。這代表經度在全球各地周圍的經度。
請注意,您無法修改
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]) 參數:
建立代表地理位置的 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]) 參數:
傳回價值:
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]) 參數:
傳回價值:
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]) 參數:
|
屬性 | |
---|---|
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) 參數:
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]) 參數:
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 |