地图搜索API接口在移动互联网中的应用
当我们日常出行时，免不了需要搜索一些地点，比如：餐饮、车站。那么地图搜索可以很好地实现搜索功能。
地图搜索包括：
- 关键字搜索：通过文本关键字搜索地点信息，文本可以是结构化地址，例如：浙江省杭州市余杭区文一西路890号；也可以是 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时不返回}}]}}