腾讯位置服务 WebService API 工具与微信小程序 LBS 指南。Use for: (1) 用附带的零依赖 CLI 查地理编码/POI/路线/IP定位, (2) 微信小程序地图开发（腾讯地图是微信官方推荐）, (3) GCJ-02 坐标系避坑。Tencent Maps WebService API CL...
腾讯位置服务 Skill
功能概述
腾讯位置服务 Skill是一项面向实际任务的技能，主要用于附带零依赖 CLI（ scripts/qqmap.py ，仅 Python 标准库）；腾讯地图的；
核心要点
- 核心优势场景是 微信小程序 ——微信官方推荐，坐标系同为 GCJ-02；
- 小程序 map 组件无缝配合；
- 脚本行为声明：仅请求 apis.map.qq.com ，不读写本地文件；
使用与执行
geocode <地址>；地址 → 坐标；regeo <lat,lng>。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
结果检查与注意事项
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
腾讯位置服务 Skill
附带零依赖 CLI（scripts/qqmap.py，仅 Python 标准库）。腾讯地图的
核心优势场景是微信小程序——微信官方推荐，坐标系同为 GCJ-02，
小程序 map 组件无缝配合。
快速开始
# lbs.qq.com 免费申请 Key，启用 WebServiceAPI export QQMAP_KEY=你的key python3 scripts/qqmap.py geocode "北京市海淀区中关村" python3 scripts/qqmap.py search 咖啡 北京 python3 scripts/qqmap.py driving 39.984154,116.307490 39.90816,116.434446
脚本行为声明：仅请求 apis.map.qq.com，不读写本地文件。
命令手册
| 命令 | 作用 |
|---|---|
geocode <地址> |
地址 → 坐标 |
regeo |
坐标 → 结构化地址 |
search <关键词> <城市> |
POI 搜索 |
suggestion <关键词> <城市> |
输入联想（做搜索框补全） |
driving / walking <起点> <终点> |
路线规划 |
ip [地址] |
IP 定位 |
call |
通用兜底：调任意 /ws/ 接口 |
⚠️ 坐标顺序陷阱：腾讯地图是 纬度,经度（lat,lng），
与高德的 经度,纬度（lng,lat）相反。跨平台迁移最容易在这里翻车——
症状是坐标点跑到完全不相关的地方（不是偏移几百米，是差出几千公里）。
微信小程序 LBS 要点（腾讯地图主场）
- 选型：小程序内嵌地图只能用 map 组件（腾讯地图内核）， 配套 API 用腾讯位置服务是阻力最小路径
- 域名白名单：小程序后台把
https://apis.map.qq.com加入 request 合法域名，否则真机必挂（开发者工具不校验，最易漏） - 小程序 SDK：官方提供
qqmap-wx-jssdk，封装了本 skill 同款 WebService 接口 - 用户定位授权：
wx.getLocation需在 app.json 声明requiredPrivateInfos并配置隐私协议，审核收紧后未声明直接拒审
Agent 典型用法
- 小程序开发排障：真机地图接口失败 → 按序查域名白名单、Key 的 WebServiceAPI 是否启用、Key 是否绑定了小程序 AppID 校验
- 找地点：
geocode+search组合，结果按距离整理 - 搜索框补全：
suggestion接口做输入联想数据源
高频错误码（实测）
| status | 含义 | 处理 |
|---|---|---|
| 311 | Key 格式错误 | 检查 Key 拼写 |
| 306 | 请求有护网校验/签名错误 | 控制台开了 SK 签名就必须算 sig |
| 301 | 缺少必要参数 | 对照文档补参数 |
| 120x | 配额/QPS 超限 | 免费版每接口日配额独立计算，次日重置 |
签名说明：控制台启用 SK 后，sig=md5(路径?按key排序的参数&sk=SECRET)，
本脚本未内置签名，启用 SK 的 Key 请用 call 前自行关闭或换 Key。
与其他平台对比
微信小程序 → 腾讯（本 skill）；导航/车机 → 高德（gaode skill）；
百度系集成/全景 → 百度（baidu-map skill）。坐标系迁移见各 skill
的坐标系章节，腾讯↔高德同为 GCJ-02 可直接互用。
本 skill 不做什么
- 不含 JavaScript API GL（前端渲染）细节，只覆盖服务端 WebService
- 不提供绕过配额或反爬的方法
相关专题
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集，涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案，助你快速定位并解决Uvicorn运行中的各类问题。
2026.11.02
0
14
本专题汇总了Uvicorn使用教程与启动运行指南，涵盖其作为Python ASGI服务器的定位与特点，以及命令行启动（uvicorn main:app --reload）、参数配置（host/port/workers）、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧，助你快速掌握Uvicorn的运行与配置。
2026.11.02
0
17
本专题汇总了Uvicorn的安装配置教程与部署指南，涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载（--reload）及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧，助你快速完成Uvicorn服务的安装与上线部署。
2026.11.02
0
17
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章