Coordinates

LatLng class

google.maps.LatLng class

LatLng 是地理座標中的點，也就是經緯度。

  • 緯度的範圍介於正負 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 interface

google.maps.LatLngLiteral 介面

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

範例：

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Geometry 程式庫不支援 LatLng 物件常值。
lat
類型：  number
緯度度數。值會調整到 [-90, 90] 範圍內。也就是說，如果指定的值小於 -90，系統會將值設為 -90。如果值大於 90，系統會將其設為 90。
lng
類型：  number
經度度數。超出 [-180, 180] 範圍的值會換算為範圍內的值。舉例來說，值為 -190 會轉換為 170。190 會轉換為 -170。這反映出經度會環繞地球。

LatLngBounds class

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 interface

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 class

google.maps.LatLngAltitude class

LatLngAltitude 是地理座標中的 3D 點，包括緯度、經度和海拔高度。

  • 緯度的範圍介於正負 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 物件。地圖 API 遇到這些物件時，會將其轉換為 LatLngAltitude 物件。

這個介面會擴充 LatLngLiteral。

altitude
類型：  number
預設值： 0
高於地面的距離 (以公尺為單位)。負值代表地面下方。
lat
類型：  number
緯度度數。值會調整到 [-90, 90] 範圍內。也就是說，如果指定的值小於 -90，系統會將值設為 -90。如果值大於 90，系統會將其設為 90。
lng
類型：  number
經度度數。超出 [-180, 180] 範圍的值會換算為範圍內的值。舉例來說，值為 -190 會轉換為 170。190 會轉換為 -170。這反映出經度會環繞地球。

Point class

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 class

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 class

google.maps.Orientation3D class

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

  • 航向是介於 [0, 360) 度之間的角度。
  • 傾斜角度是介於 [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 物件。地圖 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 class

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 物件。地圖 API 遇到這些物件時，會將其轉換為 Vector3D 物件。
x
類型：  number
三維向量的 X 元件。
y
類型：  number
三維向量的 Y 元件。
z
類型：  number
三維向量的 Z 分量。