编辑“︁JavaScript地理位置”︁

= JavaScript地理位置 =

'''JavaScript地理位置'''（Geolocation）是浏览器对象模型（BOM）的一部分，允许网页通过浏览器获取用户的物理位置信息。这一功能广泛应用于地图服务、本地搜索、天气应用等场景。地理位置API基于W3C标准，提供了一种安全且隐私保护的方式来访问用户的位置数据。

== 介绍 ==

地理位置API主要通过<code>navigator.geolocation</code>对象提供访问权限。用户必须明确授权后，网页才能获取其位置信息。API支持以下核心方法：
* <code>getCurrentPosition()</code> - 获取当前位置（单次请求）。
* <code>watchPosition()</code> - 持续监听位置变化（适用于移动设备）。
* <code>clearWatch()</code> - 停止监听。

== 基本用法 ==

以下是一个简单的示例，展示如何使用<code>getCurrentPosition()</code>获取用户当前位置：

<syntaxhighlight lang="javascript">
if ("geolocation" in navigator) {
    navigator.geolocation.getCurrentPosition(
        (position) => {
            console.log("纬度: " + position.coords.latitude);
            console.log("经度: " + position.coords.longitude);
            console.log("精度: " + position.coords.accuracy + " 米");
        },
        (error) => {
            console.error("获取位置失败: " + error.message);
        }
    );
} else {
    console.error("浏览器不支持地理位置API");
}
</syntaxhighlight>

'''输出示例：'''
<pre>
纬度: 37.7749
经度: -122.4194
精度: 25 米
</pre>

=== 参数说明 ===
* <code>successCallback</code> - 成功时调用的函数，接收<code>Position</code>对象。
* <code>errorCallback</code> - 失败时调用的函数，接收<code>PositionError</code>对象。
* <code>options</code>（可选） - 配置项，如超时时间、缓存有效期等。

== 高级用法 ==

=== 监听位置变化 ===
对于移动应用，可以使用<code>watchPosition()</code>持续获取位置更新：

<syntaxhighlight lang="javascript">
const watchId = navigator.geolocation.wPosition(
    (position) => {
        console.log(`新位置: ${position.coords.latitude}, ${position.coords.longitude}`);
    },
    (error) => {
        console.error("监听失败: " + error.message);
    },
    { enableHighAccuracy: true, timeout: 5000 }
);

// 停止监听
// navigator.geolocation.clearWatch(watchId);
</syntaxhighlight>

=== 配置选项 ===
<code>options</code>对象支持以下属性：
* <code>enableHighAccuracy</code> - 是否启用高精度模式（可能增加功耗）。
* <code>timeout</code> - 请求超时时间（毫秒）。
* <code>maximumAge</code> - 允许使用缓存位置的最大时间（毫秒）。

== 错误处理 ==

常见的错误类型（通过<code>error.code</code>标识）：
* <code>PERMISSION_DENIED</code> - 用户拒绝授权。
* <code>POSITION_UNAVAILABLE</code> - 位置信息不可用。
* <code>TIMEOUT</code> - 请求超时。

== 实际应用案例 ==

=== 案例1：显示用户位置地图 ===
以下代码将用户位置显示在Google地图上：

<syntaxhighlight lang="javascript">
function initMap() {
    if ("geolocation" in navigator) {
        navigator.geolocation.getCurrentPosition((position) => {
            const userLocation = {
                lat: position.coords.latitude,
                lng: position.coords.longitude
            };
            const map = new google.maps.Map(document.getElementById("map"), {
                center: userLocation,
                zoom: 15
            });
            new google.maps.Marker({ position: userLocation, map: map });
        });
    }
}
</syntaxhighlight>

=== 案例2：本地天气查询 ===
结合天气API，根据用户位置获取当地天气：

<syntaxhighlight lang="javascript">
navigator.geolocation.getCurrentPosition((position) => {
    fetch(`https://api.weatherapi.com/v1/current.json?key=YOUR_KEY&q=${position.coords.latitude},${position.coords.longitude}`)
        .then(response => response.json())
        .then(data => console.log(data.current.temp_c + "°C"));
});
</syntaxhighlight>

== 隐私与安全 ==

浏览器会强制要求用户授权，且HTTPS协议下地理位置API更可靠。开发者应：
* 明确说明位置数据的用途。
* 提供拒绝选项。
* 仅在必要时请求位置权限。

== 浏览器兼容性 ==

地理位置API支持所有现代浏览器，包括：
* Chrome 5+
* Firefox 3.5+
* Safari 5+
* Edge 12+
* Opera 16+

== 总结 ==

JavaScript地理位置API为Web应用提供了强大的位置感知能力，但需谨慎处理用户隐私。通过合理使用<code>getCurrentPosition()</code>和<code>watchPosition()</code>，开发者可以创建丰富的位置服务应用。

[[Category:编程语言]]
[[Category:JavaScript]]
[[Category:Javascript BOM]]