您当前的位置: 首页 > Web服务 API > POI详情

POI详情
可通过多种方式搜索POI信息,其中包括关键字搜索、周边搜索、ID详情搜索等多种。
功能介绍
通过点击地图POI获取POIID后请求POI的详细信息;
接口名
https://api.careland.com.cn/api/v2/search/poiid
HTTP请求方式
post、get
请求参数
  • 参数名称 是否必填 默认值 格式举例 说明
    ak
    用户key
    xytype 0
    坐标类型:
    0为凯立德坐标系
    2为国家加密坐标系
    userid
    用户id
    keyword
    poi唯一ID
    app webapi
    应用名称及版本(基础服务统计用)
    callback
    回调函数
    callback值是用户定义的函数名称,此参数只在output=json时有效
  • 请求示例
    https://api.careland.com.cn/api/v2/search/poiid?ak=<您的密匙>&keyword=29069&xytype=2
    返回结果示例
    {
      "errorCode": 0,
      "errorMessage": "ok",
      "count": 1,
      "pois": [
    	{
    	  "id": "29069",
    	  "name": "烔炀中心学校",
    	  "address": "",
    	  "haspcd": true,
    	  "pcd": {
    		"adcode": 340181,
    		"province": "安徽省",
    		"province_code":340000 ,
    		"city_code":340100 ,
    		"city": "合肥市",
    		"district": "巢湖市"
    	  },
    	  "tel_num": [],
    	  "hasxy": true,
    	  "xy": {
    		"x": 423819082.8,
    		"y": 114329008.8
    	  },
    	  "type_code": 15990000,
    	  "type_name": "其它文化教育设施",
    	  "road_id": 0,
    	  "distance": 0,
    	  "preferred": true,
    	  "shapes_flag": false,
    	  "hassubpois": false,
    	  "hasdeepinfo": false,
    	  "routingpointscount": 0,
    	  "hasshapes": false
    	}
      ],
      "info": {
    	"showMap": true,
    	"bounds": []
      }
    }
    			
    返回参数说明
  • 名称 类型 说明
    errorCode String 错误代码
    errorMessage String 错误代码
    count String 返回记录数
    pois Object[] 返回的POI信息(仅包含id,名称,地址,PCD信息及坐标),或其他信息 (包括公交线路信息、地址信息或其他信息),非POI信息的判断标准为是否包含POIID
    id String 选填 POI ID
    name String 选填 POI名称
    pcd String 返回结果所在的省市区
    adcode Int 行政区划代码
    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等
    prihas_group_buyce 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 纬度