iOS原生App中无法直接调用HTML5地图API，需通过WKWebView正确配置权限、协议及交互策略：启用地理位置授权、使用HTTP(S)/localhost协议加载页面、禁用linkPreview、处理假坐标与点击延迟等。
iOS 原生 App 中无法直接“调用 HTML5 地图 API”——HTML5 的 navigator.geolocation 是运行在 WebView 里的 JS API，它本身不提供地图渲染能力，也不具备原生级定位精度或后台定位权限。所谓“调用”，实际是让 WebView 正确加载并执行含定位逻辑的 HTML 页面，同时确保 iOS 系统允许该页面获取位置。
WebView 必须启用地理位置权限且用户已授权
WKWebView 默认禁用地理位置 API。即使网页写了 navigator.geolocation.getCurrentPosition()，也会直接失败（错误码 PERMISSION_DENIED 或静默无响应）。
- 在
Info.plist中必须添加键NSLocationWhenInUseUsageDescription（字符串值为向用户说明用途，如“用于显示您附近的位置”） - 创建 WKWebView 时需配置
WKWebViewConfiguration：configuration.preferences.javaScriptCanOpenWindowsAutomatically = true，且configuration.allowsInlineMediaPlayback = true（部分地图 JS 库依赖） - 首次调用定位前，需在原生层主动触发一次
CLLocationManager.requestWhenInUseAuthorization()；否则 WebView 内的 JS 调用会卡住或报错 - iOS 13+ 中，若网页通过
file://协议加载（如本地 HTML 文件），navigator.geolocation会被 Safari 引擎完全禁用——必须通过http://、https://或localhost（如用HTTPServer本地起服务）方式加载
百度/高德/腾讯地图 JS SDK 在 iOS WebView 中的兼容要点
这些地图 SDK 本质是封装了 navigator.geolocation 并叠加 WebGL/Canvas 渲染，但它们对 iOS WebView 的限制更敏感。
- 百度地图 JS API v3.0+ 要求页面协议为 HTTPS（
http://localhost可例外），且需显式设置enableHighAccuracy: true才可能触发原生 GPS（否则仅用 WiFi/IP 定位，误差常超 500 米） - 高德 JS API 需在初始化
AMap.Map时传入features: ['geolocation']，否则其内部AMap.Geolocation实例不会自动申请权限 - 腾讯地图 JS SDK 对 WKWebView 的 User-Agent 识别较弱，若检测到非 Safari/Chrome，可能降级为 IP 定位；可在原生层设置
configuration.applicationNameForUserAgent = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1" - 所有 SDK 的定位成功回调中，务必检查返回坐标是否为
{longitude: 0, latitude: 0}——这是 iOS 拒绝授权或定位超时的典型假数据，不是真实坐标
标注点（Marker）点击事件在 iOS 上经常失效的原因
WebView 中地图上的 JS 标注点（如 new AMap.Marker({position: [lng, lat]})）点击无响应，大概率不是 JS 写错了，而是 iOS 层级的交互拦截。
立即学习“前端免费学习笔记（深入）”；
- WKWebView 默认开启
allowsLinkPreview = true，会导致长按 Marker 触发系统预览，吞掉 click/tap 事件；必须设为false - 若标注 DOM 元素含
cursor: pointer或绑定ontouchstart，但未在 CSS 中加-webkit-tap-highlight-color: transparent，iOS 会延迟约 300ms 触发 click，造成“点不动”错觉 - 使用
map.on('click', ...)捕获地图点击时，需确认事件对象e.lnglat是否有效；iOS WebView 下某些 SDK 版本在缩放动画未结束时，e.lnglat可能为null - 避免在 Marker 的
content中写内联onclick="..."—— WKWebView 对这种写法的 JS 执行上下文支持不稳定，改用marker.on('click', handler)绑定
真正麻烦的不是怎么写 JS，而是 iOS 每次系统更新都可能微调 WKWebView 对地理位置 API 的沙盒策略。比如 iOS 16.4 开始，file:// 页面即使有权限声明，navigator.geolocation 也彻底不可用；而 iOS 17.2 又悄悄放宽了 localhost 的证书校验。这类细节不会写在文档里，只能靠真机实测。
