地图搜索API接口在移动互联网中的应用

当我们日常出行时免不了需要搜索一些地点比如餐饮、车站。那么地图搜索可以很好地实现搜索功能。地图搜索包括关键字搜索通过文本关键字搜索地点信息文本可以是结构化地址例如浙江省杭州市余杭区文一西路890号也可以是 POI 名称例如首开广场周边搜索可设置圆心和半径搜索圆形区域内的地点信息多边形区域搜索可设置首尾连接的几何点组成多边形区域搜索坐标对应多边形内的地点信息ID搜索可通过已知的地点 IDPOI ID搜索对应地点信息建议结合输入提示接口使用。输入提示可根据输入的关键词查询返回建议列表。可接入地图搜索API来实现各种地图搜索功能。下面介绍关键字搜索和周边搜索的使用其他可参见接口文档关键字搜索请求参数名称类型必须说明keywordsString是地点关键字只支持一个关键字 文本总长度不可超过80字符typesString否指定地点类型可支持传入多个分类多个类型用 | 分割regionString否搜索区划增加指定区域内数据返回权重如需严格限制返回数据在区域内请搭配使用cityLimit参数可输入citycodeadcodecitynamecityname仅支持城市级别和中文如“北京市”cityLimitString否指定城市数据返回限制可选值true/false为true时仅返回region对应区域内数据showFieldsString否返回结果控制showFields用来筛选返回结果中可选字段。例“children,indoor,business,navi,photos”未设置时只返回基础信息类内字段。pageSizeString否当前分页展示的数据条数取值1-25默认为10pageNoString否分页取值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:,//楼层索引一般会用数字表示例如8indoor_map为0时不返回truefloor://所在楼层一般会带有字母例如F8indoor_map为0时不返回}}]}}周边搜索请求参数名称类型必须说明keywordsString否地点关键字只支持一个关键字 文本总长度不可超过80字符typesString否指定地点类型可支持传入多个分类多个类型用 | 分割当keywords和types均为空的时候默认指定types为050000餐饮服务、070000生活服务、120000商务住宅locationString是中心点坐标圆形区域检索中心点不支持多个点。经度和纬度用,分割经度在前纬度在后经纬度小数点后不得超过6位radiusString否搜索半径取值范围:0-50000大于50000时按默认值单位米sortRuleString否排序规则返回结果的排序规则。按距离排序distance综合排序weight默认distanceregionString否搜索区划增加指定区域内数据返回权重如需严格限制返回数据在区域内请搭配使用cityLimit参数可输入行政区划名或对应citycode或adcodecityLimitString否指定城市数据返回限制可选值true/false为true时仅返回region对应区域内数据showFieldsString否返回结果控制showFields用来筛选返回结果中可选字段。例“children,indoor,business,navi,photos”未设置时只返回基础信息类内字段。pageSizeString否当前分页展示的数据条数取值1-25默认为10pageNoString否分页取值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:,//楼层索引一般会用数字表示例如8indoor_map为0时不返回truefloor://所在楼层一般会带有字母例如F8indoor_map为0时不返回}}]}}