📍 本地地点

查找地点，快速前往

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

需要GOOGLE_PLACES_API_KEY在.env文件或环境变量中。

快速开始

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. 使用所选位置的位置偏好进行搜索
5. 展示结果时包含名称、评分、地址、营业状态
6. 提供获取详细信息或优化搜索的建议

筛选条件

• 筛选器.类型：仅限一种类型（例如："餐厅"、"咖啡馆"、"健身房"）
• 筛选器.价格等级：整数0-4（0=免费，4=非常昂贵）
• 筛选器.最低评分：0-5，以0.5为增量
• 筛选器.当前营业：布尔值
• 限制数量：搜索时为1-20，解析时为1-10
• 位置偏差.半径（米）：必须大于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": "..." 
}

使用下一页令牌作为页面令牌在后续请求中获取更多结果。