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

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 度經度的里程值。

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」的字串;針對此邊界,「lot;lo」代表對應邊界方塊的西南角,而「quot;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

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

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

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
圓圈的中心。
radius
類型:number
地球表面上的半徑 (單位為公尺)。
繼承: clickabledraggableeditablefillColorfillOpacitymapstrokeColorstrokeOpacitystrokePositionstrokeWeightvisiblezIndex