地点检索

设置圆心和半径,检索圆形区域内的地点信息(常用于周边检索场景)。

  • 接口文档

    接口文档
  • 地点检索查询

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
地点检索查询
接口地址:http://apis.juhe.cn/place/search
请求方式:http get/post
返回类型:json
接口描述:通过传递需要查询的经纬度中心坐标和关键字,检索周边的符合条件的地点信息。常用于周边检索场景
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  key string 在个人中心->我的数据,接口名称上方查看
  lng string 中心坐标经度 ,如:120.730683
  lat string 中心纬度 ,如:31.269016
  query string 检索关键词,如:小区、医院
  radius int 检索半径,单位米,最大10000; 默认:1000
  coord_type int 坐标类型,默认:3
说明
1(wgs84ll即GPS经纬度)
2(gcj02ll即国测局经纬度坐标)
3(bd09ll即百度经纬度坐标)
4(bd09mc即百度米制坐标)
  page_num int 分页页码,默认为0。0代表第一页,1代表第二页,以此类推

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "http://apis.juhe.cn/place/search?key=key&lng=xxx&lat=xxx&query=xxx&radius=&coord_type=&page_num="

返回参数说明:

名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result object 返回结果集
      radius int 检索的半径
      query string 检索的关键字
      lat string 检索的坐标经度
      lng string 检索的坐标纬度
      total int 检索的地点总数量,单次请求total最多为150
      page_size int 每页返回数量
      page_num int 当前页数
      data array 检索到的地址结果列表,无结果时为null
          name string 地点名称
          location object 地点坐标
          address string 地点详细地址
          detail_info object 地点扩展信息
          tag string 标签
          label string 标签细分解释,比如停车场标签(地上停车场/地下停车场),知名景区标签(几A级景区),酒店标签(什么类型酒店)等

JSON返回示例:JSON在线格式化工具 >

      {
  "reason": "success",
  "result": {
    "radius": 300,
    "query": "小区",
    "lat": "31.269016",
    "lng": "120.730683",
    "total": 3,
    "page_size": 20,
    "page_num": 0,
    "data": [
      {
        "name": "中新星湖湾",
        "location": {
          "lat": 31.267693,
          "lng": 120.730905
        },
        "address": "苏州市苏州工业园区月亮湾路星湖公馆",
        "province": "江苏省",
        "city": "苏州市",
        "area": "苏州工业园区",
        "detail_info": {
          "tag": "房地产;住宅区",
          "label": null
        }
      },
      {
        "name": "建屋紫金东方",
        "location": {
          "lat": 31.270796,
          "lng": 120.729998
        },
        "address": "启月街288号",
        "province": "江苏省",
        "city": "苏州市",
        "area": "苏州工业园区",
        "detail_info": {
          "tag": "房地产;其他",
          "label": "独墅湖科教创新区"
        }
      },
      {
        "name": "翰地景观HID",
        "location": {
          "lat": 31.270744,
          "lng": 120.73041
        },
        "address": "苏州工业园区启月街288号紫金东方商务广场2层3-215-3室",
        "province": "江苏省",
        "city": "苏州市",
        "area": "苏州工业园区",
        "detail_info": {
          "tag": "房地产;住宅区",
          "label": null
        }
      }
    ]
  },
  "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  277001 经纬度坐标格式不正确
  277002 检索关键字不能为空
  277003 网络异常,请重试
  277004 请求异常

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码
地点检索
0
申请次数
770
ID
0
收藏次数

推荐API

  • 个人/企业涉诉查询

    通过企业关键词查询企业涉松详情,如裁判文书、开庭公告、执行公告、失信公告、案件流程等等。
  • 账号黑产风险识别

    根据手机号来查询是否命中黑产风险
  • IP反查域名

    IP反查域名是通过IP查询相关联的域名信息的功能,它提供IP地址历史上绑定过的域名信息。
  • 人脸卫士

    结合权威身份认证的精准人脸风险查询服务,提升人脸应用及身份认证生态的安全性。人脸风险情报库,覆盖范围广、准确性高,数据权威可靠。
  • 全国城市空气质量

    全国城市和站点空气质量查询,污染物浓度及空气质量分指数、空气质量指数、首要污染物及空气质量级别、健康指引及建议采取的措施等。

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future