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

建構函式也接受 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 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])
參數： 
  • precision：number optional
傳回值：  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 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])
參數： 
  • 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 class

請呼叫 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 class

請呼叫 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
二維尺寸，其中寬度是 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

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 元件。