百度地图Geocoder反解析需确保BD09坐标系、AK白名单匹配、地图实例就绪；GPS/高德坐标须先用convertor.translate()转换；结果需判空并优先使用address字段，addressComponents更稳定；本地调试须配localhost白名单，禁用file://协议。
百度地图 JS API 的 Geocoder 怎么用才不返回空结果
直接调用 Geocoder 反解析（经纬度转地址）失败，大概率是没等地图实例就绪或坐标系不对。百度地图要求输入的经纬度必须是 **BD09 坐标系**，而你手里的 GPS 原始数据（WGS84）或高德/腾讯坐标（GCJ02）直接传进去，getLocation 回调里 result 为空或 status 报错 INVALID_COORDINATE。
- 初始化地图后，再 new
Geocoder，别在initMap()外部提前声明 - 确认坐标来源：GPS 设备、手机
geolocationAPI 返回的是 WGS84，必须先用convertor.translate()转成 BD09 - 反解析请求有并发限制，频繁调用会触发
status: 4（QUOTA_OVER），加防抖或缓存结果
Geocoder.getLocation() 的回调里为什么 result.formatted_address 是 undefined
不是所有坐标都能解析出结构化地址。百度反解析优先返回“能标在地图上的点”，比如野外、海面、未标注道路，result 可能只有 address 字符串字段，formatted_address 和 business 等字段压根不存在。
- 务必用
if (result && result.address)判断，别直接链式取result.formatted_address - 想拿更细粒度信息（省市区、街道、门牌号），检查
result.addressComponents对象，它比formatted_address更稳定 - 某些郊区或新开发区坐标，即使能解析，
level可能是"city"或"district"，不代表有街道级信息
为什么本地开发时 Geocoder 一直报 Illegal Request
错误码 status: 100（ILLEGAL_REQUEST）基本等于 AK 配置错了——不是密钥无效，而是「Referer 白名单」没配对。百度控制台里填的域名必须和当前页面 URL 的 origin 完全一致，包括协议（http vs https）、端口（:3000）、子域名（dev.example.com ≠ example.com）。
- 本地调试用
http://localhost或http://127.0.0.1，控制台白名单必须显式加上这两项，不能只写* - Webpack DevServer 默认启
https？那白名单得填https://localhost，否则哪怕页面开了 HTTPS，API 请求仍被拒 - 用
file://协议打开 HTML 文件？百度 API 直接拒绝，必须走 HTTP(S) 服务
移动端 H5 页面用百度地图反解析要注意什么
手机浏览器里获取的 position.coords 经纬度精度波动大，尤其室内或弱信号时，误差可能超 500 米。直接拿这个坐标去反解析，返回的地址经常是隔壁小区甚至几公里外的商场。
立即学习“前端免费学习笔记（深入）”；
- 检查
position.coords.accuracy，大于 30 米就别急着发请求，提示用户“请到开阔地带重试” - 不要依赖单次定位，用
watchPosition()拿 2–3 次结果，取accuracy最小的那个再解析 - Android WebView 或微信内置浏览器可能屏蔽
geolocation，降级方案：让用户手动点地图选点，再用该点坐标反解析
