Coordinates

LatLng 類別

google.maps.LatLng class

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});

建構函式也接受 LatLngLiteralLatLng 物件。如果 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]。將 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])
參數: 
  • precisionnumber 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 class

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 class

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)
參數: 
傳回值:  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 class

請呼叫 const {Point} = await google.maps.importLibrary("core") 存取。請參閱「Maps JavaScript API 中的程式庫」。

Point
Point(x, y)
參數: 
  • xnumber
  • ynumber
2 D 平面上的一點。
x
類型:  number
X 座標
y
類型:  number
Y 座標
equals
equals(other)
參數: 
傳回值:  boolean
比較兩個點
toString
toString()
參數:
傳回值:  string
傳回這一點的字串形式。

Size 類別

google.maps.Size class

請呼叫 const {Size} = await google.maps.importLibrary("core") 存取。請參閱「Maps JavaScript API 中的程式庫」。

Size
Size(width, height[, widthUnit, heightUnit])
參數: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
二維尺寸,其中寬度是 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
地球表面的半徑 (以公尺為單位)。
繼承: clickabledraggableeditablefillColorfillOpacitymapstrokeColorstrokeOpacitystrokePositionstrokeWeightvisiblezIndex

Orientation3D 類別

google.maps.Orientation3D class

Orientation3D 是三維向量,用於沿著標頭、傾斜和滾動進行標準數學旋轉轉換。

  • heading 是介於 [0, 360) 度之間的角度。
  • tilt 是介於 [0, 360) 度之間的角度。
  • roll 是介於 [0, 360) 度之間的角度。

這個類別會實作 Orientation3DLiteral

請呼叫 const {Orientation3D} = await google.maps.importLibrary("core") 存取。請參閱「Maps JavaScript API 中的程式庫」。

Orientation3D
Orientation3D(value)
參數: 
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)
參數: 
傳回值:  boolean 是否兩個物件相等。
Comparison 函式。
toJSON
toJSON()
參數:
傳回值:  Orientation3DLiteral
轉換為 JSON 表示法。這個函式可透過 JSON.stringify 使用。

Orientation3DLiteral 介面

google.maps.Orientation3DLiteral 介面

為方便起見,許多地方都會接受物件字面值取代 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 class

Vector3D 是用於標準數學運算的三維向量,例如沿著本機 x、y 和 z 軸縮放三維物件的邊界。

  • x 為實數。
  • y 為實數。
  • z 為實數。

這個類別會實作 Vector3DLiteral

請呼叫 const {Vector3D} = await google.maps.importLibrary("core") 存取。請參閱「Maps JavaScript API 中的程式庫」。

Vector3D
Vector3D(value)
參數: 
x
類型:  number
三維向量的 X 元件。
y
類型:  number
三維向量的 Y 元件。
z
類型:  number
三維向量的 Z 元件。
equals
equals(other)
參數: 
傳回值:  boolean
Comparison 函式。
toJSON
toJSON()
參數:
傳回值:  Vector3DLiteral
轉換為 JSON 表示法。這個函式可透過 JSON.stringify 使用。

Vector3DLiteral 介面

google.maps.Vector3DLiteral 介面

為方便起見,許多地方都會接受物件字面值取代 Vector3D 物件。當 Maps API 遇到這些物件時,會將其轉換為 Vector3D 物件。

x
類型:  number
三維向量的 X 元件。
y
類型:  number
三維向量的 Y 元件。
z
類型:  number
三維向量的 Z 元件。