地图搜索API接口在移动互联网中的应用
【摘要】 地图搜索API提供关键字、周边、多边形、ID及输入提示五大搜索能力,支持精准定位餐饮、车站等POI。含丰富返回字段(位置、营业信息、图片、导航等),适配各类出行场景,助力高效集成地图搜索功能。
当我们日常出行时,免不了需要搜索一些地点,比如:餐饮、车站。那么地图搜索可以很好地实现搜索功能。
地图搜索包括:
- 关键字搜索:通过文本关键字搜索地点信息,文本可以是结构化地址,例如:浙江省杭州市余杭区文一西路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时不返回
}
}
]
}
}
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)