本地代理调用 Google 地点服务

通过本地代理安全调用 Google Places API，支持地理定位解析与周边场所搜索，适合注重 API 密钥管控的开发者与隐私敏感用户。

基本信息

• 技能名称?Local Places
• 中文名称?本地代理调用 Google 地点服务
• 作者?steipete
• 分类?其他
• 版本?1.0.0
• 标签?geolocation, api-proxy, local-server, google-places, privacy, fastapi

使用方法

使用说明
核心用法
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/隐私合规策略，需自行补充