4.1 功能介绍

输入提示是一类简单的HTTP接口,提供根据用户输入的关键词查询返回相匹配的POI信息或其他信息,以减少用户的输入量。

该套API免费对外开放,使用之前请先登录然后申请密钥获取使用该组API的key。

输入提示:输入提示是一类简单的HTTP接口,提供根据用户输入的关键词查询返回相匹配的POI信息或其他信息(总数不超过10条)。

4.2 使用限制

企业开发者:单个key支持20万次/天,1万次/分钟调用。

个人开发者:单个key支持1000次/天,1000次/分钟调用。

4.3 输入提示

服务地址:http://api.careland.com.cn/api/v1/suggest?param

param代表的参数包括必填参数和可选参数,所有参数均使用(&)进行分隔。各参数的使用说明请参照下表。

请求参数:

参数名称是否必填默认值格式举例说明
ak 用户key
xytype 0 坐标类型:
0为凯立德坐标系
2为国家加密坐标系
keyword 中石化加油站 查询关键词 当keyword为非类型词时返回匹配的POI或地址、公交线路信息;当keyword为类型词时返回匹配的属于该类型的poi
center 116.460988,40.006919 中心点,加中心点的请求,结果会适当考虑距离。当输入类型词时为周边搜索,center可作为周边搜中心点。
adcode 110000 行政区划代码。通过用户位置或图面范围或其他场景指定的城市代码,默认全国
city 城市名,优先级高于图面(bounds),低于adcode
bounds 116.460988,40.006919|
116.460988,40.006919
图面左下右上点,如果没有图面,可以用两个相同的点(经纬度用“,分隔”,坐标间用“;”分隔)
output json json 输出格式为json或者xml(目前暂不支持xml)
callback 回调函数
callback值是用户定义的函数名称,此参数只在output=json时有效

请求示例:

http://api.careland.com.cn/api/v1/suggest?center=106.539539,29.547217&bounds=106.51173,29.532432;106.567176,29.561553&keyword=公交站&ak=<您的密匙>&xytype=2

返回结果示例:

{
  "errorCode": 0,
  "errorMessage": "ok",
  "adcode": 40000,
  "pois": [
    {
      "id": 4314845523,
      "name": "皮革市场公交站",
      "address": "207路;232路;325路;365路;419路;429路;606路中级车;862路环线",
      "haspcd": true,
      "pcd": {
        "adcode": 40103,
        "province": "",
        "city": "重庆市",
        "district": "渝中区"
      },
      "tel_num": [],
      "hasxy": true,
      "xy": {
        "x": 106.543082,
        "y": 29.545586
      },
      "type_code": 19160000,
      "type_name": "公交站",
      "road_id": 0,
      "distance": 0,
      "preferred": false,
      "shapes_flag": false,
      "hassubpois": false,
      "hasdeepinfo": false,
      "routingpointscount": 0,
      "hasshapes": false,
    },
    {
      "id": 4314845998,
      "name": "健康路公交站",
      "address": "829路",
      "haspcd": true,
      "pcd": {
        "adcode": 40103,
        "province": "",
        "city": "重庆市",
        "district": "渝中区"
      },
      "tel_num": [],
      "hasxy": true,
      "xy": {
        "x": 106.541606,
        "y": 29.552329
      },
      "type_code": 19160000,
      "type_name": "公交站",
      "road_id": 0,
      "distance": 0,
      "preferred": false,
      "shapes_flag": false,
      "hassubpois": false,
      "hasdeepinfo": false,
      "routingpointscount": 0,
      "hasshapes": false,
    }
  ]
}

返回参数说明:

名称 类型 说明
errorCode String 错误代码
errorMessage String 错误描述
pois Object[] 返回的POI信息(仅包含id,名称,地址,PCD信息及坐标),或其他信息(包括公交线路信息、地址信息或其他信息),非POI信息的判断标准为是否包含POIID
  id String 选填 POI ID
name String 选填 POI名称
pcd Object 返回结果所在的省市区
  adcode String 行政区划代码
province String 省、直辖市名称
city String 地市名称
district String 县区名称
address String 选填 地址信息
tel_num String 重复 电话信息
xy String 选填 POI的经纬度坐标
  x String 经度乘以1000000
y String 纬度乘以1000000
type_code String POI 类型代码
type_name String POI 类型名称
road_id String 选填 道路ID
distance String 到指定点的距离
preferred boolean 是否推荐显示
shapes_flag String 是否有形状
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 深度信息的类型
routing_points   导航点
  x String 经度
y String 纬度
shapes Array

重复 该POI的点、线、面数据

描述线与面的点集,diff为当前点与上一点的差值。x_diff与y_diff必须一一对应
  base Object  
  x String 经度
y String 纬度
x_diff String 较上一个坐标点的经度差值。。
x_diff String 较上一个坐标点的经度差值。。
……    
x_diff String 较上一个坐标点的经度差值。。
x_diff String  
……    
deep_detai DeepDetail 详情页用到的深度信息
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号