微信小程序JavaScript SDK | 腾讯位置服务

reverseGeocoder(options:Object)

本ほん接せっ口こう提供ていきょう由よし坐すわ标到坐すわ标所在ざい位置いち的てき文字もじ描述的てき转换，输入坐すわ标返回かい地理ちり位置いち信しん息いき和わ附近ふきんpoi列れつ表ひょう。

注ちゅう：坐すわ标系采さい用ようgcj02坐すわ标系

options属性ぞくせい说明

属性ぞくせい	类型	必填	说明
location	String\|Object	否いや	位置いち坐すわ标， ①String格式かくしき：lat<纬度>,lng<经度>（例れい：location: '39.984060,116.307520'） ②Object格式かくしき： { latitude: 纬度, longitude: 经度 } （例れい：location: { latitude: 39.984060, longitude: 116.307520 }）默だま认是当とう前ぜん位置いち
coord_type	Number	否いや	输入的てきlocations的てき坐すわ标类型がた，可か选值为[1,6]之の间的整数せいすう，每まい个数字すうじ代表だいひょう的てき类型说明： 1 GPS坐すわ标 2 sogou经纬度ど 3 baidu经纬度ど 4 mapbar经纬度ど 5 [默だま认]腾讯、google、高德こうとく坐すわ标 6 sogou墨すみ卡托
get_poi	Number	否いや	是ぜ否ひ返かえし回かい周しゅう边POI列れつ表ひょう： 1.返かえし回かい；0不ふ返かえし回かい(默だま认)
poi_options	String	否いや	用よう于控制せいPoi列れつ表ひょう： 1 poi_options=address_format=short 返かえし回かい短たん地ち址し，缺かけ省しょう时返回かい长地址し 2 poi_options=radius=5000 半径はんけい，取と值范围 1-5000（米べい） 3 poi_options=page_size=20 每まい页条数すう，取と值范围 1-20 4 poi_options=page_index=1 页码，取と值范围 1-20 5 poi_options=policy=1/2/3 控ひかえ制せい返かえし回かい场景， policy=1[默だま认] 以地标+主要しゅよう的てき路ろ+近きん距离poi为主，着ちゃく力りょく描述当とう前ぜん位置いち； policy=2 到いた家いえ场景：筛选合あい适收货的poi，并会细化收おさむ货地址し，精せい确到楼ろう栋； policy=3 出いで行ゆき场景：过滤掉车辆不易ふえき到いた达的POI(如一些景区内くないPOI)，增加ぞうか道路どうろ出路でっち口こう、交叉こうさ口こう、大だい区域くいき出入口でいりぐち类POI，排はい序じょ会かい根ね据すえ真ま实API大用おおゆう户的用よう户点击自动优化か。 6 poi_options=category=分ぶん类词1,分ぶん类词2，指定してい分ぶん类，多た关键词英文えいぶん逗号分ぶん隔へだた； poi_filter=category<>分ぶん类词1,分ぶん类词2，指定してい不ふ包含ほうがん分ぶん类，多た关键词英文えいぶん逗号分ぶん隔へだた（支持しじ类别参さん见：附ふ录）
sig	String	否いや	签名校こう验开启WebServiceAPI签名校こう验的必传参さん数すう，只ただ需要じゅよう传入生成せいせい的てきSK字じ符ふ串くし即そく可か，不ふ需要じゅよう进行MD5加か密みつ操作そうさ该参数すう仅适用よう于 jssdkv1.2

调用结果

通つう过属性せいsuccess, fail, complete的てき回かい调参数すう来らい接收せっしゅう调用结果

success的てき回かい调参数すう可か以有2个，第だい1个参数すう接收せっしゅう调用结果，第だい2个参数すう控ひかえ制せい返かえし回かい处理后きさき的てき数すう据すえ（非ひ必须参さん数すう）,示しめせ例れい：success:function(res,data)
该属性せい适用于 jssdkv1.1 jssdkv1.2

名称めいしょう					类型	必有	说明
status					number	是これ	状じょう态码，0为正常せいじょう, 310请求参さん数すう信しん息いき有ゆう误， 311key格式かくしき错误, 306请求有ゆう护持信しん息いき请检查字符ふ串くし, 110请求来らい源げん未み被ひ授权
message					string	是これ	状じょう态说明あきら，即そく对状态码status进行说明，如： status为0,message为"query ok",为正常せいじょう, status为310,message为"请求参さん数すう信しん息いき有ゆう误", status为311,message为"key格式かくしき错误", status为306,message为"请求有ゆう护持信しん息いき请检查字符ふ串くし", status为110,message为"请求来らい源げん未み被ひ授权"
result					object	是これ	逆ぎゃく地ち址し解析かいせき结果
	address				string	是これ	地ち址し描述
	formatted_addresses				object		位置いち描述
		recommend			string		经过腾讯地ち图优化か过的描述方式ほうしき，更さら具ぐ人性じんせい化か特とく点てん
		rough			string		大だい致位置いち，可用かよう于对位置いち的てき粗略そりゃく描述
	address_component				object	是これ	地ち址し部ぶ件けん，address不ふ满足需求时可自じ行くだり拼接
		nation			string	是これ	国家こっか
		province			string	是これ	省しょう
		city			string	是これ	市し
		district			string		区く，可能かのう为空字じ串くし
		street			string		街道かいどう，可能かのう为空字じ串くし
		street_number			string		门牌，可能かのう为空字じ串くし
	ad_info				object	是これ	行政ぎょうせい区く划信息いき
		adcode			string	是これ	行政ぎょうせい区く划代码
		name			string	是これ	行政ぎょうせい区く划名称めいしょう
		location			object	是これ	行政ぎょうせい区く划中心ちゅうしん点てん坐すわ标
			lat		number	是これ	纬度
			lng		number	是これ	经度
		nation			string	是これ	国家こっか
		province			string	是これ	省しょう / 直ちょく辖市
		city			string	是これ	市し / 地ち级区及同级行政ぎょうせい区く划
		district			string		区く / 县级市し及同级行政ぎょうせい区く划
	address_reference				object		坐すわ标相对位置いち参考さんこう
		famous_area			object		知名ちめい区域くいき，如商圈けん或ある人ひと们普遍ふへん认为有ゆう较高知名度ちめいど的てき区域くいき
			title		string		名称めいしょう/标题
			location		object		坐すわ标
				lat	number		纬度
				lng	number		经度
			_distance		number		此参考さんこう位置いち到いた输入坐すわ标的直ちょく线距离
			_dir_desc		string		此参考さんこう位置いち到いた输入坐すわ标的方位ほうい关系，如：北きた、南みなみ、内うち
		town			object		乡镇街道かいどう
			title		string		名称めいしょう/标题
			location		objct		坐すわ标
				lat	number		纬度
				lng	number		经度
			_distance		number		此参考さんこう位置いち到いた输入坐すわ标的直ちょく线距离
			_dir_desc		string		此参考さんこう位置いち到いた输入坐すわ标的方位ほうい关系，如：北きた、南みなみ、内うち
		landmark_l1			object		一いち级地标，可か识别性せい较强、规模较大的てき地点ちてん、小お区く等とう【注ちゅう】对象结构同どう famous_area
		landmark_l2			object		二に级地标，较一级地标更为精确，规模更さら小しょう【注ちゅう】：对象结构同どう famous_area
		street			object		街道かいどう【注ちゅう】：对象结构同どう famous_area
		street_number			object		门牌【注ちゅう】：对象结构同どう famous_area
		crossroad			object		交叉こうさ路ろ口こう【注ちゅう】：对象结构同どう famous_area
		water			object		水系すいけい【注ちゅう】：对象结构同どう famous_area
	pois				array		POI数すう组，对象中ちゅう每まい个子项为一いち个POI对象，返かえし回かい的てきPOI数量すうりょう及页数すう可か通どおり过请求もとめ参まい数かずpoi_options设置
		id			string		POI唯ただ一いち标识
		title			string		poi名称めいしょう
		address			string		地ち址し
		category			string		POI分ぶん类
		location			object		提示ていじ所しょ述じゅつ位置いち坐すわ标
			lat		number		纬度
			lng		number		经度
		_distance			number		该POI到いた逆ぎゃく地ち址し解析かいせき传入的てき坐すわ标的直ちょく线距离

示しめせ例れい

WXML 模も板文いたぶん件けん中ちゅう添加てんか组件： Javascript 关键代だい码片段だん：

// 引入SDK核心类
                        var QQMapWX = require('xxx/qqmap-wx.js');

// 实例化API核心类
                        var qqmapsdk = new QQMapWX({
                            key: '开发密钥（key）' // 必填
                        });

//在Page({})中使用下列代码
                        //触发表单提交事件，调用接口
                        formSubmit(e) {
                            var _this = this;
                            qqmapsdk.reverseGeocoder({
                              //位置坐标，默认获取当前位置，非必须参数
                              /**
                               *
                               //Object格式
                                location: {
                                  latitude: 39.984060,
                                  longitude: 116.307520
                                },
                              */
                              /**
                               *
                               //String格式
                                location: '39.984060,116.307520',
                              */
                              location: e.detail.value.reverseGeo || '', //获取表单传入的位置坐标,不填默认当前位置,示例为string格式
                              //get_poi: 1, //是否返回周边POI列表：1.返回；0不返回(默认),非必须参数
                              success: function(res) {//成功后的回调
                                console.log(res);
                                var res = res.result;
                                var mks = [];
                                /**
                                 *  当get_poi为1时，检索当前位置或者location周边poi数据并在地图显示，可根据需求是否使用
                                 *
                                    for (var i = 0; i < result.pois.length; i++) {
                                    mks.push({ // 获取返回结果，放到mks数组中
                                        title: result.pois[i].title,
                                        id: result.pois[i].id,
                                        latitude: result.pois[i].location.lat,
                                        longitude: result.pois[i].location.lng,
                                        iconPath: './resources/placeholder.png', //图标路径
                                        width: 20,
                                        height: 20
                                    })
                                    }
                                *
                                **/
                                //当get_poi为0时或者为不填默认值时，检索目标位置，按需使用
                                mks.push({ // 获取返回结果，放到mks数组中
                                  title: res.address,
                                  id: 0,
                                  latitude: res.location.lat,
                                  longitude: res.location.lng,
                                  iconPath: './resources/placeholder.png',//图标路径
                                  width: 20,
                                  height: 20,
                                  callout: { //在markers上展示地址名称，根据需求是否需要
                                    content: res.address,
                                    color: '#000',
                                    display: 'ALWAYS'
                                  }
                                });
                                _this.setData({ //设置markers属性和地图位置poi，将结果在地图展示
                                  markers: mks,
                                  poi: {
                                    latitude: res.location.lat,
                                    longitude: res.location.lng
                                  }
                                });
                              },
                              fail: function(error) {
                                console.error(error);
                              },
                              complete: function(res) {
                                console.log(res);
                              }
                            })
                        }

接せっ口こう调用说明

reverseGeocoder(options:Object)方法ほうほう调用接せっ口こう服ふく务如下か：

/ws/geocoder/v1 逆ぎゃく地ち址し解析かいせき（位置いち描述）

超ちょう过日调用量りょう和わ并发数すう的てき开发者しゃ，可か通どおり过以下か途と径みち解かい决：
     1. 对于多た频次的てき相しょう同どう请求，可か通どおり过缓存そん结果，并定时访问更新こうしん的てき方式ほうしき，减少对在线服务调用よう的てき依よ赖；
     2. 企くわだて业开发者的てき配はい额高于个人じん开发者しゃ，申さる请企业认证后，需要じゅよう在ざい控ひかえ制せい台だい->配はい额申请中ちゅう免めん费申请你需要じゅよう的てき配はい额。
        我わが们将对您的てき申さる请进行ぎょう评估并进行ぎょう审批（3个工作こうさく日び内ない），审批通どおり过后将しょう会かい获得您申请的配はい额。
     3. 对于切きり实需要じゅよう大だい配はい额来满足应用需求的てき，请在控ひかえ制せい台だい->配はい额管理かんり中ちゅう提ひさげ交购买配额申请，我わが们的商しょう务会与あずか您取得しゅとく联系。