导入
兴趣点 API
学习如何找到某个地点的最佳游览场所。
1https://test.api.amadeus.com/v1/reference-data/locations/pois
| 参数 | 类型 | 分类 | 描述 |
|---|---|---|---|
| ACCESS_TOKEN | 字符串 | 必填 | 我们的唯一访问令牌 |
| latitude | 十进制数 | 必填 | 给定位置的地理坐标(纬度) |
| longitude | 十进制数 | 必填 | 给定位置的地理坐标(经度) |
| radius | 整数 | 可选 | 搜索半径,单位为千米;取值范围为 0 到 20,默认值为 1 |
| page[limit] | 整数 | 可选 | 每页最大项目数量;默认值为 10 |
| page[offset] | 整数 | 可选 | 请求页面的起始索引;默认值为 0 |
| categories | 字符串数组 | 可选 | 用逗号分隔的位置类别列表;可能的值包括 SIGHTS、NIGHTLIFE、RESTAURANT 和 SHOPPING |
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/pois`); 7 8// 在此处定义请求头参数 9const headerParameter = { 10 contentType: 'application/json' 11}; 12 13// 在此处定义查询参数 14const latitude = 40.7448170; 15const longitude = -74.0005255; 16 17const queryParameters = new URLSearchParams({ 18 latitude: latitude.toString(), 19 longitude: longitude.toString() 20}); 21 22// 设置 API 调用选项 23const options = { 24 method: 'GET', 25 headers: headerParameter, 26}; 27 28// 用于发起 API 调用的函数 29async function getTouristSpots() { 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 调用 47getTouristSpots();
| 参数 | 类型 | 描述 |
|---|---|---|
| id | 字符串 | 响应项的唯一标识符 |
| type | 字符串 | 响应项的类型;可能值为 location |
| subType | 字符串 | 位置的类型;可能值包括 AIRPORT、CITY、POINT_OF_INTEREST 和 DISTRICT |
| self.href | 字符串 | 响应项的 URL |
| self.methods | 字符串数组 | 包含对响应项 URL 支持的操作方法;可能值为 GET、PUT、DELETE、POST 和 PATCH |
| name | 字符串 | 推荐位置的名称 |
| category | 字符串 | 推荐位置的类别;可能值包括 SIGHTS、BEACH_PARK、HISTORICAL、NIGHTLIFE、RESTAURANT 和 SHOPPING |
| rank | 整数 | 推荐位置与其他位置相比的排名;最高值为 1 |
| geoCode | 对象 | 包含推荐位置的地理坐标(纬度和经度) |
| tags | 字符串数组 | 包含与推荐位置相关的标签 |