用途:通过本地 Google Places API 代理搜索附近场所(餐厅、咖啡馆、健身房等),适合需要在本机快速查询地点的场景。
主要能力:提供位置解析、地点搜索和地点详情三个接口。搜索支持 location_bias 经纬度与半径、open_now、min_rating、price_levels 及单一 types 过滤,limit 搜索为 1-20、位置解析为 1-10。返回结果含 place_id、name、address、location、rating、price_level、types、open_now,并可通过 next_page_token 翻页。
使用方式: 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 检查。位置解析使用 POST /locations/resolve,传入 location_text 与 limit;搜索使用 POST /places/search,传入 query、location_bias、filters、limit;详情使用 GET /places/{place_id}。对话流程建议先解析模糊位置、多结果时让用户选择,再带偏好搜索并展示名称、评分、地址和营业状态。
限制:filters.types 只能指定一个类型;price_levels 为 0-4;min_rating 为 0-5 且以 0.5 递增;location_bias.radius_m 必须大于 0。其他功能、收费与平台支持情况暂未提供。