鸿蒙原生应用元服务开发-位置服务地理编码转化开发

（逆）地理编码转化开发
场景概述
使用坐标描述一个位置，非常准确，但是并不直观，面向用户表达并不友好。系统向开发者提供了以下两种转化能力。
地理编码转化：将地理描述转化为具体坐标。

逆地理编码转化能力：将坐标转化为地理描述。
其中地理编码包含多个属性来描述位置，包括国家、行政区划、街道、门牌号、地址描述等等，这样的信息更便于用户理解。
接口说明
进行坐标和地理编码信息的相互转化，所使用的接口说明如下。
 

开发步骤
说明
GeoConvert需要访问后端服务，请确保设备联网，以进行信息获取。
导入geoLocationManager模块，所有与（逆）地理编码转化能力相关的功能API，都是通过该模块提供的。

.import geoLocationManager from '@ohos.geoLocationManager';

查询geoCoder服务是否可用。
调用isGeoServiceAvailable查询geoCoder服务是否可用，如果服务可用再继续进行步骤3。

import geoLocationManager from '@ohos.geoLocationManager';
try {let isAvailable = geoLocationManager.isGeocoderAvailable();
} catch (err) {console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

获取转化结果。
调用getAddressesFromLocation，坐标转化地理位置信息。

let reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
try {geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => {if (err) {console.log('getAddressesFromLocation err: ' + JSON.stringify(err));} else {console.log('getAddressesFromLocation data: ' + JSON.stringify(data));}});
} catch (err) {console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

参考接口API说明位置服务，应用可以获得与此坐标匹配的GeoAddress列表，应用可以根据实际使用需求，读取相应的参数数据。
调用getAddressesFromLocationName位置描述转化坐标。

.let geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
.try {
.    geoLocationManager.getAddressesFromLocationName(geocodeRequest, (err, data) => {
.        if (err) {
.            console.log('getAddressesFromLocationName err: ' + JSON.stringify(err));
.        } else {
.            console.log('getAddressesFromLocationName data: ' + JSON.stringify(data));
.        }
.    });
.} catch (err) {
.    console.error("errCode:" + err.code + ",errMessage:" + err.message);
.}

参考接口API说明，应用可以获得与位置描述相匹配的GeoAddress列表，其中包含对应的坐标数据，请参考API使用。
如果需要查询的位置描述可能出现多地重名的请求，可以设置GeoCodeRequest，通过设置一个经纬度范围，以高效地获取期望的准确结果。
本文引用参考HarmonyOS官方API9。