借助 Geolocation API，您可以在征得用户同意的情况下发现用户的位置。
Geolocation API 使您能够在征得用户同意的情况下发现用户的位置。可在某些情况下使用此功能，比如指引用户到达目的地以及给用户创建的内容加上地理标记（例如标记照片的拍摄地点）。
Geolocation API 还可让您查看用户的位置并密切关注用户的动向，这一切始终须经用户同意（且仅在页面打开时）。这会令人想到许多值得关注的用例，例如与后端系统集成，当用户在附近时为订单做好收款准备。
使用 Geolocation API 时有许多需要注意的事项，本指南将指引您了解常见的用例和解决方案。
摘要
- 在对用户有利时使用地理定位。
- 通过请求权限来明确响应用户手势。
- 使用功能检测以防用户的浏览器不支持地理定位。
- 不要只是学习如何实现地理定位；还要学习地理定位的最佳使用方式。
- 测试网站的地理定位功能。
何时使用地理定位
- 查找用户最接近哪个具体的物理位置，以定制用户体验。
- 根据用户的位置定制信息（例如新闻）。
- 在地图上显示用户的位置。
- 给应用内创建的数据标记用户的位置（即给照片标记地理位置）。
以负责任的方式请求权限
最近的用户研究表明，用户不信任在网页加载时就提示用户提供其位置的网站。那么，最佳做法是什么呢？
假定用户不将其位置提供给您
许多用户不想将其位置信息提供给您，因此您需要采用防御性的开发方式。
- 处理 Geolocation API 产生的所有错误，以便您的网站能够适应这种情况。
- 清晰明确地表达出您为什么需要位置信息。
- 根据需要使用后备解决方案。
在需要地理定位时使用备用方法
我们建议网站或应用不要求获取用户的当前位置。但如果网站或应用的确需要用户的当前位置信息，可通过第三方解决方案来获得用户当前位置的最佳猜测结果。
这些解决方法通常是查看用户的 IP 地址并将其对应到在 RIPE 数据库注册的物理地址。这些位置通常不太准确，一般提供的是离用户最近的电信枢纽中心或移动电话基站的位置。在许多情况下，这些结果甚至可能达不到，尤其是当用户使用 VPN 或某些其他代理服务时。
始终在用户手势操作时请求获取位置信息
确保用户了解您为何需要其位置，以及这对他们有什么好处。在网站加载首页时立即请求提供位置会导致用户体验不佳。
相反，应向用户提供明确的操作请求或指示，说明某项操作需要获取其位置。这样，用户就可以更轻松地将系统访问权限提示与刚刚发起的操作相关联。
明确指出某项操作将请求其位置信息
Google Ads 团队的一项研究表明，当用户被要求预订波士顿的酒店房间，参加即将在某个酒店网站上举行的会议时，用户点按首页上的“查找并预订”号召性用语后，系统立即提示他们分享自己的 GPS 位置信息。
在某些情况下，用户会觉得失望，因为他们不明白为何在他们想预订波士顿的客房时，显示的却是一些旧金山的酒店。
更好的体验是确保用户了解您为何要求他们提供位置信息。加入一个常见于各种设备上的熟知记号，例如测距仪图标，或者提供意思明确的操作按钮，例如“Find Near Me”。
温和地请求用户授权访问其位置
您无权获取用户所执行操作的任何信息。您可以确切知道用户何时不允许获取其位置，但您不知道他们何时授予您获取权限；您只有在出现结果时才知道获得了信息获取权限。
如果您需要用户完成操作，最好“取悦”他们，让其心甘情愿地完成操作。
我们建议采用以下做法：
- 设置一个在短时间后触发的计时器；5 秒是一个不错的值。
- 如果收到错误消息，则向用户显示消息。
- 如果收到积极回应，请停用计时器并处理结果。
- 如果在超时之后还没有收到积极回应，则向用户显示通知。
- 如果稍后有回应并且通知仍在显示，则从屏幕上移除通知。
button.onclick = function () {
var startPos;
var nudge = document.getElementById('nudge');
var showNudgeBanner = function () {
nudge.style.display = 'block';
};
var hideNudgeBanner = function () {
nudge.style.display = 'none';
};
var nudgeTimeoutId = setTimeout(showNudgeBanner, 5000);
var geoSuccess = function (position) {
hideNudgeBanner();
// We have the location, don't display banner
clearTimeout(nudgeTimeoutId);
// Do magic with location
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
var geoError = function (error) {
switch (error.code) {
case error.TIMEOUT:
// The user didn't accept the callout
showNudgeBanner();
break;
}
};
navigator.geolocation.getCurrentPosition(geoSuccess, geoError);
};
浏览器支持
现在，大部分浏览器均支持 Geolocation API，但最好在执行任何操作之前始终检查是否支持。
您可以通过测试是否存在 geolocation 对象，轻松检查兼容性：
// check for Geolocation support
if (navigator.geolocation) {
console.log('Geolocation is supported!');
} else {
console.log('Geolocation is not supported for this Browser/OS.');
}
确定用户的当前位置
Geolocation API 提供一种简单的“一次性”方法来获取用户的位置：getCurrentPosition()。调用此方法将以异步方式报告用户的当前位置。
window.onload = function () {
var startPos;
var geoSuccess = function (position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
navigator.geolocation.getCurrentPosition(geoSuccess);
};
如果这是该网域中的应用首次请求权限，浏览器通常会检查用户是否同意。根据浏览器的不同，可能还有始终允许或禁止权限查询的偏好设置，在这种情况下，会绕过确认流程。
根据浏览器所使用的定位设备，位置对象实际上可能不仅包含纬度和经度，还包含许多内容；例如，它可能包含海拔高度或方向。在位置系统实际返回数据之前，您无法分辨它使用了哪些额外信息。
监控用户的位置信息
借助 Geolocation API，您只需单次调用 getCurrentPosition() 即可获取用户的位置（经用户同意）。
如果希望持续监测用户的位置，可以使用 Geolocation API 的 watchPosition() 方法。其运行方式与 getCurrentPosition() 类似，但它会在定位软件出现以下情况时多次触发：
- 更准确地锁定用户。
- 确定用户的位置发生了变化。
var watchId = navigator.geolocation.watchPosition(function (position) {
document.getElementById('currentLat').innerHTML = position.coords.latitude;
document.getElementById('currentLon').innerHTML = position.coords.longitude;
});
何时使用地理定位监测用户位置
- 您希望更准确地锁定用户位置。
- 您的应用需要根据新的位置信息更新界面。
- 在用户进入某个定义区域时，您的应用需要更新业务逻辑。
使用地理定位时的最佳实践
务必清理和节省电量
监测地理定位变化不能是随意操作。虽然操作系统可能会引入平台功能，以便应用钩接到地理位置子系统，但作为 Web 开发者，您无法得知用户设备在监控用户位置信息方面提供哪些支持，并且在监控位置信息时，您需要让设备执行大量额外的处理。
如果不再需要追踪用户位置，请调用 clearWatch 来关闭地理定位系统。
妥善处理错误
遗憾的是，并非所有位置查找均能成功。可能是 GPS 无法定位，或用户突然停用了位置查找。在出现错误时，系统将调用 getCurrentPosition() 的第二个可选参数，以便您可以在回调内通知用户：
window.onload = function () {
var startPos;
var geoSuccess = function (position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
var geoError = function (error) {
console.log('Error occurred. Error code: ' + error.code);
// error.code can be:
// 0: unknown error
// 1: permission denied
// 2: position unavailable (error response from location provider)
// 3: timed out
};
navigator.geolocation.getCurrentPosition(geoSuccess, geoError);
};
减少启动地理定位硬件的必要性
在许多用例中，您不需要用户的最新位置信息，只需粗略的估算值即可。
使用 maximumAge 可选属性来告知浏览器使用最近获取的地理定位结果。如果用户之前请求过数据，这不仅能更快返回数据，还能防止浏览器启动其地理定位硬件接口，例如 WiFi 三角测量或 GPS。
window.onload = function () {
var startPos;
var geoOptions = {
maximumAge: 5 * 60 * 1000,
};
var geoSuccess = function (position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
var geoError = function (error) {
console.log('Error occurred. Error code: ' + error.code);
// error.code can be:
// 0: unknown error
// 1: permission denied
// 2: position unavailable (error response from location provider)
// 3: timed out
};
navigator.geolocation.getCurrentPosition(geoSuccess, geoError, geoOptions);
};
请勿让用户持续等待，设置一个超时值
除非设置超时，否则您对当前位置的请求可能永远不会返回。
window.onload = function () {
var startPos;
var geoOptions = {
timeout: 10 * 1000,
};
var geoSuccess = function (position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
var geoError = function (error) {
console.log('Error occurred. Error code: ' + error.code);
// error.code can be:
// 0: unknown error
// 1: permission denied
// 2: position unavailable (error response from location provider)
// 3: timed out
};
navigator.geolocation.getCurrentPosition(geoSuccess, geoError, geoOptions);
};
优先采用粗略位置，而不是精确位置
如果要查找离用户最近的商店，不太可能需要 1 米的精度。此 API 旨在提供一个尽快返回的粗略位置。
如果真的需要高度精确，可以用 enableHighAccuracy 选项替换默认设置。谨慎使用该选项：解析速度会下降，并且电池耗电会增加。
window.onload = function () {
var startPos;
var geoOptions = {
enableHighAccuracy: true,
};
var geoSuccess = function (position) {
startPos = position;
document.getElementById('startLat').innerHTML = startPos.coords.latitude;
document.getElementById('startLon').innerHTML = startPos.coords.longitude;
};
var geoError = function (error) {
console.log('Error occurred. Error code: ' + error.code);
// error.code can be:
// 0: unknown error
// 1: permission denied
// 2: position unavailable (error response from location provider)
// 3: timed out
};
navigator.geolocation.getCurrentPosition(geoSuccess, geoError, geoOptions);
};
使用 Chrome 开发者工具模拟地理定位
地理定位设置完毕后，您需要：
- 测试您的应用在不同地理定位下的运行情况。
- 验证在地理定位不可用时，您的应用是否可适当降级。
这两项工作均可通过 Chrome DevTools 完成。
- 打开 Chrome 开发者工具。
- 按 Esc 键打开控制台抽屉。
- 打开控制台抽屉菜单
- 点击传感器选项以显示“传感器”标签页。
在这里，您可以将位置信息替换为预设的主要城市、输入自定义位置，或者通过将替换项设置为位置不可用来停用地理定位。