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

建構函式也接受 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({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

使用 v=beta 時,可透過呼叫 const {LatLng} = await google.map.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});

Geometry 程式庫不支援 LatLng 物件常值。

lat
類型:number
緯度度數。值將適用 [-90, 90] 這個範圍。這表示如果指定的值小於 -90,則會設為 -90。如果該值大於 90,這個值就會設為 90。
lng
類型:number
經度度數。[-180, 180] 範圍外的值會經過包裝,讓它們落在範圍內。舉例來說,系統會將 -190 的值轉換為 170。190 的值會轉換成 -170。這反映出全球的經度座標。

LatLngBounds 類別

google.maps.LatLngBounds 類別

LatLngBounds 執行個體代表地理座標中的矩形,包括跨越 180 度經度的里程數。

使用 v=beta 時,可透過呼叫 const {LatLngBounds} = await google.map.importLibrary("core") 來存取請參閱 Maps JavaScript API 中的程式庫

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
參數:
從西南角和東北角的點建構矩形。
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()
參數:
轉換為 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
延伸此界限以包含這個界限和指定界限結合的範圍。
MAX_BOUNDS 裝置的地球邊界 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

使用 v=beta 時,可透過呼叫 const {LatLngAltitude} = await google.map.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 類別

使用 v=beta 時,可透過呼叫 const {Point} = await google.map.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 類別

使用 v=beta 時,可透過呼叫 const {Size} = await google.map.importLibrary("core") 來存取請參閱 Maps JavaScript API 中的程式庫

Size
Size(width, height[, widthUnit, heightUnit])
參數:
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring 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
圓圈的中心。
radius
類型:number
地球表面的半徑 (單位為公尺)。
繼承: clickabledraggableeditablefillColorfillOpacitymapstrokeColorstrokeOpacitystrokePositionstrokeWeightvisiblezIndex