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

getSuggestion(options:Object)

用よう于获取输入关键字じ的てき补完与あずか提示ていじ，帮助用よう户快速そく输入

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

options属性ぞくせい说明

属性ぞくせい	类型	必填	说明
keyword	String	是これ	用よう户输入いれ的てき关键词（希望きぼう获取后きさき续提示ていじ的てき关键词）
region	String	否いや	设置城市じょうし名めい，限げん制せい关键词所示しめせ的てき地域ちいき范围，如，仅获取“广州市し”范围内的ないてき提示ていじ内容ないよう,默だま认值全国ぜんこく
region_fix	Number	否いや	取と值： 0：[默だま认]当とう前ぜん城市じょうし无结果はて时，自じ动扩大だい范围到全国ぜんこく匹ひき配はい 1：固定こてい在ざい当とう前ぜん城市じょうし
policy	Number	否いや	检索策略さくりゃく，目前もくぜん支持しじ： policy=0：默だま认，常つね规策略さくりゃく policy=1：本ほん策略さくりゃく主要しゅよう用よう于收货地址し、上うえ门服务地址し的てき填はま写うつし，提つつみ高だか了りょう小お区く类、商しょう务楼宇、大学だいがく等分とうぶん类的排はい序じょ，过滤行政ぎょうせい区く、道路どうろ等分とうぶん类（如海淀よどみ大だい街がい、朝あさ阳区等とう），排はい序じょ策略さくりゃく引入真ま实用户对输入提示ていじ的てき点てん击热度ど，使つかい之の更さら为符合ふごう此类应用场景，体たい验更为舒适
location	String	否いや	定位ていい坐すわ标，传入后きさき，若わか用よう户搜索そうさく关键词为类别词（如酒店てん、餐馆时），与あずか此坐标距离近的てき地点ちてん将はた靠もたれ前ぜん显示，格式かくしき： location=lat,lng （示しめせ例れい：location：39.11457,116.55332）
get_subpois	Number	否いや	是ぜ否ひ返かえし回かい子こ地点ちてん，如大厦停车场、出入口でいりぐち等とう取と值： 0 [默だま认]不ふ返かえし回かい 1 返かえし回かい该参数すう适用于 jssdkv1.1 jssdkv1.2
filter	String	否いや	最多さいた支持しじ五ご个分类搜索そうさく指定してい分ぶん类 category=公おおやけ交站搜索そうさく多た个分类 category=大学だいがく,中学ちゅうがく（注意ちゅうい参さん数すう值要进行url编码）该参数すう适用于 jssdkv1.1 jssdkv1.2
address_format	String	否いや	短たん地ち址し，缺かけ省しょう时返回かい长地址し，可か选值：'short' 该参数すう适用于 jssdkv1.1 jssdkv1.2
page_size	Number	否いや	每まい页条目め数すう，最大限さいだいげん制せい为20条じょう，默だま认值10 该参数すう适用于 jssdkv1.1 jssdkv1.2
page_index	Number	否いや	第だいx页，默だま认第1页该参数すう适用于 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为"请求来らい源げん未み被ひ授权"
count			number	是これ	结果总数
data			array	是これ	提示ていじ词数组，每まい项为一いち个POI对象
	id		string	是これ	POI唯ただ一いち标识
	title		string	是これ	提示ていじ文字もじ
	address		string	是これ	地ち址し
	province		string	是これ	省しょう
	city		string	是これ	市し
	adcode		string	是これ	行政ぎょうせい区く划代码
	type		number	是これ	POI类型，值说明あきら：0:普通ふつうPOI / 1:公おおやけ交车站 / 2:地ち铁站 / 3:公おおやけ交线路ろ / 4:行政ぎょうせい区く划
	location		object	是これ	提示ていじ所しょ述じゅつ位置いち坐すわ标
		lat	number	是これ	纬度
		lng	number	是これ	经度

示しめせ例れい

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

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

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

//在Page({})中使用下列代码
                        //数据回填方法
                        backfill: function (e) {
                            var id = e.currentTarget.id;
                            for (var i = 0; i < this.data.suggestion.length;i++){
                              if(i == id){
                                this.setData({
                                  backfill: this.data.suggestion[i].title
                                });
                              }
                            }
                          },

//触发关键词输入提示事件
                        getsuggest: function(e) {
                            var _this = this;
                            //调用关键词提示接口
                            qqmapsdk.getSuggestion({
                              //获取输入框值并设置keyword参数
                              keyword: e.detail.value, //用户输入的关键词，可设置固定值,如keyword:'KFC'
                              //region:'北京', //设置城市名，限制关键词所示的地域范围，非必填参数
                              success: function(res) {//搜索成功后的回调
                                console.log(res);
                                var sug = [];
                                for (var i = 0; i < res.data.length; i++) {
                                  sug.push({ // 获取返回结果，放到sug数组中
                                    title: res.data[i].title,
                                    id: res.data[i].id,
                                    addr: res.data[i].address,
                                    city: res.data[i].city,
                                    district: res.data[i].district,
                                    latitude: res.data[i].location.lat,
                                    longitude: res.data[i].location.lng
                                  });
                                }
                                _this.setData({ //设置suggestion属性，将关键词搜索结果以列表形式展示
                                  suggestion: sug
                                });
                              },
                              fail: function(error) {
                                console.error(error);
                              },
                              complete: function(res) {
                                console.log(res);
                              }
                            });
                        }

接せっ口こう调用说明

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

/ws/place/v1/suggestion 关键词输入にゅう提示ていじ

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