鸿蒙 地理编码：正地理编码与逆地理编码

开发中，定位功能除了获取经纬度坐标外，常常还需要将坐标转换为用户可读的位置描述（如国家、城市、街道等）。系统提供了正地理编码和逆地理编码两种转化能力。

一、地理编码

使用经纬度坐标描述一个位置非常准确，但是并不直观，面向用户表达并不友好。系统提供了以下两种转化能力：

地理编码包含的信息

逆地理编码返回的GeoAddress包含多个属性，便于用户理解：

二、核心接口

三、开发步骤

3.1 导入模块

import { geoLocationManager } from '@kit.LocationKit';

3.2 查询服务是否可用

重要：正地理编码与逆地理编码功能需要访问后端服务，请确保设备联网，以进行信息获取。

try { let isAvailable = geoLocationManager.isGeocoderAvailable(); console.info('地理编码服务可用: ' + isAvailable); } catch (err) { console.error("errCode:" + JSON.stringify(err)); }

注意：如果服务不可用，说明该设备不具备地理编码与逆地理编码能力，请勿使用相关接口。

3.3 逆地理编码：坐标 → 地址

将经纬度坐标转化为地理编码（即位置信息），获得匹配的GeoAddress列表。

请求参数（ReverseGeoCodeRequest）：

let reverseGeocodeRequest: geoLocationManager.ReverseGeoCodeRequest = { "latitude": 31.12, "longitude": 121.11, "maxItems": 1 }; try { geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => { if (err) { console.error('getAddressesFromLocation err: ' + JSON.stringify(err)); } else { console.info('getAddressesFromLocation data: ' + JSON.stringify(data)); // data为GeoAddress数组，包含国家、行政区划、街道等信息 } }); } catch (err) { console.error("errCode:" + JSON.stringify(err)); }

3.4 正地理编码：地址 → 坐标

将地理编码（即位置信息）转化为经纬度坐标。

请求参数（GeoCodeRequest）：

let geocodeRequest: geoLocationManager.GeoCodeRequest = { "description": "北京市丰台区xx路xx号", "maxItems": 1 }; try { geoLocationManager.getAddressesFromLocationName(geocodeRequest, (err, data) => { if (err) { console.error('getAddressesFromLocationName err: ' + JSON.stringify(err)); } else { console.info('getAddressesFromLocationName data: ' + JSON.stringify(data)); // data为GeoAddress数组，包含纬度、经度等坐标信息 } }); } catch (err) { console.error("errCode:" + JSON.stringify(err)); }

3.5 提高查询精度

如果需要查询的位置信息可能出现多地重名的情况，可以通过设置经纬度范围来限定查询区域，以高效地获取期望的准确结果。

let geocodeRequest: geoLocationManager.GeoCodeRequest = { "description": "南京路", "maxItems": 5, "minLatitude": 31.0, "minLongitude": 121.0, "maxLatitude": 31.5, "maxLongitude": 121.5 };

四、完整示例

import { geoLocationManager } from '@kit.LocationKit'; import { BusinessError } from '@kit.BasicServicesKit'; @Entry @Component struct GeocodeDemo { @State latitude: string = ''; @State longitude: string = ''; @State address: string = ''; build() { Column() { // 逆地理编码：坐标转地址 Button('坐标转地址') .onClick(() => { this.reverseGeocode(); }) Text('纬度: ' + this.latitude) Text('经度: ' + this.longitude) Text('地址: ' + this.address) } .padding(20) } // 逆地理编码：坐标 → 地址 reverseGeocode() { // 检查服务是否可用 if (!geoLocationManager.isGeocoderAvailable()) { console.error('地理编码服务不可用'); return; } let request: geoLocationManager.ReverseGeoCodeRequest = { latitude: 31.12, longitude: 121.11, maxItems: 1 }; try { geoLocationManager.getAddressesFromLocation(request, (err, data) => { if (err) { console.error('逆地理编码失败: ' + JSON.stringify(err)); } else if (data && data.length > 0) { let addr = data[0]; this.latitude = addr.latitude?.toString() || ''; this.longitude = addr.longitude?.toString() || ''; this.address = addr.description || ''; console.info('逆地理编码成功: ' + JSON.stringify(addr)); } }); } catch (err) { console.error("逆地理编码异常: " + JSON.stringify(err)); } } // 正地理编码：地址 → 坐标 forwardGeocode() { if (!geoLocationManager.isGeocoderAvailable()) { console.error('地理编码服务不可用'); return; } let request: geoLocationManager.GeoCodeRequest = { description: "北京市丰台区石榴庄街道xxx号", maxItems: 1 }; try { geoLocationManager.getAddressesFromLocationName(request, (err, data) => { if (err) { console.error('正地理编码失败: ' + JSON.stringify(err)); } else if (data && data.length > 0) { let addr = data[0]; console.info('正地理编码成功: 纬度=' + addr.latitude + ', 经度=' + addr.longitude); } }); } catch (err) { console.error("正地理编码异常: " + JSON.stringify(err)); } } }

五、注意事项