Skip to content

酒店-目的地补全

基本信息

Path: /hotel/destination

Method: POST

使用说明

  • 本接口用于获取与用户输入关键字匹配的目的地列表,目的地可以是城市、行政区、酒店、医院等。
  • 使用本接口可以不再使用GEO静态数据,本接口数据和功能比GEO数据完善许多。
  • 本接口适于和hotel.list接口结合使用,获取的目的地信息中的CityId作为hotel.list接口的CityId参数,目的地如果不是城市类型,那么目的地名称可以作为hotel.list接口的QueryText参数。

请求参数

Headers

参数名称参数值是否必须示例备注
Content-Typeapplication/json
x-lvcang-api-account开放平台分配aaa.test

Body

名称类型是否必须备注
queryTextstring必须关键字 用户输入的关键字
oSTypestring非必须用户系统类型 ,默认“PC” 用户设备的唯一识别号,可以是mac地址,手机也可以是IMEI,一般不需要传入
sugOrientationinteger必须目的地范围,默认“0” 在哪个范围进行目的地匹配检索。 0-国内 1-国际 2-国内国际混排,国内优先 3-国内国际混排,国际优先

返回数据

名称类型是否必须备注
codenumber必须返回码 0:请求成功 3000:请求失败 5000:请求异常
messagestring必须返回消息
successboolean必须请求是否成功
dataobject必须返回数据
├─ regionResultobject []必须目的地结果列表
├─ regionIdstring必须目的地ID 当目的地类型(RegionType字段)是城市时,此处为即hotel.list接口所使用的CityId
├─ regionNameCnstring非必须目的地中文名
├─ parentIdstring必须父级目的地ID 当目的地类型(RegionType字段)是城市时可以忽略本字段,目的地类型为其他类型时,本字段表示该目的地所属的城市ID,即hotel.list接口使用的CityId
├─ parentNameCnstring必须父级目的地中文名 当目的地类型是城市时本字段表示城市所属省份名称,部分城市(比如直辖市)本字段为空。 当目的地类型为其他类型时,本字段为目的地所属城市的名称。
├─ regionTypeinteger必须目的地类型 0-城市 1-行政区 2-景区 3-商圈 4-酒店 5-地点 6-医院 7-学校 8-景点 9-地铁站 10-机场/车站 12-品牌 13-集团
├─ filterTypeinteger必须对应筛选项的类型 用于hotel.filter接口的入参,获取本目的地对应的筛选项 3-品牌 4-行政区 5-商圈 6-POI(大学、周边游[风景区]、汽车站、火车站、地铁等)
├─ addressstring必须POI地址信息 目的地的地址信息描述
guidstring必须guid