HTML5 地理定位



HTML5 Geolocation(地理定位)用於定位使用者的位置。


定位使用者的位置

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

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


瀏覽器支援

Internet Explorer

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

注意: Geolocation(地理定位)對於擁有GPS 的設備,例如iPhone,地理定位更加精確。


HTML5 - 使用地理定位

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

下例是一個簡單的地理定位實例,可傳回使用者位置的經度和緯度:

實例

<!DOCTYPE html>
<html>
<head> 
<meta charset="utf-8"> 
<title>php中文网(php.cn)</title> 
</head>
<body>
<p id="demo">点击按钮获取您当前坐标(可能需要比较长的时间获取):</p>
<button onclick="getLocation()">点我</button>
<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.getCurrentPosition(showPosition);
    }
  else{x.innerHTML="该浏览器不支持获取地理位置。";}
  }
function showPosition(position)
  {
  x.innerHTML="纬度: " + position.coords.latitude + 
  "<br>经度: " + position.coords.longitude;	
  }
</script>
</body>
</html>

執行實例»

點擊"運行實例" 按鈕查看線上實例

實例解析:

  • 偵測是否支援地理定位

  • 如果支持,則執行getCurrentPosition() 方法。如果不支持,則向使用者顯示一段訊息。

  • 如果getCurrentPosition()運作成功,則向參數showPosition中規定的函數傳回coordinates物件

  • ##showPosition() 函數取得並顯示經度和緯度

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


處理錯誤和拒絕

##getCurrentPosition() 方法的第二個參數用於處理錯誤。它規定當取得使用者位置失敗時執行的函數:

實例

<!DOCTYPE html>
<html>
<head> 
<meta charset="utf-8"> 
<title>php中文网(php.cn)</title> 
</head>
<body>
<p id="demo">点击按钮获取您当前坐标(可能需要比较长的时间获取):</p>
<button onclick="getLocation()">点我</button>
<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.getCurrentPosition(showPosition,showError);
    }
  else{x.innerHTML="Geolocation is not supported by this browser.";}
  }
function showPosition(position)
  {
  x.innerHTML="纬度: " + position.coords.latitude + 
  "<br>经度: " + position.coords.longitude;	
  }
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;
    }
  }
</script>
</body>
</html>

執行實例»
點擊"運行實例" 按鈕查看線上實例

錯誤代碼:

    #Permission denied - 使用者不允許地理定位
  • Position unavailable - 無法取得目前位置
  • Timeout - 操作逾時
在地圖中顯示結果

#如需要在地圖中顯示結果,您需要存取可使用經緯度的地圖服務,例如Google地圖或百度地圖:

實例

<!DOCTYPE html>
<html>
<head> 
<meta charset="utf-8"> 
<title>php中文网(php.cn)</title> 
</head>
<body>
<p id="demo">点击按钮获取您当前坐标(可能需要比较长的时间获取):</p>
<button onclick="getLocation()">点我</button>
<div id="mapholder"></div>
<script>
var x=document.getElementById("demo");
function getLocation()
  {
  if (navigator.geolocation)
    {
    navigator.geolocation.getCurrentPosition(showPosition,showError);
    }
  else{x.innerHTML="该浏览器不支持获取地理位置。";}
  }

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+"'>";
  }

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;
    }
  }
</script>
</body>
</html>

運行實例»
點擊"運行實例" 按鈕查看線上實例

在上例中,我們使用傳回的經緯度資料在Google地圖中顯示位置(使用靜態影像)。

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


給定位置的資訊

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

實例:

  • 更新本地資訊

  • #顯示使用者周圍的興趣點

  • #互動式車載導航系統(GPS)


getCurrentPosition() 方法- 傳回資料

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

##十進制數的緯度coords.longitude十進位數的經度coords.accuracycoords.altitudecoords.altitudeAccuracycoords.headingcoords.speed
屬性描述
#coords.latitude
##位置精確度
海拔,海平面以上以公尺計
位置的海拔精度
方向,從正北方開始以度計


# #速度,以米/每秒計

timestamp

回應的日期/時間

下面的範例展示 watchPosition() 方法。您需要一台精確的GPS 裝置來測試該範例(例如iPhone):
######實例#######
<!DOCTYPE html>
<html>
<head> 
<meta charset="utf-8"> 
<title>php中文网(php.cn)</title> 
</head>
<body>
<p id="demo">点击按钮获取您当前坐标(可能需要比较长的时间获取):</p>
<button onclick="getLocation()">点我</button>
<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>
</body>
</html>
########執行實例»#### ##點擊"運行實例" 按鈕查看線上實例#########