GeolocationCoordinates: longitude 屬性

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

GeolocationCoordinates 介面的只讀屬性 longitude 是一個數字,表示地理位置的經度,以十進位制度表示。結合表示測量時間的 Unix 時間戳(毫秒),GeolocationCoordinates 物件是 GeolocationPosition 介面的一部分,該介面是 Geolocation API 函式返回的地理位置資訊的物件型別。

longitude 中的值是 Coordinates 物件所描述的地球上位置的地理經度,以十進位制度表示。該值由世界大地測量系統 1984 (WGS 84) 規範定義。

注意:零子午線(也稱為本初子午線或參考子午線)與大多數人認為的格林威治子午線並不完全相同。它實際上是 國際地球自轉參考系參考子午線 (IERS Reference Meridian),它位於格林威治子午線以東 5.3 角秒(102 米 / 335 英尺)。這是 全球定位系統 (GPS) 使用的相同標準。

示例

在這個簡單的示例中,我們獲取使用者的位置,並在座標返回後顯示它們。

JavaScript

下面的 JavaScript 程式碼建立了一個事件監聽器,以便在使用者點選按鈕時,檢索並顯示位置資訊。

js
let button = document.getElementById("get-location");
let latText = document.getElementById("latitude");
let longText = document.getElementById("longitude");

button.addEventListener("click", () => {
  navigator.geolocation.getCurrentPosition((position) => {
    let lat = position.coords.latitude;
    let long = position.coords.longitude;

    latText.innerText = lat.toFixed(2);
    longText.innerText = long.toFixed(2);
  });
});

在設定了方便引用按鈕元素以及將要顯示緯度和經度的兩個元素的變數後,透過在 <button> 元素上呼叫 addEventListener() 來建立事件監聽器。當用戶點選按鈕時,我們將獲取並顯示位置資訊。

在接收到 click 事件後,我們呼叫 getCurrentPosition() 來請求裝置當前的位置。這是一個非同步請求,因此我們提供一個回撥函式,該函式接收一個描述已確定位置的 GeolocationPosition 物件作為輸入。

GeolocationPosition 物件中,我們使用 position.coords.latitudeposition.coords.longitude 獲取使用者的緯度和經度,以便更新顯示座標。在將這兩個 <span> 元素轉換為保留兩位小數的值後,更新它們以顯示相應的值。

HTML

用於展示結果的 HTML 如下所示:

html
<p>
  Your location is <span id="latitude">0.00</span>° latitude by
  <span id="longitude">0.00</span>° longitude.
</p>
<button id="get-location">Get My Location</button>

結果

在此處試用此示例

規範

規範
Geolocation
# latitude-longitude-and-accuracy-attributes

瀏覽器相容性

另見