HTML 地理定位(Geolocation)教程

简介

HTML5 的 Geolocation API 允许网页应用获取用户的地理位置信息。这个功能可用于提供基于位置的服务，如导航、本地搜索、天气预报等。本教程将详细介绍如何在网页中实现地理定位功能。

工作原理

浏览器可以通过多种方式确定用户位置：

GPS（全球定位系统）
蜂窝网络三角测量
WiFi 定位
IP 地址地理位置查询

定位精度取决于使用的定位方法。例如，GPS 通常提供最精确的位置信息，而 IP 地址定位则相对不太精确。

Geolocation API 基础

HTML5 的 Geolocation API 通过 navigator.geolocation 对象提供。在使用之前，应先检查浏览器是否支持此功能：

if ("geolocation" in navigator) {// 浏览器支持地理定位console.log("地理定位可用");
} else {// 浏览器不支持地理定位console.log("地理定位不可用");
}

获取用户位置

获取当前位置

使用 getCurrentPosition() 方法获取用户的当前位置：

navigator.geolocation.getCurrentPosition(// 成功回调函数function(position) {// 获取位置成功console.log("纬度：" + position.coords.latitude);console.log("经度：" + position.coords.longitude);},// 错误回调函数function(error) {// 获取位置失败console.error("获取位置失败：", error.message);}
);

Position 对象属性

成功获取位置后，position 对象包含以下重要属性：

属性	描述
`coords.latitude`	纬度（十进制度数）
`coords.longitude`	经度（十进制度数）
`coords.accuracy`	位置精度（米）
`coords.altitude`	海拔高度（米，可能为null）
`coords.altitudeAccuracy`	海拔精度（米，可能为null）
`coords.heading`	方向（度数，0-359，可能为null）
`coords.speed`	速度（米/秒，可能为null）
`timestamp`	获取位置的时间戳

处理错误

地理定位可能因多种原因失败。错误回调函数接收 PositionError 对象，包含错误信息：

navigator.geolocation.getCurrentPosition(successCallback,function(error) {switch(error.code) {case error.PERMISSION_DENIED:console.error("用户拒绝了地理定位请求");break;case error.POSITION_UNAVAILABLE:console.error("位置信息不可用");break;case error.TIMEOUT:console.error("获取用户位置超时");break;case error.UNKNOWN_ERROR:console.error("未知错误");break;}}
);

监控位置变化

若要持续跟踪用户位置变化，可以使用 watchPosition() 方法：

// 开始监控位置
var watchId = navigator.geolocation.watchPosition(function(position) {// 位置更新时的回调console.log("新位置 - 纬度：" + position.coords.latitude + ", 经度：" + position.coords.longitude);},function(error) {console.error("监控位置出错：", error.message);}
);// 需要时停止监控
function stopWatching() {navigator.geolocation.clearWatch(watchId);console.log("停止位置监控");
}

位置选项配置

getCurrentPosition() 和 watchPosition() 方法都接受可选的第三个参数，用于配置定位选项：

var options = {enableHighAccuracy: true,  // 尝试获取最高精度的位置timeout: 5000,             // 超时时间（毫秒）maximumAge: 0              // 不使用缓存位置
};navigator.geolocation.getCurrentPosition(successCallback,errorCallback,options
);

选项说明

选项	描述	默认值
`enableHighAccuracy`	是否尝试获取高精度位置（可能会更耗电）	`false`
`timeout`	获取位置的最大时间（毫秒）	无限
`maximumAge`	可以使用的缓存位置的最大年龄（毫秒）	0

实际应用示例

完整示例：在地图上显示用户位置

下面是一个完整的示例，展示如何获取用户位置并在页面上显示：

<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>地理定位示例</title><style>#map {height: 400px;width: 100%;margin-top: 20px;}#status {padding: 10px;background-color: #f0f0f0;border-radius: 5px;}button {padding: 8px 15px;margin: 10px 0;cursor: pointer;}</style>
</head>
<body><h1>我的位置</h1><div id="status">等待获取位置...</div><button id="getLocation">获取我的位置</button><div id="coordinates"></div><div id="map"></div><script>document.getElementById('getLocation').addEventListener('click', function() {var status = document.getElementById('status');var coordsDiv = document.getElementById('coordinates');if (!navigator.geolocation) {status.textContent = '您的浏览器不支持地理定位';return;}status.textContent = '正在获取位置...';navigator.geolocation.getCurrentPosition(function(position) {var latitude = position.coords.latitude;var longitude = position.coords.longitude;status.textContent = '位置获取成功！';coordsDiv.innerHTML = '<p><strong>纬度：</strong> ' + latitude + '</p>' +'<p><strong>经度：</strong> ' + longitude + '</p>' +'<p><strong>精度：</strong> ' + position.coords.accuracy + ' 米</p>';// 这里可以添加地图显示代码，例如使用 Google Maps API 或 Leaflet// 简单示例（需要引入相应的地图 API）showOnMap(latitude, longitude);}, function(error) {switch(error.code) {case error.PERMISSION_DENIED:status.textContent = '用户拒绝了地理定位请求';break;case error.POSITION_UNAVAILABLE:status.textContent = '位置信息不可用';break;case error.TIMEOUT:status.textContent = '获取用户位置超时';break;case error.UNKNOWN_ERROR:status.textContent = '发生未知错误';break;}}, {enableHighAccuracy: true,timeout: 10000,maximumAge: 0});});// 此函数需要地图 API 支持function showOnMap(lat, lng) {// 以下是使用 Leaflet 的示例（需要引入 Leaflet JS 和 CSS）// 实际使用时需要在 head 中引入相应的库/*var map = L.map('map').setView([lat, lng], 13);L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {maxZoom: 19,attribution: '© OpenStreetMap contributors'}).addTo(map);L.marker([lat, lng]).addTo(map).bindPopup('您在这里').openPopup();*/// 占位符，提示用户需要地图 APIdocument.getElementById('map').innerHTML = '需要引入地图 API 才能显示位置。';}</script>
</body>
</html>