导入
酒店名称自动补全 API
使用搜索关键词在全球范围内查找酒店。
1https://test.api.amadeus.com/v1/reference-data/locations/hotel
| 参数 | 类型 | 分类 | 描述 |
|---|---|---|---|
| ACCESS_TOKEN | 字符串 | 必填 | 我们的唯一访问令牌 |
| keyword | 字符串 | 必填 | 位置查询关键词 |
| subType | 字符串数组 | 必填 | 搜索类别；可选值为 HOTEL_LEISURE 和 HOTEL_GDS。HOTEL_LEISURE 用于聚合商，HOTEL_GDS 用于直接对接连锁酒店集团。 |
| countryCode | 字符串 | 可选 | 用于搜索的国家代码（2位字符）。注意：请参考附录获取国家代码。 |
| lang | 字符串 | 可选 | 请求结果的语言代码（2位字符）。如果请求的语言不可用，结果将以英语显示。注意：请参考附录获取语言代码。 |
| max | 整数 | 可选 | 请求结果的数量；范围为1到20，默认值为20 |
1// 在此处定义 API 密钥 2const API_KEY = '{{API_KEY}}'; 3const API_SECRET = '{{API_SECRET}}'; 4 5// 在此处定义端点 URL 6const endpointUrl = new URL(`https://test.api.amadeus.com/v1/reference-data/locations/hotel`); 7 8// 在此处定义请求头参数 9const headerParameter = { 10 contentType: 'application/json' 11}; 12 13// 在此处定义查询参数 14const keyword = 'YORK'; 15const subType = 'HOTEL_LEISURE'; 16 17const queryParameters = new URLSearchParams({ 18 keyword: keyword, 19 subType: subType 20}); 21 22// 设置 API 调用选项 23const options = { 24 method: 'GET', 25 headers: headerParameter, 26}; 27 28// 定义发起 API 调用的函数 29async function getHotels() { 30 try { 31 // 在此处定义访问令牌 32 const ACCESS_TOKEN = await getAccessToken(API_KEY, API_SECRET); 33 if (!ACCESS_TOKEN) 34 return; 35 options['headers']['authorization'] = `Bearer ${ACCESS_TOKEN}`; 36 endpointUrl.search = queryParameters; 37 const response = await fetch(endpointUrl, options); 38 // 输出响应结果 39 printResponse(response); 40 } catch (error) { 41 // 输出错误信息 42 printError(error); 43 } 44} 45 46// 调用函数以发起 API 调用 47getHotels();
| 参数 | 类型 | 描述 |
|---|---|---|
| id | 整数 | 响应项的唯一标识符 |
| name | 字符串 | 酒店名称 |
| iataCode | 字符串 | 酒店所在位置的 IATA 代码 |
| type | 字符串 | 响应项的类型 |
| subType | 字符串 | 酒店类别；可选值为 HOTEL_LEISURE 和 HOTEL_GDS |
| relevance | 整数 | 表示输入内容与推荐酒店之间的相似度 |
| hotelIds | 字符串数组 | 包含酒店的唯一标识符 |
| address | 对象 | 包含酒店地址信息，包括 cityName 和 countryCode |
| geoCode | 对象 | 包含酒店位置的地理坐标（纬度和经度） |