方法名称
hotel.destination
使用说明
本接口用于获取与用户输入关键字匹配的目的地列表，目的地可以是城市、行政区、酒店、医院等。
使用本接口可以不再使用GEO静态数据，本接口数据和功能比GEO数据完善许多。
本接口适于和hotel.list接口结合使用，获取的目的地信息中的CityId作为hotel.list接口的CityId参数，目的地如果不是城市类型，那么目的地名称可以作为hotel.list接口的QueryText参数。
具体用法可以参考艺龙官网的目的地输入框和关键字输入框逻辑。
输入参数
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| QueryText | 关键字 | String(50) | Y | 用户输入的关键字 |
| DeviceId | 用户设备ID | String | Y | 用户设备的唯一识别号，可以是mac地址，手机也可以是IMEI，一般不需要传入 |
| OSType | 用户系统类型 | String | Y | 可传入Android、IOS、PC、Other中的任意一个 |
| SugOrientation | 目的地范围 | Int | N | 在哪个范围进行目的地匹配检索。 0-国内 1-国际 2-国内国际混排，国内优先 3-国内国际混排，国际优先 |
响应结果
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| RegionResult | 目的地结果列表 | RegionResult[] | N | 包含多个RegionResult节点 |
RegionResult节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| SugEn | 目的地英文名 | String | N | |
| RegionId | 目的地ID | String | N | 当目的地类型(RegionType字段)是城市时，此处为即hotel.list接口所使用的CityId |
RegionNameCn | 目的地中文名 | String | Y | |
| RegionNameEn | 目的地英文名 | String | Y | 一般为空，请优先使用SugEn |
| ParentId | 父级目的地ID | String | N | 当目的地类型(RegionType字段)是城市时可以忽略本字段，目的地类型为其他类型时，本字段表示该目的地所属的城市ID，即hotel.list接口使用的CityId |
| ParentNameCn | 父级目的地中文名 | String | N | 当目的地类型是城市时本字段表示城市所属省份名称，部分城市（比如直辖市）本字段为空。 当目的地类型为其他类型时，本字段为目的地所属城市的名称。 |
| ParentNameEn | 父级目的地英文名 | String | Y | 一般为空，逻辑和ParentName相同 |
| RegionType | 目的地类型 | Int | N | 0-城市 1-行政区 2-景区 3-商圈 4-酒店 5-地点 6-医院 7-学校 8-景点 9-地铁站 10-机场/车站 12-品牌 13-集团 |
| FilterType | 对应筛选项的类型 | Int | N | 用于hotel.filter接口的入参，获取本目的地对应的筛选项 3-品牌 4-行政区 5-商圈 6-POI(大学、周边游[风景区]、汽车站、火车站、地铁等) |
| FilterId | 对应筛选项的ID | Int | N | |
| SugActInfo | sug标记信息 | String | N | 本目的地的唯一标识，一般不需要关注 |
| Address | POI地址信息 | String | N | 目的地的地址信息描述 |
| ComposedName | 目的地名称 | String | N | sug展示的目的地名称，一般是 RegionNameCn，ParentNameCn |
| RegionShowType | 目的地展示类型 | Int | N | 含义和用法与RegionType相同，使用RegionType即可 |
| SugOrigin | sug类型 | Int | N | 搜索的范围 0-国内 1-国际 |
| BaseAttr | 酒店基本属性 | BaseAttr | Y | 仅在RegionType为4时有效，参考BaseAttr节点 |
RegionResult节点
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| Score | 酒店评分 | String | Y | 满分5分，与艺龙官网的评分相同 |
| MallName | 酒店所属商圈 | String | Y |
输入参数示例
https://api-test.elong.com/rest?timestamp=1490001050&format=json
&method=hotel.destination&signature=d19ce1e910def16453801405581c9d7c
&user={userid}&data={"Version":"1.33","Local":"zh_CN","Request":{"QueryText":"北京饭店"}}输出参数示例
{
"Code": "0",
"Result": {
"regionResult": [
{
"sugEn": "beijing hotel",
"regionId": "50101002",
"regionNameCn": "北京饭店",
"parentId": "0101",
"parentNameCn": "北京",
"regionType": 4,
"composedName": "北京饭店,北京",
"regionShowType": 4,
"sugOrigin": 0,
"baseAttr": {
"score": "4.5分"
},
"filterType": -1,
"filterId": 50101002,
"sugActInfo": "3109294890299507326|jproxy|region|0|0|4"
}
]
},
"Guid": "5e3e79d7-9617-45b6-aab4-63de6bc45986"
}注意事项
本接口返回信息较多，请根据实际情况使用，不要为了使用某个字段而去开发功能。