当我们日常出行时，免不了需要搜索一些地点，比如：餐饮、车站。那么地图搜索可以很好地实现搜索功能。
地图搜索包括：
- 关键字搜索：通过文本关键字搜索地点信息，文本可以是结构化地址，例如：北京市朝阳区望京阜荣街10号；也可以是 POI 名称，例如：首开广场；
- 周边搜索：可设置圆心和半径，搜索圆形区域内的地点信息；
- 多边形区域搜索：可设置首尾连接的几何点组成多边形区域，搜索坐标对应多边形内的地点信息；
- ID搜索：可通过已知的地点 ID（POI ID）搜索对应地点信息，建议结合输入提示接口使用；
- 输入提示：可根据输入的关键词查询返回建议列表。
可接入地图搜索API来实现各种地图搜索功能。
下面介绍关键字搜索和周边搜索的使用，其他可参见接口文档
关键字搜索
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| keywords | String | 是 | 地点关键字，只支持一个关键字 ，文本总长度不可超过80字符 |
| types | String | 否 | 指定地点类型，可支持传入多个分类，多个类型用 | 分割 |
| region | String | 否 | 搜索区划，增加指定区域内数据返回权重，如需严格限制返回数据在区域内，请搭配使用cityLimit参数，可输入citycode，adcode，cityname，cityname仅支持城市级别和中文，如“北京市” |
| cityLimit | String | 否 | 指定城市数据返回限制，可选值：true/false，为true时，仅返回region对应区域内数据 |
| showFields | String | 否 | 返回结果控制，showFields用来筛选返回结果中可选字段。例：“children,indoor,business,navi,photos”，未设置时，只返回基础信息类内字段。 |
| pageSize | String | 否 | 当前分页展示的数据条数，取值1-25，默认为10 |
| pageNo | String | 否 | 分页，取值1-100，默认为1 |
返回样例
{
"msg": "成功",//返回码对应描述
"code": 200,//返回码，详见返回码说明
"taskNo": "202960247220113090298671",//本次请求号
"charge": true,//计费标志
"data": {
"count": "10",//总数
"list": [
{
"address": "龙井路1号",//详细地址
"location": "120.121282,30.222719",//经纬度
"id": "B023B13L9M",//唯一标识
"name": "杭州西湖风景名胜区",//名称
"pcode": "330000",//所属省份编码
"adcode": "330106",//所属区域编码
"pname": "浙江省",//所属省份
"cityname": "杭州市",//所属城市
"typecode": "110202",//分类编码
"adname": "西湖区",//所属区县
"citycode": "0571",//所属城市编码
"type": "风景名胜;风景名胜;国家级景点",//所属类型
"business": {
//商业信息
"opentime_today": "24小时营业",//今日营业时间
"cost": "0.00",//人均消费，目前仅在餐饮、酒店、景点、影院类返回
"keytag": "5A景区",//标签
"rating": "4.9",//评分，目前仅在餐饮、酒店、景点、影院类返回
"business_area": "西湖",//所属商圈
"alias": "西湖景区",//别名
"tel": "0571-89586930",//联系电话
"tag": "面面,鸽子,东坡肉,龙井虾仁,西湖醋鱼,特色小吃",//特色美食内容
"opentime_week": "00:00-24:00"//营业时间描述
},
"photos": [
{
"title": "",//图片介绍
"url": "" //图片的下载链接
}
],
"children": [//子地点信息
{
"typecode": "150904",//分类编码
"address": "南山路与广福里交叉口北80米",//详细地址
"subtype": "停车场",//所属类型
"name": "杭州西湖风景名胜区停车点",//名称
"location": "120.158045,30.241689",//经纬度
"id": "B0H2158T3K" //唯一标识
}
],
"navi": {
//导航位置相关信息
"navi_poiid": "H51F022001_476398;4093",//对应的导航引导点坐标，一般为各类出入口，方便结合导航、路线规划等服务使用
"entr_location": "120.153345,30.224729",//入口经纬度坐标
"exit_location": "" //出口经纬度坐标
},
"indoor": {
//室内相关信息
"indoor_map": "0",//是否有室内地图标志，1为有，0为没有
"floor": "",//楼层索引，一般会用数字表示，例如8；indoor_map为0时不返回
"truefloor": "" //所在楼层，一般会带有字母，例如F8；indoor_map为0时不返回
}
}
]
}
}
周边搜索
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| keywords | String | 否 | 地点关键字，只支持一个关键字 ，文本总长度不可超过80字符 |
| types | String | 否 | 指定地点类型，可支持传入多个分类，多个类型用 | 分割，当keywords和types均为空的时候，默认指定types为050000（餐饮服务）、070000（生活服务）、120000（商务住宅） |
| location | String | 是 | 中心点坐标，圆形区域检索中心点，不支持多个点。经度和纬度用","分割，经度在前，纬度在后，经纬度小数点后不得超过6位 |
| radius | String | 否 | 搜索半径，取值范围:0-50000，大于50000时按默认值，单位：米 |
| sortRule | String | 否 | 排序规则，返回结果的排序规则。按距离排序：distance；综合排序：weight，默认distance |
| region | String | 否 | 搜索区划，增加指定区域内数据返回权重，如需严格限制返回数据在区域内，请搭配使用cityLimit参数，可输入行政区划名或对应citycode或adcode |
| cityLimit | String | 否 | 指定城市数据返回限制，可选值：true/false，为true时，仅返回region对应区域内数据 |
| showFields | String | 否 | 返回结果控制，showFields用来筛选返回结果中可选字段。例：“children,indoor,business,navi,photos”，未设置时，只返回基础信息类内字段。 |
| pageSize | String | 否 | 当前分页展示的数据条数，取值1-25，默认为10 |
| pageNo | String | 否 | 分页，取值1-100，默认为1 |
返回样例
{
"msg": "成功",//返回码对应描述
"code": 200,//返回码，详见返回码说明
"taskNo": "202960247220113090298671",//本次请求号
"charge": true,//计费标志
"data": {
"count": "10",//总数
"list": [
{
"address": "龙井路1号",//详细地址
"location": "120.121282,30.222719",//经纬度
"id": "B023B13L9M",//唯一标识
"name": "杭州西湖风景名胜区",//名称
"pcode": "330000",//所属省份编码
"adcode": "330106",//所属区域编码
"pname": "浙江省",//所属省份
"cityname": "杭州市",//所属城市
"typecode": "110202",//分类编码
"adname": "西湖区",//所属区县
"citycode": "0571",//所属城市编码
"type": "风景名胜;风景名胜;国家级景点",//所属类型
"business": {
//商业信息
"parking_type": "",//停车场类型
"cost": "0.00",//人均消费，目前仅在餐饮、酒店、景点、影院类返回
"keytag": "5A景区",//标签
"rating": "4.9",//评分，目前仅在餐饮、酒店、景点、影院类返回
"business_area": "西湖",//所属商圈
"alias": "西湖景区",//别名
"tel": "0571-89586930",//联系电话
"tag": "面面,鸽子,东坡肉,龙井虾仁,西湖醋鱼,特色小吃"//特色美食内容
},
"photos": [
{
"title": "",//图片介绍
"url": "" //图片的下载链接
}
],
"children": [//子地点信息
{
"typecode": "150904",//分类编码
"address": "南山路与广福里交叉口北80米",//详细地址
"subtype": "停车场",//所属类型
"name": "杭州西湖风景名胜区停车点",//名称
"location": "120.158045,30.241689",//经纬度
"id": "B0H2158T3K" //唯一标识
}
],
"navi": {
//导航位置相关信息
"navi_poiid": "H51F022001_476398;4093",//对应的导航引导点坐标，一般为各类出入口，方便结合导航、路线规划等服务使用
"entr_location": "120.153345,30.224729",//入口经纬度坐标
"exit_location": "" //出口经纬度坐标
},
"indoor": {
//室内相关信息
"indoor_map": "0",//是否有室内地图标志，1为有，0为没有
"floor": "",//楼层索引，一般会用数字表示，例如8；indoor_map为0时不返回
"truefloor": "" //所在楼层，一般会带有字母，例如F8；indoor_map为0时不返回
}
}
]
}
}
