腾讯地图API技能提供地点搜索、路线规划、逆地理编码等功能，适合中国本地开发者和企业使用，数据覆盖国内 POI 较全面。
说明：
## 核心用法
腾讯地图API技能封装了腾讯位置服务 Web API，提供五大核心功能模块：
1. **地点搜索** — 支持关键词+区域搜索，可分页获取最多 20 条结果/页，支持省市区多级定位
2. **逆地理编码** — 经纬度转详细地址，含行政区划、街道信息
3. **地理编码** — 地址文本转经纬度坐标
4. **路线规划** — 支持驾车、步行、公交三种出行模式的距离与时间估算
5. **周边搜索** — 指定坐标半径范围内搜索 POI，默认半径 3000 米
所有接口通过 Shell 脚本调用，返回标准化 JSON 格式，便于与 Python、Node.js 等工具链集成。
## 显著优点
– **国内数据覆盖好**：腾讯地图在国内 POI 数据更新频率和覆盖度优于部分国际地图服务
– **API 稳定**：腾讯位置服务商用多年，服务可用性较高
– **零额外依赖**：仅需 `curl` 和 `python3`，无需安装 SDK
– **轻量封装**：Shell 脚本直接透传参数，学习成本低
## 潜在缺点与局限性
– **地域限制**：主要覆盖中国大陆，海外数据质量较弱
– **配额依赖**：每日调用次数受限于腾讯云套餐，高并发需付费升级
– **Key 安全风险**：`TENCENT_MAP_KEY` 环境变量若泄露可能导致配额被盗用
– **功能边界**：仅封装基础 API，不含高级功能如实时路况、轨迹纠偏、室内导航等
– **返回格式固定**：部分复杂业务场景需二次处理 JSON
## 适合人群
– 需要快速接入中国本地地图服务的开发者
– 构建位置相关自动化脚本（如物流估算、门店推荐）的工程师
– 内部工具或数据分析场景，对国际地图数据无需求的项目
## 常规风险
– **API Key 泄露**：建议通过密钥管理服务存储，避免硬编码
– **配额超支**：生产环境需监控调用量，设置告警阈值
– **服务迁移成本**：若未来需切换至高德/百度地图，接口逻辑需重写
– **数据合规**：地理位置数据涉及隐私，需符合《个人信息保护法》及《数据安全法》要求
