广州停车助手
概述
广州停车助手 通过微信小程序「广州泊车」平台后端API查询广州停车场信息，包括停车场名称、地址、泊位数、空余车位、收费标准等。当API不可达时（如非广州本地网络），提供腾讯地图POI搜索作为备选方案，并引导用户使用「广州泊车」小程序直接查询。
「广州泊车」是广州市交通运输局建设的全市统一停车信息平台，已接入约4800个停车场、超过220万个泊位。
触发场景
- "帮我查一下天河公园附近的停车场"
- "广州第一人民医院周边有什么停车场"
- "珠江新城附近哪里可以停车"
- "查找荔湾区的停车场"
- "广州琶洲展馆停车场信息"
使用流程
第一步：确定查询方式
根据用户需求选择查询方式：
- 关键词搜索：用户提供了地名、地标或停车场名称 → 使用
--keyword参数 - 定位搜索：用户提供了经纬度坐标 → 使用
--lat+--lon参数 - 无具体参数：引导用户提供搜索关键词或目的地名称
第二步：执行查询脚本
运行 scripts/search_parking.py 进行查询：
# 关键词搜索
python scripts/search_parking.py --keyword "天河公园"
# 定位搜索
python scripts/search_parking.py --lat 23.1291 --lon 113.2644
# 带备选方案（广州泊车API不可达时自动回退到腾讯地图POI）
python scripts/search_parking.py --keyword "珠江新城" --fallback --map-key YOUR_TENCENT_MAP_KEY
# 保存完整JSON结果
python scripts/search_parking.py --keyword "荔湾" --json result.json
# 翻页查询
python scripts/search_parking.py --keyword "天河" --page 2
第三步：处理查询结果
API查询成功时：
- 解析返回的停车场列表，向用户展示名称、地址、泊位数、空余车位、收费标准等信息
- 如有坐标信息，可配合腾讯地图等提供导航建议
- 提醒用户可在微信「广州泊车」小程序中查看实时余位和导航
API查询失败时（网络不可达）：
1. 向用户说明API可能在广州本地网络环境下才可访问
2. 如用户启用了 --fallback 且提供了腾讯地图API Key，使用腾讯地图POI搜索
3. 引导用户直接在微信搜索「广州泊车」小程序查询：
- 打开微信 → 搜索「广州泊车」→ 点击「停车场查询预约」→「车场查询」
- 输入目的地名称查看周边停车场
- 绿色=有空位，蓝色=可预约，灰色=已满
第四步：补充信息
查询 references/guangzhou_parking_platform.md 获取：
- 「广州泊车」平台的详细功能说明和小程序使用指南
- API端点信息和技术参数
- 广州各区停车概况
- 广州停车收费政策要点
- 腾讯地图POI搜索API文档
注意事项
- 网络限制：「广州泊车」API端点（
tcc.jtj.gz.gov.cn）可能在非广州本地网络环境下无法访问。从云端环境执行脚本时，如遇超时，应立即切换到引导用户使用小程序或腾讯地图POI备选方案。 - 数据时效性：API返回的空余车位数据为实时数据，查询结果仅在查询时刻有效。
- API稳定性：旧版IP端点（
219.136.133.163:8000）可能已失效，优先使用域名端点。 - 腾讯地图备选：腾讯地图POI搜索无法提供实时空余车位和收费标准，仅提供停车场基础信息（名称、地址、电话、坐标）。
- 编码处理：脚本已内置Windows UTF-8编码修复，在Windows环境下直接运行即可。
资源文件
scripts/search_parking.py
停车场查询脚本，支持：
- 关键词搜索和经纬度定位搜索
- 多API端点自动回退（广州泊车主站 → 旧版IP）
- 腾讯地图POI搜索备选方案
- JSON结果导出
- Windows UTF-8编码兼容
references/guangzhou_parking_platform.md
「广州泊车」平台完整参考文档，包含：
- 平台概述和核心数据
- 小程序使用指南
- API端点信息和参数说明
- 广州停车政策要点
- 各区停车概况
- 腾讯地图POI搜索API文档
- 相关链接
