SuperAPI AI 工具集

local-places

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

用途:通过本地运行的 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。其他收费、平台与效果信息暂未提供。