HTML5 地理定位

HTML5 Geolocation（地理定位）用于定位使用者的位置。

親自試一試：在谷歌地圖上顯示您的位置

定位使用者的位置

HTML5 Geolocation API 用于獲得使用者的地理位置。

鑒于該特性可能侵犯使用者的隐私，除非使用者同意，否則使用者位置資訊是不可用的。

浏覽器支援

Internet Explorer 9、Firefox、Chrome、Safari 以及 Opera 支援地理定位。

注釋：對于擁有 GPS 的裝置，比如 iPhone，地理定位更加精确。

HTML5 - 使用地理定位

請使用 getCurrentPosition() 方法來獲得使用者的位置。

下例是一個簡單的地理定位執行個體，可傳回使用者位置的經度和緯度。

執行個體

<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.         getCurrentPosition(showPosition)                ;
    }
  else{x.innerHTML="Geolocation is not supported by this browser.";}
  }
function showPosition(position)
  {
  x.innerHTML="Latitude: " + position.coords.latitude +
  "<br />Longitude: " + position.coords.longitude;
  }
</script>
      

親自試一試

例子解釋：

• 檢測是否支援地理定位
• 如果支援，則運作 getCurrentPosition() 方法。如果不支援，則向使用者顯示一段消息。
• 如果getCurrentPosition()運作成功，則向參數showPosition中規定的函數傳回一個coordinates對象
• showPosition() 函數獲得并顯示經度和緯度

上面的例子是一個非常基礎的地理定位腳本，不含錯誤處理。

處理錯誤和拒絕

getCurrentPosition() 方法的第二個參數用于處理錯誤。它規定當擷取使用者位置失敗時運作的函數：

執行個體

function showError(error)
  {
  switch(error.code)
    {
    case error.PERMISSION_DENIED:
      x.innerHTML="User denied the request for Geolocation."
      break;
    case error.POSITION_UNAVAILABLE:
      x.innerHTML="Location information is unavailable."
      break;
    case error.TIMEOUT:
      x.innerHTML="The request to get user location timed out."
      break;
    case error.UNKNOWN_ERROR:
      x.innerHTML="An unknown error occurred."
      break;
    }
  }
      

親自試一試

錯誤代碼：

• Permission denied - 使用者不允許地理定位
• Position unavailable - 無法擷取目前位置
• Timeout - 操作逾時

在地圖中顯示結果

如需在地圖中顯示結果，您需要通路可使用經緯度的地圖服務，比如谷歌地圖或百度地圖：

執行個體

function showPosition(position)
{
var latlon=position.coords.latitude+","+position.coords.longitude;

var img_url="http://maps.googleapis.com/maps/api/staticmap?center="
+latlon+"&zoom=14&size=400x300&sensor=false";

document.getElementById("mapholder").innerHTML="<img src='"+img_url+"' />";
}
      

親自試一試

在上例中，我們使用傳回的經緯度資料在谷歌地圖中顯示位置（使用靜态圖像）。

谷歌地圖腳本

上面的連結向您示範如何使用腳本來顯示帶有标記、縮放和拖曳選項的互動式地圖。

給定位置的資訊

本頁示範的是如何在地圖上顯示使用者的位置。不過，地理定位對于給定位置的資訊同樣很有用處。

案例：

• 更新本地資訊
• 顯示使用者周圍的興趣點
• 互動式車載導航系統 (GPS)

getCurrentPosition() 方法 - 傳回資料

若成功，則 getCurrentPosition() 方法傳回對象。始終會傳回 latitude、longitude 以及 accuracy 屬性。如果可用，則會傳回其他下面的屬性。

屬性	描述
coords.latitude	十進制數的緯度
coords.longitude	十進制數的經度
coords.accuracy	位置精度
coords.altitude	海拔，海平面以上以米計
coords.altitudeAccuracy	位置的海拔精度
coords.heading	方向，從正北開始以度計
coords.speed	速度，以米/每秒計
timestamp	響應的日期/時間

Geolocation 對象 - 其他有趣的方法

watchPosition() - 傳回使用者的目前位置，并繼續傳回使用者移動時的更新位置（就像汽車上的 GPS）。

clearWatch() - 停止 watchPosition() 方法

下面的例子展示 watchPosition() 方法。您需要一台精确的 GPS 裝置來測試該例（比如 iPhone）：

執行個體

<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.         watchPosition(showPosition)                ;
    }
  else{x.innerHTML="Geolocation is not supported by this browser.";}
  }
function showPosition(position)
  {
  x.innerHTML="Latitude: " + position.coords.latitude +
  "<br />Longitude: " + position.coords.longitude;
  }
</script>
      

親自試一試