地点搜索-地点信息搜索API-POI检索-关键词地点查询-周边地点搜索

举报
聚美智数 发表于 2026/09/22 16:39:16 2026/09/22
【摘要】 前言地点搜索，可根据关键词、中心点坐标、多边形区域或地点ID检索地点信息，返回详细地址、经纬度、所属区域、分类编码及营业信息等数据，满足地点查找、周边检索、区域筛选与详情查询等多种需求。地点搜索可广泛应用在出行导航、本地生活、数据分析等场景，比如：出行与地图导航：根据关键词或坐标返回地点提示与周边地点信息，用于地址联想、目的地检索和导航规划。本地生活与门店服务：按关键词、区域或周边范围检索...

前言

地点搜索，可根据关键词、中心点坐标、多边形区域或地点ID检索地点信息，返回详细地址、经纬度、所属区域、分类编码及营业信息等数据，满足地点查找、周边检索、区域筛选与详情查询等多种需求。

地点搜索可广泛应用在出行导航、本地生活、数据分析等场景，比如：

出行与地图导航：根据关键词或坐标返回地点提示与周边地点信息，用于地址联想、目的地检索和导航规划。

本地生活与门店服务：按关键词、区域或周边范围检索商户与门店信息，支撑到店推荐、就近服务和配送范围判断。

区域分析与选址评估：以多边形区域或中心点半径为条件批量获取区域内的POI数据，辅助商业选址与市场分析。

API介绍

戳这里查看详情

输入提示

请求说明

名称 类型 必须 说明
keywords String 是 查询关键词
type String 否 分类，服务可支持传入多个分类，多个类型用 | 分割
location String 否 坐标，格式：“X,Y”（经度,纬度），不可以包含空格，建议使用location参数，可在此location附近优先返回搜索关键词信息，在请求参数city不为空时生效
city String 否 搜索城市，可选值：citycode、adcode，不支持县级市。如：010/110000，填入此参数后，会尽量优先返回此城市数据，但是不一定仅局限此城市结果，若仅需要某个城市数据请调用citylimit参数
cityLimit String 否 仅返回指定城市数据，可选值：true/false，默认false
dataType String 否 返回的数据类型，多种数据类型用段落标记符号分隔，可选值：all-返回所有数据类型、poi-返回POI数据类型、bus-返回公交站点数据类型、busline-返回公交线路数据类型

返回样例

{
  "msg": "成功", // 返回码对应描述
  "code": 200, // 返回码，详见返回码说明
  "taskNo": "202960247220113090298671", // 本次请求号
  "data": {
    "count": "10", // 返回结果总数目
    "list": [
      {
        "address": "天目山路518号", // 详细地址
        "adcode": "330106", // 区域编码
        "district": "浙江省杭州市西湖区", // 所属区域
        "name": "西溪国家湿地公园", // tip名称
        "location": "120.061159,30.255079", // tip中心点坐标，当搜索数据为busline类型时，此字段不返回
        "id": "B023B06P06" // 返回数据ID
      }
    ]
  }
}

关键词搜索

请求说明

名称 类型 必须 说明
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", // 本次请求号
  "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": "http://xxxx/showpic/0fcf0bcc9827f4c28647f941472840fe" // 图片的下载链接
          }
        ],
        "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", // 本次请求号
  "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": "http://xxxx/showpic/0fcf0bcc9827f4c28647f941472840fe" // 图片的下载链接
          }
        ],
        "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时不返回
        }
      }
    ]
  }
}

多边形搜索

请求说明

名称 类型 必须 说明
polygon String 是 多边形区域，多个坐标对集合，坐标对用 | 分割。多边形为矩形时，可传入左上右下两顶点坐标对；其他情况下首尾坐标对需相同
keywords String 否 地点关键字，需要被检索的地点文本信息。只支持一个关键字，文本总长度不可超过80字符
types String 否 指定地点类型，可支持传入多个分类，多个类型用 | 分割，默认为150000（交通设施服务）、120000（商务住宅）
showFields String 否 返回结果控制，showFields用来筛选返回结果中可选字段。例：“children,indoor,business,navi,photos”，未设置时，只返回基础信息类内字段
pageSize String 否 当前分页展示的数据条数，取值1-25，默认为10
pageNo String 否 分页，取值1-100，默认为1

返回样例

{
  "msg": "成功", // 返回码对应描述
  "code": 200, // 返回码，详见返回码说明
  "taskNo": "202960247220113090298671", // 本次请求号
  "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": "http://xxxx/showpic/0fcf0bcc9827f4c28647f941472840fe" // 图片的下载链接
          }
        ],
        "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时不返回
        }
      }
    ]
  }
}

地点详情

请求说明

名称 类型 必须 说明
id String 是 地点唯一标识，最多可以传入10个id，多个id之间用 | 分割
showFields String 否 返回结果控制，showFields用来筛选返回结果中可选字段。例：“indoor,business,navi,photos”，未设置时，只返回基础信息类内字段

返回样例

{
  "msg": "成功", // 返回码对应描述
  "code": 200, // 返回码，详见返回码说明
  "taskNo": "202960247220113090298671", // 本次请求号
  "data": {
    "count": "1", // 总数
    "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": "http://xxxx/showpic/0fcf0bcc9827f4c28647f941472840fe" // 图片的下载链接
          }
        ],
        "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
API 在线课程 开发者空间
  • 点赞
  • 收藏
  • 关注作者

评论（0）

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

全部回复

上滑加载中

设置昵称

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

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

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

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入