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

定位使用者的位置

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

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

瀏覽器支援

Internet Explorer 9+, Firefox, Chrome, Safari 和 Opera 支援Geolocation（地理定位）.

注意: Geolocation（地理定位）對於擁有 GPS 的裝置，比如 iPhone，地理定位更加精確。

HTML5 - 使用地理定位

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

下例是一個簡單的地理定位例項，可返回使用者位置的經度和緯度:

例項

<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.getCurrentPosition(showPosition);
    }
  else{x.innerHTML="該瀏覽器不支援獲取地理位置。";}
  }
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="使用者拒絕對獲取地理位置的請求。"
      break;
    case error.POSITION_UNAVAILABLE:
      x.innerHTML="位置資訊是不可用的。"
      break;
    case error.TIMEOUT:
      x.innerHTML="請求使用者地理位置超時。"
      break;
    case error.UNKNOWN_ERROR:
      x.innerHTML="未知錯誤。"
      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+"'>";
}

嘗試一下 »

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

Google地圖指令碼 上面的連結向您演示如何使用指令碼來顯示帶有標記、縮放和拖曳選項的互動式地圖。

給定位置的資訊

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

例項:

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

getCurrentPosition() 方法 - 返回資料

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

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="該瀏覽器不支援獲取地理位置。";}
  }
function showPosition(position)
  {
  x.innerHTML="緯度: " + position.coords.latitude + 
  "<br>經度: " + position.coords.longitude; 
  }
</script>