Coordinates

LatLng 類別

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 介面

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 class

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 class

LatLngAltitude 是地理座標中的 3D 點:經度、緯度和海拔高度。

  • 緯度範圍介於正負 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。

lat
類型:  number
緯度度數。值會限制在 [-90, 90] 範圍內。也就是說,如果指定的值小於 -90,就會設為 -90。如果值大於 90,則會設為 90。
lng
類型:  number
經度度數。超出 [-180, 180] 範圍的值會換算為範圍內的值。舉例來說,-190 會轉換為 170。190 會轉換為 -170。這反映出經度環繞地球的事實。
altitude optional
類型:  number optional
預設值: 0
離地表的高度 (以公尺為單位)。負值表示在地表下方。

Point 類別

google.maps.Point class

呼叫 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 class

呼叫 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)
參數: 
  • other:Size optional
傳回值:  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
地表上的半徑 (以公尺為單位)。
繼承: clickable、draggable、editable、fillColor、fillOpacity、map、strokeColor、strokeOpacity、strokePosition、strokeWeight、visible、zIndex

Orientation3D 類別

google.maps.Orientation3D class

Orientation3D 是三維向量,用於沿著航向、傾斜和滾動進行標準數學旋轉轉換。

  • heading 是介於 [0, 360) 度範圍內的角度。
  • 傾斜角度介於 [0, 360) 度。
  • 滾動角度介於 [0, 360) 度之間。

這個類別會實作 Orientation3DLiteral。

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

Orientation3D
Orientation3D(value)
參數: 
heading
類型:  number
預設值: 0
繞 Z 軸旋轉 (垂直於地球表面)。預設值為 0,代表北方。正旋轉是指沿著 Z 軸順時針旋轉,以 0 到 360 度的角度表示。凡是超出這個範圍,都會換算為範圍內的值。舉例來說,-190 會轉換為 170。530 則會轉換為 170。
roll
類型:  number
預設值: 0
繞 Y 軸旋轉。正旋轉是指繞著 Y 軸順時針旋轉,以 0 到 360 度的角度表示。凡是超出這個範圍,都會換算為範圍內的值。舉例來說,-190 會轉換為 170。530 則會轉換為 170。
tilt
類型:  number
預設值: 0
繞 X 軸旋轉。正旋轉是指繞著 X 軸順時針旋轉,以 0 到 360 度表示。凡是超出這個範圍,都會換算為範圍內的值。舉例來說,-190 會轉換為 170。530 則會轉換為 170。
equals
equals(other)
參數: 
傳回值:  boolean 兩個物件是否相等。
Comparison 函式。
toJSON
toJSON()
參數:無
傳回值:  Orientation3DLiteral
轉換為 JSON 表示法。這個函式應透過 JSON.stringify 使用。

Orientation3DLiteral 介面

google.maps.Orientation3DLiteral 介面

在許多情況下,物件常值可取代 Orientation3D 物件,方便您使用。Maps API 遇到這些物件時,會將其轉換為 Orientation3D 物件。

heading optional
類型:  number optional
繞 Z 軸旋轉 (垂直於地球表面)。預設值為 0,代表北方。正旋轉是指沿著 Z 軸順時針旋轉,以 0 到 360 度表示。
roll optional
類型:  number optional
繞 Y 軸旋轉。正旋轉是指繞著 Y 軸順時針旋轉,以 0 到 360 度的角度表示。
tilt optional
類型:  number optional
繞 X 軸旋轉。正旋轉角度是繞著 X 軸順時針旋轉,以 0 到 360 度表示。

Vector3D 類別

google.maps.Vector3D class

Vector3D 是三維向量,用於標準數學運算,例如沿著局部 x、y 和 z 軸縮放三維物件的邊界。

  • x 是實數。
  • y 是實數。
  • z 是實數。

這個類別會實作 Vector3DLiteral。

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

Vector3D
Vector3D(value)
參數: 
x
類型:  number
三維向量的 X 元件。
y
類型:  number
三維向量的 Y 元件。
z
類型:  number
三維向量的 Z 元件。
equals
equals(other)
參數: 
傳回值:  boolean
Comparison 函式。
toJSON
toJSON()
參數:無
傳回值:  Vector3DLiteral
轉換為 JSON 表示法。這個函式應透過 JSON.stringify 使用。

Vector3DLiteral 介面

google.maps.Vector3DLiteral 介面

在許多情況下,物件常值可取代 Vector3D 物件,方便您使用。Maps API 遇到這些物件時,會將其轉換為 Vector3D 物件。

x
類型:  number
三維向量的 X 元件。
y
類型:  number
三維向量的 Y 元件。
z
類型:  number
三維向量的 Z 元件。