逆地理编码：根据经纬度获取地址详解
逆地理编码 API 核心功能与业务价值
百度地图逆地理编码 API 是一项将经纬度坐标（如 38.76623,116.43213）转换为结构化地址、行政区划、周边 POI 与道路信息的 Web 服务，支持国内外坐标解析，可同时返回「不含 POI 的标准地址」与「含 POI 的语义化地址」两种描述形式，并支持多语言行政区划输出，是定位描述、轨迹回放、用户位置展示等场景的核心能力。
接口入参、返回地址与 POI 数据说明
服务概述
服务地址：https://api.map.baidu.com/reverse_geocoding/v3/
请求方式：HTTP GET
输出格式：JSON / XML
核心能力
地址描述双形态
formatted_address：标准结构化地址，不含 POI，如「四川省成都市青羊区人民中路一段」
formatted_address_poi：含 POI 的精细化地址，如「四川省成都市青羊区西御河街道成都市实验小学(人民中路校区)」（需 extensions_poi=1）
sematic_description：AOI 内语义化描述，如「第一郡内,亮晶视光配镜东北258米」
周边信息召回
POI 数据：可按 poi_types 过滤类型（如 酒店|房地产），半径 0–3000 米可调
道路数据：返回名称、距离、方向、坐标
行政区划：国家、省、市、区、街道，海外地区按层级返回
请求参数
必选参数
ak：开发者密钥
location：经纬度，格式 lat,lng，如 38.76623,116.43213
可选参数
extensions_poi：是否返回周边 POI（0/1）
poi_types：POI 类型过滤
radius：POI 召回半径（默认 1000 米，最大 3000 米）
ret_coordtype：返回坐标系
language / language_auto：语言控制
output / callback / sn
返回结果核心字段
result.location.lng / lat：解析坐标
result.formatted_address：标准结构化地址
result.formatted_address_poi：含 POI 结构化地址
result.addressComponent：行政区划组件（国家、省、市、区、街道、街道号、方向、距离）
result.pois[]：周边 POI（name / addr / tag / distance / direction / tel / uid）
result.roads[]：周边道路（name / distance / direction / location）
result.sematic_description：AOI 语义化描述
典型应用场景
网约车/外卖订单的「当前位置」文字描述
轨迹回放中将 GPS 点逆向标注为可读地址
海外业务的多语言地址展示
紧急救援、报警系统的位置上报
解析精度、行政区划数据能力展示
主要参数与默认值
常见状态码
坐标转换、地址展示开发踩坑指南
Q1：为什么我传入的是高德/GPS 坐标，逆地理编码结果偏移很大？ A：百度地图默认接收 BD09LL（百度经纬度）坐标。若传入 WGS84（GPS 原始坐标）或 GCJ02（高德/腾讯），需先调用百度坐标转换 API 转为 BD09LL，否则将出现约 50–500 米的位置偏移。
Q2：formatted_address 和 formatted_address_poi 应该用哪个？ A：需要「标准的省市区街道门牌号」用 formatted_address；需要「贴近真实位置的可读描述」（包含小区、写字楼、学校名称）用 formatted_address_poi，但后者必须设置 extensions_poi=1 才会返回。订单/工单地址展示推荐使用后者。
Q3：海外坐标能用吗？行政区划字段含义会变化吗？ A：支持海外坐标解析，需额外开通海外权限且国外行政区划字段仅代表层级（不严格对应「省/市/区」语义），例如 province 在不同国家可能对应州、大区或郡。展示时建议直接使用 formatted_address 而非逐字段拼接。
**【百度逆地理编码优势】（补充）**
一、地址解析具有较高精准度与灵活性
1.以实际案例为例，一坐标点的解析结果为"河南省洛阳市洛龙区关林街道赛邻一站式家庭服务平台附近44米"，解析位置结果可具体到某一POI相距实际位置的方位和距离。
2.具有周边POI列表排序控制功能，支持开发者根据业务需求，按照距离、热度、重要性不同维度对POI列表进行灵活排序，提供多样化的POI解析选择，在有限的条件中尽可能地适配多元场景。
二、行政区划数据全面
1.支持省、市、区/县、乡镇/街道、社区/村五级行政区划数据返回，满足精细化的用户需求并同步提供民政部和国家统计局双数据源，满足不同行业对数据权威性的差异化需求。
三、召回数据丰富
除了基础位置信息描述外，具有商圈描述、POI热度信息、道路的经纬度和方位信息、POI电话数据信息等召回数据信息，这些数据维度共同构成了位置服务的"增强现实"图层，使客户不仅能找到位置，更能理解位置背后的商业逻辑和运营价值。
