您当前的位置： 首页 > Web服务 API > 周边搜索
周边搜索
可通过多种方式搜索POI信息，其中包括关键字搜索、周边搜索、ID详情搜索等多种。
功能简介
在指定位置周边范围内搜索相关信息。如传入指定城市，则仅在该城市搜索。
接口名
https://api.careland.com.cn/api/v2/search/around
HTTP请求方式
post、get
请求参数
  • 参数名称 是否必填 默认值 格式举例 说明
    ak 是
    用户key
    xytype 否 0
    坐标类型：
    0为凯立德坐标系
    2为国家加密坐标系
    keyword 是
    查询关键词keywork、category至少一个不为空
    category 否
    西餐厅|快餐
    20050200|11010200
    分类，多个分类用|隔开，支持POI的type_name及type_code
    city 否 默认为全国
    city=北京
    city=110000
    查询城市可输入城市名或行政区划分代码(adcode)，指定此参数表示在指定的城市查询
    bounds 是
    116.460988,40.006919;
    116.460988,40.006919；
    图面左下右上点，如果没有图面，可以用两个相同的点(经纬度用“，分隔”，坐标间用“;”分隔）
    center 是 116.460988,40.006919
    周边搜的中心点
    range 否 1000米 range=500
    以center为中心的搜索半径
    detail_level 否 DETAIL_REGULAR
    默认
    返回结果的详细程度。 默认DETAIL_REGULAR。 DETAIL_BRIEF：返回poi基础信息，如名称、地址等； DETAIL_REGULAR：增加返回poi其他信息，如团购信息、子poi信息等； DETAIL_VERBOSE：增加返回poi全量的深度信息，如小区的多边形等；
    adcode_type 否 0 0 或 1
    输入输出行政区编码类型 0 凯立德标准编码 1 国际标准编码
    start 否 0
    返回结果起始位置，默认为0
    count 否 10
    返回结果数，默认为10
    callback 否
    回调函数
    callback值是用户定义的函数名称，此参数只在output=json时有效
    • 请求示例
    https://api.careland.com.cn/api/v2/search/around?ak=<您的密匙>&range=10000&detail_level=DETAIL_VERBOSE&count=1&xytype=2&keyword=天安门&center=419365096,143908666
    返回结果示例
    {
  "errorCode": 0,
  "errorMessage": "ok",
  "count": 37,
  "pois": [
	{
	  "id": "539764",
	  "name": "新浪酒吧",
	  "address": "",
	  "haspcd": true,
	  "pcd": {
		"adcode": 10108,
		"province": "",
		"province_code": 0,
		"city_code": 10000,
		"city": "北京市",
		"district": "海淀区"
	  },
	  "tel_num": [],
	  "hasxy": true,
	  "xy": {
		"x": 116.06366,
		"y": 39.817258
	  },
	  "type_code": 13090000,
	  "type_name": "酒吧",
	  "road_id": 0,
	  "distance": 1067,
	  "preferred": true,
	  "routingpointscount": 0, 
	}
  ],
  "info": {
	"showMap": true,
	"bounds": [
	  {
		"x": 116.06366,
		"y": 39.817258
	  },
	  {
		"x": 116.06366,
		"y": 39.817258
	  }
	]
  }
}
    返回参数
  • 名称 类型 说明
    errorCode String 错误代码
    errorMessage String 错误代码
    count String 返回记录数
    pois Object[] 返回的POI信息（仅包含id，名称，地址，PCD信息及坐标），或其他信息（包括公交线路信息、地址信息或其他信息），非POI信息的判断标准为是否包含POIID
    id String 选填 POI ID
    name Object 选填 POI名称
    pcd String 返回结果所在的省市区
    adcode String 行政区划代码
    province String 省、直辖市名称
    province_code Int 省、直辖市代码
    city_code Int 地市代码
    city String 地市名称
    district String 县区名称
    address String 选填 地址信息
    tel_num String 重复 电话信息
    xy Object 选填 POI的经纬度坐标
    x String 经度
    y String 纬度
    type_code String POI 类型代码
    type_name String POI 类型名称
    road_id String 选填 道路ID
    distance String 到指定点的距离
    preferred boolean 是否推荐显示
    sub_pois poi[] 重复 该POI包含的子POI信息
    deep_info 列表页用到的深度信息
    rating String POI的用户综合评分，通常来自BD数据，例如携程、点评
    price String 人均消费价格
    tag String 个性标签，例如适合情侣用餐，提供WIFI等
    has_group_buy boolean 是否有团购信息
    restaurant_reservation boolean 是否可订餐
    theater_reservation boolean 是否可订座
    business_hour boolean 该POI的营业时间
    book_button boolean 是否有预订按钮
    book_name String 预订按钮的名字
    book_url String 点击预订按钮跳转的url
    activity String 活动信息，比如有几条团购，最低打几折，道路：路况，可带颜色，语法同price
    has_wifi String 是否有wifi
    can_park String 是否可停车
    image String 主图片url
    deep_type String 深度信息的类型
    station_type String 充电站类型(开放类型) 公共，专用，自用
    routing_points 导航点
    x String 经度
    y String 纬度
    shapes String[] 重复 该POI的点、线、面数据描述线与面的点集，diff为当前点与上一点的差值。x_diff与y_diff必须一一对应
    base Object 必填 基准点经纬度坐标
    x String 经度
    y String 纬度
    x_diff String 较上一个坐标点的经度差值
    x_diff String 较上一个坐标点的经度差值
    ......
    y_diff String 较上一个坐标点的纬度差值
    y_diff String
    ......
    deep_detail Object 详情页用到的深度信息（暂不提供）
    info Object 其他信息，例如地图展现等
    show_map boolean 是否显示图面
    bounds Object[] 建议的显示范围，返回左下、右上两个坐标值
    x String 经度
    y String 纬度