Event Planner
Plan events by searching venues and generating itineraries with Google Maps links.
Quick Start
Plan a night out:
CODEBLOCK0
Plan a weekend day:
CODEBLOCK1
Plan a date night:
CODEBLOCK2
Event Types
- - night-out: Dinner + 1-2 bars/lounges (3-4 hours)
- weekend-day: Brunch/lunch + activity + dinner (6-8 hours)
- date-night: Romantic restaurant + dessert/drinks spot (2-3 hours)
- team-event: Group activity + dinner venue (3-5 hours)
- lunch: Single restaurant recommendation
- dinner: Single restaurant recommendation
- trip: Multi-day itinerary with daily plans
Parameters
- -
--location: City, address, or landmark (required) - INLINECODE1 : Number of people (default: 2)
- INLINECODE2 : "low/medium/high" or "$X per person" (default: medium)
- INLINECODE3 : Hours available (e.g., "3h", "full day")
- INLINECODE4 : Comma-separated (e.g., "vegetarian, outdoor seating, live music")
- INLINECODE5 : When to start (default: inferred from event type)
- INLINECODE6 : text|json (default: text)
- INLINECODE7 : Target date in YYYY-MM-DD format for day-specific checks (default: today)
Output Format
Default (text): Markdown itinerary with timeline, venue details, travel info, and Google Maps link
JSON: Structured data with all venue details, coordinates, and parsed metadata
Limitations
- - API limits: Google Places API has usage quotas (check your billing)
- Real-time data: Venue hours may change; always confirm before going
- Budget estimates: Based on Google's price level (0-4), not exact costs
- Travel times: Uses Google Directions API when available; falls back to distance-based estimates with 30% buffer
- Opening hours: Places without verified hours will show warnings; do not assume availability
- Event venues: Cultural centers, theaters, and event spaces may have variable hours depending on scheduled events
API Requirements
The event planner uses:
- - Google Places API (New): Required for venue search
- Google Directions API: Optional but recommended for accurate travel times
Both APIs can use the same GOOGLE_PLACES_API_KEY if enabled in Google Cloud Console.
Error Handling
- - Invalid location → Returns error with suggestions
- No venues found → Relaxes filters and retries
- API failures → Retry with exponential backoff (3 attempts)
活动策划师
通过搜索场地并生成包含谷歌地图链接的行程来策划活动。
快速开始
策划一个夜晚外出活动：
bash
uv run {baseDir}/scripts/plan_event.py 夜晚外出 \
--location 纽约时代广场 \
--party-size 4 \
--budget medium \
--duration 4h
策划一个周末白天活动：
bash
uv run {baseDir}/scripts/plan_event.py 周末白天 \
--location 纽约中央公园 \
--party-size 2 \
--budget 每人100美元 \
--preferences 户外, 休闲餐饮
策划一个约会之夜：
bash
uv run {baseDir}/scripts/plan_event.py 约会之夜 \
--location 纽约苏豪区 \
--budget high \
--duration 3h
活动类型
- - 夜晚外出：晚餐 + 1-2家酒吧/酒廊（3-4小时）
- 周末白天：早午餐/午餐 + 活动 + 晚餐（6-8小时）
- 约会之夜：浪漫餐厅 + 甜品/饮品场所（2-3小时）
- 团队活动：团体活动 + 晚餐场地（3-5小时）
- 午餐：单一餐厅推荐
- 晚餐：单一餐厅推荐
- 旅行：含每日计划的多日行程
参数
- - --location：城市、地址或地标（必填）
- --party-size：人数（默认：2）
- --budget：低/中/高或每人$X（默认：中）
- --duration：可用小时数（例如：3h, 全天）
- --preferences：逗号分隔（例如：素食, 户外座位, 现场音乐）
- --start-time：开始时间（默认：根据活动类型推断）
- --output：text|json（默认：text）
- --date：目标日期，格式为YYYY-MM-DD，用于特定日期的检查（默认：今天）
输出格式
默认（文本）：包含时间线、场地详情、交通信息和谷歌地图链接的Markdown行程
JSON：包含所有场地详情、坐标和解析元数据的结构化数据
限制
- - API限制：Google Places API有使用配额（请查看您的账单）
- 实时数据：场地营业时间可能变更；请务必在前往前确认
- 预算估算：基于Google的价格等级（0-4），非精确费用
- 交通时间：尽可能使用Google Directions API；否则使用基于距离的估算并增加30%缓冲
- 营业时间：未经核实的营业时间的场所将显示警告；请勿假定其可用性
- 活动场地：文化中心、剧院和活动空间的营业时间可能因预定活动而变化
API要求
活动策划师使用：
- - Google Places API（新版）：用于场地搜索（必需）
- Google Directions API：用于精确交通时间（可选但推荐）
如果在Google Cloud Console中启用，两个API可以使用同一个GOOGLEPLACESAPI_KEY。
错误处理
- - 无效位置 → 返回错误并附带建议
- 未找到场地 → 放宽筛选条件并重试
- API故障 → 使用指数退避重试（3次尝试）
