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

原创

聚美智数

修改于 2026-02-20 20:33:48

330

当我们日常出行时，免不了需要搜索一些地点，比如：餐饮、车站。那么地图搜索可以很好地实现搜索功能。

地图搜索包括：

关键字搜索：通过文本关键字搜索地点信息，文本可以是结构化地址，例如：浙江省杭州市余杭区文一西路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时不返回
        }
      }
    ]
  }
}

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-gateway