Coordinates

LatLng 類別

google.maps.LatLng 類別

LatLng 是地理座標 (經緯度) 中的點。

  • 緯度範圍介於 -90 到 90 度 (含首尾)。凡是高於或低於這個範圍的值都會限制為 [-90, 90] 範圍。這表示如果指定的值小於 -90,系統會將其設為 -90。如果該值大於 90,則會設為 90。
  • 經度-180度到180度(含)之間的範圍。凡是高於或低於這個範圍的值,都會納入計算範圍,舉例來說,值 -190 會轉換成 170。190 的值將轉換為 -170。這反映出地球周圍的經度。
雖然預設地圖投影會將經度關聯到地圖的 x 座標,將緯度與 y 座標建立關聯,但寫出經緯度座標時,請一律先寫成「第一個」,接著輸入經度。
請注意,您無法修改 LatLng 的座標。如果想計算其他 Point,就必須先建立新的 Point。

大多數接受 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 類別

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

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

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

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

Size
Size(width, height[, widthUnit, heightUnit])
參數: 
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
2D 大小,其中寬度是 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