本地地点搜索

技能简介

local-places 是一个基于 Google Places API 的本地代理服务，用于搜索周边地点（餐厅、咖啡馆等）。采用两步流程：先解析位置，再执行搜索，返回包含评分、地址、营业状态等信息的商家列表。

业务背景

帮助业务人员快速定位周边商业资源，解决线下选址、客户拜访、竞品调研等场景中的位置信息需求。通过自然语言描述即可获取精准的商家列表与详细信息，降低人工搜索成本，提升市场拓展效率。

落地案例：某零售品牌拓展经理需在伦敦Soho区寻找潜在合作咖啡馆。输入"Soho, London"后系统自动解析坐标，筛选出评分4.0以上、当前营业的咖啡馆，返回包含地址、电话、营业时间的完整列表。经理可直接导出结果制作拜访计划，无需手动在地图平台逐条查询。

能做什么

• 将模糊位置描述（如”Soho, London”）解析为具体坐标
• 按类型、评分、价格、营业状态筛选附近商家
• 获取商家详细信息（地址、电话、营业时间等）
• 支持分页获取更多结果

使用说明

安装与启动：

1. 进入项目目录：cd {baseDir}
2. 创建环境变量文件：echo "GOOGLE_PLACES_API_KEY=your-key" > .env
3. 创建虚拟环境并安装依赖：uv venv && uv pip install -e ".[dev]"
4. 启动服务：uv run --env-file .env uvicorn local_places.main:app --host 127.0.0.1 --port 8000

验证服务：curl http://127.0.0.1:8000/ping

解析位置：

curl -X POST http://127.0.0.1:8000/locations/resolve \
  -H "Content-Type: application/json" \
  -d '{"location_text": "Soho, London", "limit": 5}'

搜索地点：

curl -X POST http://127.0.0.1:8000/places/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "coffee shop",
    "location_bias": {"lat": 51.5137, "lng": -0.1366, "radius_m": 1000},
    "filters": {"open_now": true, "min_rating": 4.0},
    "limit": 10
  }'

获取详情：curl http://127.0.0.1:8000/places/{place_id}

输入与输出

见下方输入与输出表格。

风险提示

• 需要有效的 GOOGLE_PLACES_API_KEY，否则服务无法调用 Google 接口
• filters.types 仅支持单一类型值，不可多选
• 搜索半径 radius_m 必须大于 0
• next_page_token 有有效期限制，过期后需重新搜索
• 本地服务需保持运行，重启后需重新建立连接

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/local-places/SKILL.md
来源类型：GitHub 仓库