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])
參數： 
  • swOrLatLngBounds：