Local Places_知识管理 skill-PHP中文网

Local Places

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过本地 Google Places API 代理搜索餐厅、咖啡馆等地点。

QQ 本地位点

功能概述

QQ 本地位点是一项面向实际任务的技能，主要用于寻找位置, 快去；使用本地 Google 位置 API 代理搜索附近位置；

核心要点

两步流程: 先解决位置, 然后再搜索；
Setup.；
Requires GOGLE PLACES API KEY in .en。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

📍 本地地点

查找地点，快速响应

使用本地化的 Google Places API 代理搜索周边地点。采用两步流程：先解析位置，再执行地点搜索。

配置

cd {baseDir}
echo "GOOGLE_PLACES_API_KEY=your-key" > .env
uv venv && uv pip install -e ".[dev]"
uv run --env-file .env uvicorn local_places.main:app --host 127.0.0.1 --port 8000

需在 .env 文件或系统环境变量中提供 GOOGLE_PLACES_API_KEY。

快速开始

检查服务状态： 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}

对话流程

若用户说“附近”或提供模糊位置 → 首先解析该位置
若解析结果为多个 → 展示编号列表，并请用户选择其一
询问用户偏好：地点类型、是否营业中、最低评分、价格等级等
使用所选位置的 location_bias 参数发起搜索
向用户呈现结果，包含名称、评分、地址、营业状态等信息
提供进一步操作选项：获取详情或优化搜索条件

筛选器约束条件

filters.types：仅支持**单一类型**（例如 "restaurant"、"cafe"、"gym"）
filters.price_levels：整数，取值范围为 0–4（0 表示免费，4 表示极高消费）
filters.min_rating：取值范围为 0–5，以 0.5 为步进（如 3.5、4.0 等）
filters.open_now：布尔值
limit：搜索请求中取值范围为 1–20；位置解析请求中取值范围为 1–10
location_bias.radius_m：必须大于 0

响应格式

{
  "results": [
    {
      "place_id": "ChIJ...",
      "name": "Coffee Shop",
      "address": "123 Main St",
      "location": {"lat": 51.5, "lng": -0.1},
      "rating": 4.6,
      "price_level": 2,
      "types": ["cafe", "food"],
      "open_now": true
    }
  ],
  "next_page_token": "..." 
}

后续请求中可将 next_page_token 作为 page_token 参数传入，以获取下一页结果。