LatLng 類別
google.maps.LatLng
類別
LatLng
是地理座標 (經緯度) 中的點。
- 緯度範圍介於 -90 到 90 度 (含首尾)。凡是高於或低於這個範圍的值都會限制為 [-90, 90] 範圍。這表示如果指定的值小於 -90,系統會將其設為 -90。如果該值大於 90,則會設為 90。
- 經度-180度到180度(含)之間的範圍。凡是高於或低於這個範圍的值,都會納入計算範圍,舉例來說,值 -190 會轉換成 170。190 的值將轉換為 -170。這反映出地球周圍的經度。
請注意,您無法修改
LatLng
的座標。如果想計算其他 Point,就必須先建立新的 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]) 參數:
從西南角和東北角的點建構矩形。 |
常數 | |
---|---|
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]) 參數:
傳回值:
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
類別
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 傳回此大小的字串形式。 |
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
|