search(options:Object)

        地点搜索,搜索周边poi,比如:“酒店” “餐饮” “娱乐” “学校” 等等

        注:坐标系采用gcj02坐标系


options属性说明

属性 类型 必填 说明
keyword String POI搜索关键字
(默认周边搜索,若需要使用指定地区名称和矩形搜索,请使用region和rectangle参数,不能同时使用)
location StringIObject 位置坐标,
①String格式:lat<纬度>,lng<经度>(例:location: ‘39.984060,116.307520’)
②Object格式:
{
  latitude: 纬度,
  longitude: 经度
}
(例:location: {
  latitude: 39.984060,
  longitude: 116.307520
})
默认是当前位置
address_format String 短地址,缺省时返回长地址,可选值:‘short’
page_size Number 每页条目数,最大限制为20条,默认值10
page_index Number 第x页,默认第1页
region String 指定地区名称,不自动扩大范围,如北京市,(使用该功能,若涉及到行政区划,建议将auto_extend设置为0)
当用户使用泛关键词搜索时(如酒店、超市),这类搜索多为了查找附近, 使用location参数,搜索结果以location坐标为中心,返回就近地点,体验更优(默认为用户当前位置坐标)
不与rectangle同时使用
rectangle String 矩形区域范围,不与region同时使用
格式:lat,lng<左下/西南>, lat,lng<右上/东北>(示例:rectangle:‘40.984061,116.307520,39.984060,116.507520’)
该参数适用于 jssdkv1.1 jssdkv1.2
auto_extend String 取值1:[默认]自动扩大范围;
取值0:不扩大。 仅适用于默认周边搜索以及制定地区名称搜索。
该参数适用于 jssdkv1.1 jssdkv1.2
filter String 最多支持五个分类
搜索指定分类
category=公交站
搜索多个分类
category=大学,中学
排除指定分类
category<>商务楼宇
(注意参数值要进行url编码)
该参数适用于 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数组,每项为一个POI对象
id string POI唯一标识
title string POI名称
address string 地址
tel string 电话
category string POI分类
type number POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划
location object 坐标
lat number 纬度
lng number 经度
ad_info object 行政区划信息,目前仅提供adcode
adcode string 行政区划代码
boundary array 轮廓,坐标数组,面积较大的POI会有,如住宅小区
pano object 该POI的街景最佳查看场景及视角信息
id string 街景场景ID,若有pano信息,则id一定存在
heading number 最佳偏航角(与正北方向夹角,街景相关知识请 点击查看
pitch number 俯仰角
zoom number 缩放级别

示例

WXML 模板文件中添加map组件,并绑定markers数据:

<!--绑定点击事件-->
<button bindtap="nearby_search">搜索周边KFC</button>
<!--地图容器-->
<map id="myMap"
   markers="{{markers}}"
   style="width:100%;height:300px;"
   longitude="116.313972"
   latitude="39.980014" scale='16'>
</map>

Javascript 关键代码片段:

// 引入SDK核心类
var QQMapWX = require('xxx/qqmap-wx.js');
 
// 实例化API核心类
var qqmapsdk = new QQMapWX({
  key: '开发密钥(key)' // 必填
});
 
// 事件触发,调用接口
nearby_search:function(){
   var _this = this;
   // 调用接口
   qqmapsdk.search({
      keyword: 'kfc',  //搜索关键词
      location: '39.980014,116.313972',  //设置周边搜索中心点
      success: function (res) { //搜索成功后的回调
        var mks = []
        for (var i = 0; i < res.data.length; i++) {
          mks.push({ // 获取返回结果,放到mks数组中
            title: res.data[i].title,
            id: res.data[i].id,
            latitude: res.data[i].location.lat,
            longitude: res.data[i].location.lng,
            iconPath: "/resources/my_marker.png", //图标路径
            width: 20,
            height: 20
          })
        }
        _this.setData({ //设置markers属性,将搜索结果显示在地图中
          markers: mks
        })
      },
      fail: function (res) {
        console.log(res);
      },
      complete: function (res){
        console.log(res);
      }
  });
}

接口调用说明

      search(options:Object)方法调用接口服务如下:

  • /ws/place/v1/search 地点搜索

      超过日调用量和并发数的开发者,可通过以下途径解决:

      1.对于多频次的相同请求,可通过缓存结果,并定时访问更新的方式,减少对在线服务调用的依赖;

      2.企业开发者的配额高于个人开发者,申请企业认证后,需要在控制台->配额申请中免费申请你需要的配额。

         我们将对您的申请进行评估并进行审批(3个工作日内),审批通过后将会获得您申请的配额。

      3.对于切实需要大配额来满足应用需求的,请在控制台->配额管理中提交购买配额申请,我们的商务会与您取得联系。

这篇文章对您解决问题是否有帮助?

已解决
未解决