API文档 >>  搜索支持在线预订的商户

  • API名称: 搜索支持在线预订的商户 reservation/find_businesses_with_reservations
  • 描述:按照地理位置、商区、分类、关键词等多种条件获取支持在线预订的商户信息列表
  • 数据格式:JSON/XML
  • 方法:HTTP GET
  • 等级:普通
  • 是否需要用户授权:
  • 请求URL:http://api.dianping.com/v1/reservation/find_businesses_with_reservations

请求参数

  • 必选参数

    名称 类型 说明
    appkey string App Key,应用的唯一标识
    sign string 请求签名,生成方式见《API请求签名生成文档》
    reservation_date string 预订的日期,格式为“yyyy-MM-dd”
    reservation_time string 预订的时间,格式为“HH:mm”,24小时制
    number_of_people int 到店人数,最小为1,最大为50
  • 可选参数

    名称 类型 说明
    city string 城市名称,可选范围见相关API返回结果,与经纬度坐标二者必选其一传入
    region string 城市区域名,可选范围见相关API返回结果(不含返回结果中包括的城市名称信息),如传入城市区域名,则城市名称必须传入
    latitude float 纬度坐标,须与经度坐标同时传入,与城市名称二者必选其一传入
    longitude float 经度坐标,须与纬度坐标同时传入,与城市名称二者必选其一传入
    offset_type int 偏移类型,0:未偏移,1:高德坐标系偏移,2:图吧坐标系偏移,如不传入,默认值为0
    radius int 搜索半径,单位为米,最小值300,最大值5000,如不传入默认为1000
    category string 分类名,可选范围见相关API返回结果;支持同时输入多个分类,以逗号分隔,最大不超过5个。
    keyword string 关键词,搜索范围包括支持在线预订的商户名、地址、标签等
    out_offset_type int 传出经纬度偏移类型,1:高德坐标系偏移,2:图吧坐标系偏移,如不传入,默认值为1
    sort int 结果排序,1:默认,2:星级高优先,3:产品评价高优先,4:环境评价高优先,5:服务评价高优先,6:点评数量多优先,7:离传入经纬度坐标距离近优先,8:人均价格低优先,9:人均价格高优先
    limit int 每页返回的支持在线预订的商户结果条目数上限,最小值1,最大值40,如不传入默认为20
    page int 页码,如不传入默认为1,即第一页
    format string 返回数据格式,可选值为json或xml,如不传入,默认值为json

返回结果

  • 状态字段

    名称 类型 说明
    status string 本次API访问状态,如果成功返回"OK",并返回结果字段,如果失败返回"ERROR",并返回错误说明
    count int 本次API访问所获取的支持在线预订的商户数量
    total_count int 所有页面支持在线预订的商户总数
  • 结果字段

    名称 类型 说明
    business_id int 支持在线预订的商户ID
    name string 支持在线预订的商户名
    branch_name string 分店名
    address string 地址
    telephone string 带区号的电话
    city string 所在城市
    regions list 所在区域信息列表,如[徐汇区,徐家汇]
    categories list 所属分类信息列表,如[宁波菜,婚宴酒店]
    latitude float 纬度坐标
    longitude float 经度坐标
    distance int 支持在线预订的商户与参数坐标的距离,单位为米,如不传入经纬度坐标,结果为-1
    business_url string 支持在线预订的商户页面链接
    photo_url string 照片链接,照片最大尺寸700×700
    s_photo_url string 小尺寸照片链接,照片最大尺寸278×200
    has_online_reservation int 是否有在线预订,0:没有,1:有
    online_reservation_url string 在线预订WWW站点页面链接
    online_reservation_h5_url string 在线预订页面HTML5站点链接

注意事项

  • 传入经纬度坐标参数(latitude/longitude),所获取的支持在线预订的商户列表才能限定在特定区域范围内,或按照距离排序

API测试工具

示例请求

http://api.dianping.com/v1/reservation/find_businesses_with_reservations?appkey=40619575&sign=672E5318ADD293F3AEEDB05C5DBC0AC991AC431D&city=上海&category=美食&number_of_people=3&reservation_date=2014-1-18&reservation_time=18:00&limit=1

示例结果

{
  "status": "OK",
  "total_count": 2496,
  "count": 1,
  "businesses": [
    {
      "business_id": 5205627,
      "name": "拉亚汉堡经典餐厅",
      "branch_name": "商城路店",
      "address": "浦东新区商城路889号",
      "telephone": "021-60756266",
      "city": "上海",
      "regions": [
        "浦东新区",
        "八佰伴"
      ],
      "categories": [
        "西式简餐"
      ],
      "latitude": 31.233084,
      "longitude": 121.522064,
      "business_url": "http://dpurl.cn/p/eXEzuqhgyN",
      "business_h5_url": "http://dpurl.cn/p/ysewjEeGvs",
      "photo_url": "http://i3.dpfile.com/pc/0bfecfc8b3de952af6073b88ebc2fc7c(700x700)/thumb.jpg",
      "s_photo_url": "http://i1.dpfile.com/pc/0bfecfc8b3de952af6073b88ebc2fc7c(278x200)/thumb.jpg",
      "has_online_reservation": 1,
      "online_reservation_url": "http://dpurl.cn/p/dFjx2uc0xx",
      "online_reservation_h5_url": "http://dpurl.cn/p/FRc9CC563F"
    }
  ]
}