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

举报
聚美智数 发表于 2026/02/03 15:14:42 2026/02/03
【摘要】 地图搜索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

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。