本頁面由 Cloud Translation API 翻譯而成。

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

建構函式也接受 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({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])` 參數： `latOrLatLngOrLatLngLiteral`：`number\|LatLngLiteral\|LatLng` `lngOrNoClampNoWrap`：`number\|boolean optional` `noClampNoWrap`：`boolean optional` 建立代表地理位置點的 `LatLng` 物件。緯度以 [-90, 90] 的範圍指定度數。經度可指定 [-180, 180] 範圍內的度數。將 `noClampNoWrap` 設為 `true`，即可啟用此範圍以外的值。請注意緯度和經度的順序。

建構函式

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)` 參數： `other`：`LatLng` 傳回值：`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 類別

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

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

建構函式
`LatLngBounds`	`LatLngBounds([swOrLatLngBounds, ne])` 參數： `swOrLatLngBounds`：`LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral optional` `ne`：`LatLng\|LatLngLiteral optional` 從西南角和東北角的點建構矩形。

方法
`contains`	`contains(latLng)` 參數： `latLng`：`LatLng\|LatLngLiteral` 傳回值：`boolean` 如果指定的經緯度，在這個邊界內傳回 `true`。
`equals`	`equals(other)` 參數： `other`：`LatLngBounds\|LatLngBoundsLiteral optional` 傳回值：`boolean` 如果此邊界大約等於指定邊界，則傳回 `true`。
`extend`	`extend(point)` 參數： `point`：`LatLng\|LatLngLiteral` 傳回值：`LatLngBounds` 延伸此界限以包含指定的點。
`getCenter`	`getCenter()` 參數：無傳回值：`LatLng` 計算此 LatLngBounds 的中心。
`getNorthEast`	`getNorthEast()` 參數：無傳回值：`LatLng` 傳回此界限的東北角。
`getSouthWest`	`getSouthWest()` 參數：無傳回值：`LatLng` 傳回此界限的西南角。
`intersects`	`intersects(other)` 參數： `other`：`LatLngBounds\|LatLngBoundsLiteral` 傳回值：`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)` 參數： `other`：`LatLngBounds\|LatLngBoundsLiteral` 傳回值：`LatLngBounds` 延伸此界限以包含這個界限和指定界限結合的範圍。

常數
`MAX_BOUNDS`	裝置的地球邊界 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 類別

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])` 參數： `value`：`LatLngAltitude\|LatLngAltitudeLiteral\|LatLng\|LatLngLiteral`初始化值。 `noClampNoWrap`：`boolean optional` 是否保留初始化值，即使它們不一定是 [-90, 90] 範圍內的有效緯度值，或者是 [-180, 180] 範圍內的有效經度值。預設值為 `false`，即可啟用緯度和經度換行功能。

屬性
`altitude`	類型：`number` 傳回高度。
`lat`	類型：`number` 傳回緯度。
`lng`	類型：`number` 傳回經度。

方法
`equals`	`equals(other)` 參數： `other`：`LatLngAltitude optional`另一個 LatLngAltitude 物件。傳回值：`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)` 參數： `x`：`number` `y`：`number` 2 D 平面上的一點。

屬性
`x`	類型：`number` X 座標
`y`	類型：`number` Y 座標

方法
`equals`	`equals(other)` 參數： `other`：`Point` 傳回值：`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])` 參數： `width`：`number` `height`：`number` `widthUnit`：`string optional` `heightUnit`：`string optional` 雙維度大小，其中寬度是 X 軸的距離，高度則是指 Y 軸的距離。

屬性
`height`	類型：`number` 沿著 Y 軸的高度 (單位為像素)。
`width`	類型：`number` 沿著 X 軸的寬度 (單位為像素)。

方法
`equals`	`equals(other)` 參數： `other`：`Size` 傳回值：`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`

Coordinates

LatLng 類別

建構函式

方法

LatLngLiteral 介面

屬性

LatLngBounds 類別

建構函式

方法

常數

LatLngBoundsLiteral 介面

屬性

LatLngAltitude 類別

建構函式

屬性

方法

LatLngAltitudeLiteral 介面

屬性

Point 類別

建構函式

屬性

方法

Size 類別

建構函式

屬性

方法

Padding 介面

屬性

CircleLiteral 介面

屬性