用途:通过本地运行的 Google Places API 代理搜索附近商户和兴趣点,适合需要本地地点检索能力的对话或应用场景。
主要能力:采用两步流程,先解析模糊位置,再按条件搜索地点,并可获取单个地点详情。支持按类型、价格等级、最低评分、是否营业中筛选,支持位置偏置与半径,结果含名称、地址、坐标、评分、价格等级、类型和营业状态,并提供分页令牌。
使用方式:在项目目录创建 .env 写入 GOOGLE_PLACES_API_KEY,然后执行 uv venv && uv pip install -e ".[dev]",再运行 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 检查服务;用 POST /locations/resolve 解析位置,用 POST /places/search 搜索,用 GET /places/{place_id} 获取详情。
限制:需要 GOOGLE_PLACES_API_KEY;filters.types 只能指定一个类型;price_levels 为 0-4 整数;min_rating 为 0-5 且以 0.5 递增;limit 搜索为 1-20、解析为 1-10;location_bias.radius_m 必须大于 0。其他收费、平台与效果信息暂未提供。