📍 本地地点

查找地点，快速响应

使用本地化的 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。

快速开始

1. 检查服务状态： curl http://127.0.0.1:8000/ping

2. 解析位置：

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

3. 搜索地点：

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
  }'

4. 获取详情：

curl http://127.0.0.1:8000/places/{place_id}

对话流程

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

筛选器约束条件

• 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 参数传入，以获取下一页结果。