HTML5 地理位置(Geolocation)


HTML Geolocation API用于定位用户的位置.(用浏览器和手机打开网页来看看效果)


定位用户的位置

HTML5 Geolocation API 用于获得用户的地理位置.

鉴于该特性可能侵犯用户的隐私,除非用户同意,否则用户位置信息是不可用的.

注意: Geolocation(地理定位)对于拥有 GPS 的设备,比如 iPhone,地理定位更加精确.


浏览器支持

表中的数字指定了完全支持Geolocation的第一个浏览器版本.

API
Geolocation 5.0 - 49.0 (http)
50.0 (https)
9.0 3.5 5.0 16.0

注意:从Chrome 50开始,Geolocation API仅适用于HTTPS等安全上下文.如果您的站点托管在非安全源(例如HTTP)上,则获取用户位置的请求将不再起作用.


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 = "纬度: " + position.coords.latitude +
    "<br>经度: " + position.coords.longitude;
}
</script>
运行 »

实例说明:

  • 检测是否支持地理定位
  • 如果支持,则运行getCurrentPosition()方法.如果不支持,则向用户显示消息
  • 如果getCurrentPosition()方法成功,则向参数showPosition中规定的函数返回一个coordinates对象
  • showPosition()函数输出纬度和经度

上面的示例是一个非常基本的Geolocation脚本,没有错误处理.



处理错误和拒绝

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;
    }
}
运行 »

在地图中显示结果

要在地图中显示结果,您需要访问地图服务,例如Google地图.

在下面的示例中,返回的纬度和经度用于显示Google地图中的位置(使用静态图像):

实例

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

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

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

给定位置的信息

此页面演示了如何在地图上显示用户的位置.

地理定位对于特定于位置的信息也非常有用,例如:

  • 最新的本地信息
  • 显示用户附近的兴趣点
  • 交互式车载导航系统 (GPS)

getCurrentPosition()方法 - 返回数据

getCurrentPosition()方法在成功时返回一个对象.始终会返回 latitude、longitude 以及 accuracy 属性.如果可用,则会返回其他下面的属性:

属性(Property) 返回描述(Returns)
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 = "该浏览器不支持获取地理位置.";
    }
}
function showPosition(position) {
    x.innerHTML = "纬度: " + position.coords.latitude +
    "<br>经度: " + position.coords.longitude;
}
</script>
运行 »