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

geocoder(options:Object)

提供ていきょう由よし地ち址し描述到いた所ところ述じゅつ位置いち坐すわ标的转换，与あずか逆ぎゃく地ち址し解析かいせきreverseGeocoder()的てき过程正ただし好こう相反あいはん。

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

options属性ぞくせい说明

属性ぞくせい	类型	必填	说明
address	String	是これ	地ち址し（注ちゅう：地ち址し中ちゅう请包含ほうがん城市じょうし名称めいしょう，否いや则会影かげ响解析かいせき效果こうか），如：'北京ぺきん市し海うみ淀よど区く彩あや和かず坊ぼう路ろ海うみ淀よどみ西にし大だい街がい74号ごう'
region	String	否いや	指定してい地ち址し所属しょぞく城市じょうし,如北京ぺきん市し该参数すう适用于 jssdkv1.1 jssdkv1.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	是これ	地ち址し解析かいせき结果
	location		string	是これ	解かい析到的てき坐すわ标
		lat	number	是これ	纬度
		lng	number	是これ	经度
	address_components		object	是これ	解析かいせき后きさき的てき地ち址し部ぶ件けん
		province	string	是これ	省しょう
		city	string	是これ	市し
		district	string	是これ	区く，可能かのう为空字じ串くし
		street	string	是これ	街道かいどう，可能かのう为空字じ串くし
		street_number	string	是これ	门牌，可能かのう为空字じ串くし
	similarity		number		查询字じ符ふ串くし与あずか查询结果的てき文ぶん本ほん相似そうじ度ど
	deviation		number	是これ	误差距离，单位：米べい，该值取决于输入地ち址し的てき精せい确度；如address输入：海うみ淀よど区く北きた四よん环西路ろ，因いん为地址し所しょ述じゅつ范围比ひ较大，因いん此会有ゆう千せん米めーとる级误差さ；而如：银科大だい厦这类具体ぐたい的てき地ち址し，返かえし回かい的てき坐すわ标就会かい相しょう对精确；该值为 -1 时，说明输入地ち址し为过于模糊もこ，仅能精せい确到市区しく级。
	reliability		number	是これ	可か信しん度ど参考さんこう：值范围 1 低てい可か信しん - 10 高こう可か信しん我わが们根据すえ用よう户输入地いりじ址し的てき准じゅん确程度ていど，在ざい解析かいせき过程中ちゅう，将はた解析かいせき结果的てき可か信しん度ど(质量)，由ゆかり低てい到いた高こう，分ふん为1 - 10级，该值>=7时，解析かいせき结果较为准じゅん确，<7时，会存各类不可靠因素，开发者可根据自己的实际使用场景，对于解析质量的实际要求，进行参考。

示しめせ例れい

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

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

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

//在Page({})中使用下列代码
                        //触发表单提交事件，调用接口
                        formSubmit(e) {
                            var _this = this;
                            //调用地址解析接口
                            qqmapsdk.geocoder({
                              //获取表单传入地址
                              address: e.detail.value.geocoder, //地址参数，例：固定地址，address: '北京市海淀区彩和坊路海淀西大街74号'
                              success: function(res) {//成功后的回调
                                console.log(res);
                                var res = res.result;
                                var latitude = res.location.lat;
                                var longitude = res.location.lng;
                                //根据地址解析在地图上标记解析地址位置
                                _this.setData({ // 获取返回结果，放到markers及poi中，并在地图展示
                                  markers: [{
                                    id: 0,
                                    title: res.title,
                                    latitude: latitude,
                                    longitude: longitude,
                                    iconPath: './resources/placeholder.png',//图标路径
                                    width: 20,
                                    height: 20,
                                    callout: { //可根据需求是否展示经纬度
                                      content: latitude + ',' + longitude,
                                      color: '#000',
                                      display: 'ALWAYS'
                                    }
                                  }],
                                  poi: { //根据自己data数据设置相应的地图中心坐标变量名称
                                    latitude: latitude,
                                    longitude: longitude
                                  }
                                });
                              },
                              fail: function(error) {
                                console.error(error);
                              },
                              complete: function(res) {
                                console.log(res);
                              }
                            })
                        }

接せっ口こう调用说明

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

/ws/geocoder/v1 地ち址し解析かいせき

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