地点搜索-地图地点搜索API-POI搜索-关键词搜索-周边搜索-输入提示-经纬度查询

简介: 地点搜索API支持关键词、坐标、多边形区域及ID等多种方式检索,返回地址、经纬度、行政区划、分类编码、营业时间、评分、照片等结构化POI数据,广泛应用于导航、本地生活、商业选址与数据分析场景。

前言

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

地点搜索可广泛应用在出行导航、本地生活、数据分析等,如:

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

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

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

API介绍

地点搜索功能介绍111.png
地点搜索.png

输入提示

请求说明

名称 类型 必须 说明
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", // jingwei度
        "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", // jingwei度
            "id": "B0H2158T3K" // 唯一标识
          }
        ],
        "navi": {
    // 导航位置相关信息
          "navi_poiid": "H51F022001_476398;4093", // 对应的导航引导点坐标,一般为各类出入口,方便结合导航、路线规划等服务使用
          "entr_location": "120.153345,30.224729", // 入口经jingwei坐标
          "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", // jingwei度
        "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", // jingwei度
            "id": "B0H2158T3K" // 唯一标识
          }
        ],
        "navi": {
    // 导航位置相关信息
          "navi_poiid": "H51F022001_476398;4093", // 对应的导航引导点坐标,一般为各类出入口,方便结合导航、路线规划等服务使用
          "entr_location": "120.153345,30.224729", // 入口jingwei度坐标
          "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", // jingwei度
        "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", // jingwei度
            "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", // jingwei度
        "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", // 入口jingwei度坐标
          "exit_location": "" // 出口jingwei度坐标
        },
        "indoor": {
    // 室内相关信息
          "indoor_map": "0", // 是否有室内地图标志,1为有,0为没有
          "floor": "", // 楼层索引,一般会用数字表示,例如8;indoor_map为0时不返回
          "truefloor": "" // 所在楼层,一般会带有字母,例如F8;indoor_map为0时不返回
        }
      }
    ]
  }
}
相关文章
|
2月前
|
数据采集 API
个税缴款接口-个税全员全额申报接口-个税申报API-个人所得税申报接口介绍
该API打通企业与各省电子税务局,支持个税申报、缴款、完税证明下载等全流程自动化。告别客户端登录、多账号切换与人工操作,实现批量报送、自动算税、跨区域申报及实时结果查询,大幅提升合规性与人效。
228 0
个税缴款接口-个税全员全额申报接口-个税申报API-个人所得税申报接口介绍
|
2月前
|
API
企业发票归集-发票开票记录查询API接口介绍
金税四期下,“以数治税”成主流。发票归集API支持按月/日自动拉取企业进销项全票面数据,对接税务数字账户,替代人工下载录入,提升财税效率与合规性。
179 0
|
3月前
|
自然语言处理 API
字典查询-词典查询-成语词典-新华字典API接口介绍
这是一款阿里云市场提供的汉字查询API服务,支持拼音/部首/汉字/词语多维检索,返回拼音、笔画、部首、释义、出处等详细信息,适用于教育、写作、校对及识字学习场景。
413 1
|
3月前
|
文字识别 算法 API
二维码OCR识别-条形码OCR-图像识别接口介绍
本API提供高精度条码识别服务,兼容所有主流一维码、二维码格式,支持URL/Base64/文件上传。依托图像增强算法,显著提升破损、倾斜、反光等复杂场景下的识别成功率,精准提取明文数据,轻量对接物流、零售、政务等八大场景系统。
218 0
|
3月前
|
JSON 自然语言处理 API
车辆尾号限行-出行限号查询-车辆尾号限行规则查询API接口介绍
【车辆限行查询API】提供全国重点城市实时、准确的机动车限行政策数据,覆盖限行时间、区域、尾号、节假日及临时管制等全要素。支持城市列表动态获取与单城规则查询,具备高并发、低延迟、易接入、强稳定等优势,广泛适用于导航、网约车、物流、车服及智慧交通等场景。(239字)
428 2
|
3月前
|
API
全国景点查询-全国景区查询-旅游景点搜索API接口介绍
该API提供全国景点查询服务,覆盖省、市、区县四级行政区划,支持按名称/ID检索景点信息,返回坐标、地址、门票、图片等结构化数据,助力旅游规划与应用开发。
266 0
|
3月前
|
API
企业商标查询-企业商标-企业商标搜索API接口介绍
本API支持通过企业名称或统一社会信用代码查询商标信息,涵盖商标名、注册号、分类、申请人、状态及申请日期等。适用于品牌命名、注册策略、侵权应对、竞品监测等11类场景,每页最多返回20条数据。
286 0
|
3月前
|
人工智能 自然语言处理 小程序
语音翻译-短语音翻译-语音转文字-语音识别-语音播报翻译API接口介绍
阿里云语音翻译API,一站式实现“语音→文本→语音”全链路翻译,支持40+语言、60秒短语音,适用于跨境电商、国际会议、在线教育等场景,接入便捷,高效消除语言障碍。
345 0
|
3月前
|
供应链 API
企业纳税人信息查询-纳税人类型查询-一般纳税人资格查询-企业纳税人类型查询API接口介绍
本API支持通过企业名称、注册号或统一信用代码查询一般纳税人信息,涵盖纳税人名称、识别号、资格类型、主管税务机关及有效期等关键字段,适用于商业合作、投融资风控、企业自检及政府监管等场景。
295 0
|
3月前
|
API
药品信息查询-药品及药企信息查询API接口介绍
药品查询API提供标准化药品数据服务,覆盖中西药、OTC、处方药等近10万种药品,支持多维度检索(名称/批准文号/成分等),返回有效期、成分、厂家、适应症、禁忌症等30+核心字段,含分类查询、药品信息、详情、药名搜索4类接口,助力医药企业与健康平台高效构建药品应用。
678 0