search(options:Object)

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

注：坐标系采用gcj02坐标系

options属性说明

属性 类型 必填 说明
keyword String 是 POI搜索关键字
（默认周边搜索，若需要使用指定地区名称和矩形搜索，请使用region和rectangle参数，不能同时使用）
location String|Object 否 位置坐标，
①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数据： Javascript 关键代码片段：

接口调用说明

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

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

超过日调用量和并发数的开发者，可通过以下途径解决：
     1. 对于多频次的相同请求，可通过缓存结果，并定时访问更新的方式，减少对在线服务调用的依赖；
     2. 企业开发者的配额高于个人开发者，申请企业认证后，需要在控制台->配额申请中免费申请你需要的配额。
        我们将对您的申请进行评估并进行审批（3个工作日内），审批通过后将会获得您申请的配额。
     3. 对于切实需要大配额来满足应用需求的，请在控制台->配额管理中提交购买配额申请，我们的商务会与您取得联系。