获取邮轮目的地参考位置列表
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →通过 GET 请求获取邮轮位置参考列表,该接口没有专属参数。所提供的 HTTP 200 源示例包含一个 data 数组,其中每一项都有数值型 destinationId 与 locationId 字段以及字符串 name。外层结构还包含布尔型 status、字符串 message 和数值型 timestamp;示例中 status 为 true、message 为 Success,但没有说明 timestamp 的单位。Caribbean、Bahamas 等标签仅用来说明返回的目的地参考类型,并不代表覆盖范围有保证。该操作没有已保存的探测调用,所以这些只是源示例字段,而非实际执行结果,字段是否必填也未验证。请分别保留 destinationId 与 locationId,二者是否可互换、能否用于其他接口均未确立。该列表没有记录航次、出发港口、坐标、船票价格或预订可订状态。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/get-cruises-location 无需参数,点击查询即可调用 API。
API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-cruises-location?key=<API_KEY>'
查询结果
使用场景
- 在确认响应结构后,用返回的 name 填充邮轮地区选择器,并在每个标签背后同时保留两个标识字段。
- 为旅游内容编辑维护一份标注日期、经过审核的邮轮目的地标签快照,但不声称存在可订航次。
- 对比前后多次的位置列表快照,标出新增、移除或改名的目的地参考,供人工目录审核使用。
- 导出包含 destinationId、locationId 和 name 的邮轮地区对照表,并让它与港口、出发地数据库保持分离。
常见问题
可以按输入的目的地名称搜索邮轮位置吗?
该操作没有声明目的地文本参数,它获取的是不带专属输入的参考列表。客户端可以自行检查返回的名称,但这里并未记录服务端的文字搜索能力。
每个邮轮目的地由哪些字段描述?
源示例把目的地记录放在 data 中,每一项有数值型 destinationId、数值型 locationId 和字符串 name。这些字段仅有示例作为依据,尚未在该操作的已保存探测中观察到。
destinationId 和 locationId 可以互换使用吗?
示例把它们作为两个独立字段给出,也没有任何规则说明二者相等。请按原字段名分别保留,并在其中任一标识用于其他请求之前,先核对接收端接口的约定。
这个列表里的 status、message 和 timestamp 是什么意思?
源示例在 data 之外带有布尔型 status(值为 true)、字符串 message(值为 Success)和数值型 timestamp。它没有确定 timestamp 的单位,也不保证数据新鲜度。这属于文档化的示例行为,而不是已保存的探测结果。
列表里出现某个地区,是否表示现在有前往该地的邮轮航次?
不是。所提供的证据只描述目的地参考记录,没有显示出发信息、港口坐标、航次日期、库存或票价,示例中的标签也不保证覆盖完整或数据最新。