✈️ Short Stay Itinerary Generator API

Generate optimized plans for travelers with limited time.

原始信息汇总

✈️ Short Stay Itinerary Generator API 数据集概述

基本信息

• API名称: Short Stay Itinerary Generator API
• 提供者: LayoverLink (由 William Hall 创建)
• 类别: Travel
• 当前版本: 2.0.0
• 基础端点: POST /api/v1/short-stay-plan
• 服务等级: 86%
• 平均延迟: 2646ms

功能描述

LayoverLink Travel Planning API 旨在帮助机组人员和旅客充分利用短暂的中转停留时间。该 API 根据给定的城市和可用时间（以分钟为单位），生成一个经过精心策划、时间优化的计划，其中包含根据您的精力水平和一天中的时间量身定制的本地推荐。

核心特性

• 时间优化计划: 每项推荐都考虑您可用的中转时间（30分钟至24小时）。
• 能量感知: 可请求低能量选项（咖啡馆、公园、休息室）或高能量活动（观光、夜生活、冒险）。
• 日间和夜间模式: 无论您在早上6点还是晚上10点抵达，都能获得相关建议。
• 快速响应: 结果缓存6小时，重复查询可即时返回。
• 专为机组人员设计: 由了解在新城市只有4小时停留体验的机组人员设计和提供。

使用示例

• 在波特兰有3小时中转的飞行员，寻找快速午餐和咖啡点。
• 夜间抵达芝加哥的乘务员，想要低调的酒吧推荐。
• 在丹佛有6小时转机的旅客，寻找冒险活动。
• 希望提供中转计划功能的旅行应用程序。

请求参数

参数名	类型	是否必需	描述	默认值/范围
city	string	是	城市名称（至少2个字符）	全球任意城市
minutes_available	number	是	可用时间（分钟）	30 至 1440
energy_level	string	否	能量等级	"low", "medium", "high" (默认: "medium")
time_of_day	string	否	一天中的时段	"day" 或 "night" (默认: "day")

参数指南

• energy_level:
  • low — 咖啡馆、公园、休息室、书店。长途飞行后疲惫时的理想选择。
  • medium — 餐厅、当地市场、博物馆、休闲观光。平衡的组合。
  • high — 冒险活动、夜生活、徒步旅行、户外短途旅行。适合准备出发时。
• minutes_available 建议:
  • 30–60 分钟 — 快速喝咖啡、购买当地特产、伸展双腿。
  • 60–180 分钟 — 坐下来用餐、参观附近地标、短途徒步旅行。
  • 180–360 分钟 — 完整的观光游览、多站美食之旅、参观博物馆。
  • 360–1440 分钟 — 扩展探索、一日游、多个街区。

响应头信息

每个响应都包含以下头部信息：

头部	描述
X-Cache	如果从缓存提供则为 HIT，如果新生成则为 MISS。
X-RateLimit-Limit	每个时间窗口允许的最大请求数。
X-RateLimit-Remaining	当前时间窗口中剩余的请求数。

结果缓存6小时。在该时间窗口内的相同请求将立即返回，并带有 X-Cache: HIT。

错误处理

状态码	含义	处理建议
400	参数无效	检查城市是否至少2个字符，且 minutes_available 在30到1440之间。
401	API密钥缺失或无效	验证您的 x-rapidapi-key 头部。
429	超出速率限制	等待 Retry-After 头部中指定的秒数。
502	上游服务错误	我们的规划引擎暂时不可用 — 几秒钟后重试。
504	请求超时	请求耗时过长 — 请重试或简化请求。

订阅计划与速率限制

计划	每日请求数	价格
Free	10	$0.00 / 月
Basic	500	$9.00 / 月
Pro	5,000	$29.00 / 月

支持信息

• 网站: https://layoverlink.org
• 联系: https://layoverlink.org/contact

搜集汇总

背景与挑战

背景概述

该API数据集旨在为短期停留的旅行者提供优化的行程规划方案，特别适合时间有限的出行场景。