BrowserScan iconBrowserScan
简体中文
English简体中文
BrowserScan/位置api/地理定位/ip查询/隐私保护

位置API详解：地理定位、IP查询与隐私

AAnonymous··10 分钟阅读

位置API详解：地理定位、IP查询与隐私

位置API让软件能够回答一个看似简单的问题：这个用户在哪里？答案可能来自浏览器向设备请求GPS坐标，来自服务器将IP地址匹配到城市，或者来自两者的结合。每种方法在精度、成本和隐私方面都有不同的权衡，选错方法往往是bug和用户投诉的常见来源。

本指南解释了位置API的两大主要类别，展示了实用的代码和请求示例，比较了精度和隐私，并介绍了如何验证你自己的连接实际会暴露哪些信息。

位置API实际做什么

位置API详解：地理定位、IP查询与隐私 - 位置API实际做什么

位置API详解：地理定位、IP查询与隐私 - 位置API实际做什么.

位置API详解：地理定位、IP查询与隐私 - 位置API实际做什么。

位置API向应用程序返回结构化的位置数据。这些数据通常分为两类：

  • 设备级坐标——从GPS、Wi-Fi定位或蜂窝基站获得的纬度和经度，带有以米为单位的精度半径。
  • 网络级估算——从IP地址推导出的国家、地区、城市、邮政编码、时区和ISP，精度以公里或更大单位衡量。

有些平台会将两者结合使用。天气应用可能会使用IP地理定位来确定默认城市，然后仅在用户点击“使用我的位置”时请求精确的设备坐标。这种分层方法可以让首屏加载更快，并避免不必要的权限提示。

浏览器地理定位：Geolocation API

位置API详解：地理定位、IP查询与隐私 - 浏览器地理定位：Geolocation API

位置API详解：地理定位、IP查询与隐私 - 浏览器地理定位：Geolocation API.

位置API详解：地理定位、IP查询与隐私 - 浏览器地理定位：Geolocation API。

Geolocation API 是通过 navigator.geolocation 暴露的Web标准。它在现代浏览器中广泛可用，并且需要安全上下文（HTTPS）。

核心方法

  • getCurrentPosition() — 一次性获取设备的当前位置。
  • watchPosition() — 注册一个处理程序，在位置变化时触发。
  • clearWatch() — 停止之前注册的监听。

这两个获取方法都接受成功回调、可选的错误回调和选项对象。

一个最小示例

navigator.geolocation.getCurrentPosition(
  (position) => {
    const { latitude, longitude, accuracy } = position.coords;
    console.log(latitude, longitude, `±${accuracy} m`);
  },
  (error) => {
    console.error(error.code, error.message);
  },
  { enableHighAccuracy: true, timeout: 10000, maximumAge: 0 }
);

各选项的含义

选项 作用
enableHighAccuracy 请求可用的最精确来源，通常是GPS。速度更慢，也更耗电。
timeout 在错误回调触发之前等待结果的最长时间。
maximumAge 接受不早于给定毫秒数的缓存位置。

权限和安全规则

在返回坐标之前，用户必须明确授予权限。浏览器在首次调用任一方法时会显示提示，权限的有效期因浏览器而异——可能是基于会话、基于时间或持久性的。

还有两个额外限制对开发者很重要：

  • 该功能仅在安全上下文中可用，因此HTTPS是必需的。
  • 可以通过 geolocation Permissions Policy 指令限制访问。默认允许列表是 self，这会将访问限制在同源的嵌套框架中。第三方嵌入需要显式的 Permissions-Policy 头，以及iframe上的 allow="geolocation" 属性。

你可以在提示之前通过 Permissions API 检查当前权限状态，这样可以避免向已经拒绝访问的用户显示令人困惑的提示。

已知限制

基于Wi-Fi的定位通常由Google提供，因此原生 Geolocation API 在某些地区可能不可用或性能下降，包括中国，当地通常会使用本地提供商。没有GPS的桌面设备通常会回退到Wi-Fi或基于IP的估算，其精度可能远低于精度值所暗示的水平。

IP地理定位API：无需权限提示的位置信息

位置API详解：地理定位、IP查询与隐私 - IP地理定位API：无需权限提示的位置信息

位置API详解：地理定位、IP查询与隐私 - IP地理定位API：无需权限提示的位置信息.

位置API详解：地理定位、IP查询与隐私 - IP地理定位API：无需权限提示的位置信息。

IP地理定位API在服务器端工作。你发送一个IP地址，然后收到描述该网络注册位置的JSON、XML或CSV响应。不涉及用户提示，这使得这些API可用于分析、欺诈检查、内容本地化和默认设置。

一个典型的请求如下所示：

GET https://ip-api.com/json/24.48.0.1

一个典型的响应包含如下字段：

{
  "query": "24.48.0.1",
  "status": "success",
  "country": "Canada",
  "countryCode": "CA",
  "regionName": "Quebec",
  "city": "Montreal",
  "lat": 45.5019,
  "lon": -73.5674,
  "timezone": "America/Toronto",
  "isp": "Example Telecom",
  "org": "Example Org",
  "as": "AS12345",
  "proxy": false,
  "hosting": false
}

像 proxy、hosting 和 mobile 这样的字段对滥用检测特别有用，因为数据中心和VPN范围的行为与住宅连接不同。IP-API 是一个长期运行的免费选项；其免费端点限制为每个IP地址每分钟45个HTTP请求，并且未获得商业使用许可，因此生产系统通常需要付费层级。

精度预期

IP地理定位不是精确的定位系统。现实预期如下：

  • 国家——通常可靠。
  • 地区和城市——对住宅ISP通常正确，对移动运营商和企业网络则经常错误。
  • 街道地址——IP数据无法提供，尽管一些营销页面暗示可以。

移动流量是最大的错误来源，因为运营商级NAT可能会将数千名订阅者通过一个注册在遥远网关城市的单一IP进行路由。

Geolocation API 与 IP地理定位API对比

位置API详解：地理定位、IP查询与隐私 - Geolocation API 与 IP地理定位API对比

位置API详解：地理定位、IP查询与隐私 - Geolocation API 与 IP地理定位API对比.

位置API详解：地理定位、IP查询与隐私 - Geolocation API 与 IP地理定位API对比。

维度 浏览器 Geolocation API IP地理定位API
数据来源 GPS、Wi-Fi、蜂窝基站 IP地址注册和路由
典型精度 米级 最好为城市级，通常为地区级
用户同意 需要提示 无
运行位置 客户端 服务器
无JS是否可用 否 是
最适合 地图、导航、签到 本地化、欺诈检查、分析

一个实用规则：当用户收益依赖于精确位置时，使用浏览器API；当你需要一个合理的默认值而不想打扰任何人时，使用IP地理定位。

不应跳过的隐私考虑

位置数据属于最敏感的个人数据类别之一。无论你选择哪种API，都有一些原则适用：

  1. 仅在需要时询问。 在页面加载时请求精确坐标会让用户习惯于永久拒绝提示。
  2. 解释好处。 在提示前提供一行简短的上下文说明可以提高授予率并减少支持工单。
  3. 最小化保留。 以仍能满足功能需求的最低精度存储坐标，并在目的结束后删除它们。
  4. 尊重拒绝。 始终提供手动回退方案，例如城市选择器。
  5. 将IP数据视为个人数据。 在许多隐私制度下，与用户关联的IP地址属于可识别信息。

如何验证你的连接会暴露哪些信息

如果你使用VPN、代理或企业网关，值得确认你的流量实际暴露了哪些位置信号。通常有两处会泄露：

  • WebRTC 即使在VPN激活时也可能暴露真实IP地址，这会破坏任何基于IP的位置掩蔽。
  • DNS解析 如果查询绕过隧道，可能会暴露真实网络路径。

BrowserScan 正是针对这种场景提供免费的基于浏览器的诊断，包括 WebRTC 和 DNS 泄漏测试、带地理定位和代理检测的IP地址查询，以及浏览器指纹分析。在配置隧道后运行这些检查，可以显示你的应用程序接收到的位置数据是否与预期一致。对于大规模管理隧道的团队，VPN自动化：脚本、云设置和泄漏测试 中的工作流程介绍了如何让验证持续进行，而不是一次性完成。

如果你的工作更广泛地涉及空间数据——将位置数据流与业务或运营数据集结合——位置智能 中的概念解释了位置API如何融入更大的分析管道。如果你正在比较IP数据提供商，这篇 IPWHOIS.io 评测 分解了一个流行免费选项的端点、速率限制和定价层级。

选择正确的方法

使用这个简短的决策路径：

  1. 没有精确坐标该功能会失败吗？ 如果是，使用浏览器 Geolocation API，并提供清晰的权限提示。
  2. 你需要合理的默认值或服务器端逻辑吗？ 使用IP地理定位API。
  3. 两者都需要吗？ 从IP地理定位开始，然后在用户明确操作后升级到设备坐标。
  4. 目标是欺诈或滥用检测吗？ 将IP地理定位与代理、托管和ASN信号结合使用，而不是仅依赖城市。
  5. 隐私是硬性要求吗？ 优先选择粗略数据、短保留期和透明披露。

相关阅读

来源与进一步阅读

常见问题

Geolocation API 可以免费使用吗？

可以。浏览器 Geolocation API 是一项Web标准，没有许可费用。IP地理定位服务则各不相同：有些提供带速率限制的免费层级，而生产或商业使用通常需要付费计划。

为什么IP地理定位显示错误的城市？

IP地址是注册给网络运营商的，而不是物理设备。移动运营商、VPN和企业网络通常通过不同城市的网关路由流量，因此注册位置可能远离用户。

网站可以在不询问的情况下获取我的位置吗？

不能通过 Geolocation API——浏览器需要明确许可。但是，服务器可以在没有任何提示的情况下根据你的IP地址估算大致位置，这就是为什么基于IP的位置被认为隐私性较低。

VPN会改变位置API返回的结果吗？

它会改变你的请求来源IP地址，因此IP地理定位通常会报告VPN服务器的位置。它不会改变GPS坐标，而且如果WebRTC或DNS泄漏暴露了你的真实IP，它也帮不上忙。

enableHighAccuracy 有多精确？

它会请求可用的最精确来源，通常是GPS，在户外可以精确到几米。在室内或没有GPS的桌面上，即使设置了该标志，浏览器也可能回退到精度低得多的Wi-Fi定位。

什么是反向地理编码？

反向地理编码将坐标转换为人类可读的地址或地点名称。它是独立于 Geolocation API 本身的服务，通常由地图或地理编码供应商提供。

结论

位置API分为两种明显不同的工具：用于精确、基于同意的坐标的浏览器 Geolocation API，以及用于无需权限的服务器端估算的IP地理定位API。理解每种工具的精度上限可以避免最常见的错误——期望从IP地址获得街道级精度，或者在国家级默认值就足够时提示用户提供GPS。

无论你实现哪一种，都要验证底层网络路径。通过WebRTC或DNS的泄漏可能会悄悄与你应用程序认为拥有的位置数据相矛盾，而快速进行一轮基于浏览器的测试是在用户发现之前捕获这一问题的最快方法。