通过本地代理安全调用 Google Places API，支持地理定位解析与周边场所搜索，适合注重 API 密钥管控的开发者与隐私敏感用户。
说明：
## 核心用法
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/隐私合规策略，需自行补充
会员专属
