Coordinates

LatLng 類別

google.maps.LatLng 類別

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, 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 類別

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 類別

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 類別

呼叫 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 類別

呼叫 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
傳回此大小的字串形式。

邊框間距介面

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