核心用法
Local Places 是一个轻量级的 Google Places API 本地代理服务，采用 FastAPI 构建，提供标准化的 REST 端点完成两类核心任务：地理定位解析（将文本地址如 "Soho, London" 转换为经纬度坐标）和周边场所搜索（基于坐标、关键词、评分、营业状态等条件筛选场所）。
部署流程简洁：配置 GOOGLE_PLACES_API_KEY 环境变量后，通过 uv 工具链安装依赖并启动服务，默认监听 127.0.0.1:8000 仅本地可访问。主要端点包括 /locations/resolve（地址解析）、/places/search（场所搜索）、/places/{place_id}（详情获取），支持分页与严格约束的过滤参数。
显著优点
1. 密钥安全隔离：API Key 仅存储于服务端环境变量，避免暴露于前端或客户端代码
2. 网络层管控：默认绑定 localhost，可配合反向代理实现访问控制与速率限制
3. 标准化接口：屏蔽 Google Places API 原始复杂性，提供统一 JSON 格式与错误处理
4. 轻量依赖：基于 uv 的现代 Python 工具链，安装迅速，适合快速原型与内网部署
潜在缺点与局限性
- 基础设施负担：需自行维护服务运行、SSL 终端、高可用与监控
- 地理覆盖依赖：数据源完全依赖 Google Places，部分区域（如中国大陆）可用性受限
- 成本敞口：Google Places API 按调用量计费，缺乏内置配额管控机制
- 功能边界：仅封装标准搜索与详情接口，不支持照片、评论等高级功能
适合人群
- 需要将 Places API 集成至自托管系统的后端开发者
- 对第三方 API 密钥外泄风险敏感的企业内网场景
- 希望在前端与 Google API 之间增加中间层以实现缓存、日志或业务逻辑定制的团队
常规风险
- 密钥泄露风险：
.env文件权限配置不当或容器镜像层残留可导致密钥暴露 - 服务单点故障：单机部署无集群支持，重启或崩溃期间服务中断
- 合规盲区：未明确处理用户位置数据的 GDPR/隐私合规策略，需自行补充