{"id":"edd703c8-8b40-4dd1-8e69-9285fdf35012","entityType":"agent","slug":"clawhub-tencent-adm-tencentmap-map-assistant-skill","name":"tencentmap-map-assistant","canonicalUrl":"https://www.xpersona.co/agent/clawhub-tencent-adm-tencentmap-map-assistant-skill","canonicalPath":"/agent/clawhub-tencent-adm-tencentmap-map-assistant-skill","generatedAt":"2026-10-11T03:54:57.629Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:52:57.656Z","emptyReason":null},"description":"腾讯地图·地图助手 Skill，一句自然语言调用腾讯地图全套能力，开箱即用。提供 AI 旅游攻略、地点搜索（含评分/人均/营业时间）、关键词提示、路线规划（驾车/步行/公交/骑行）、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询，并可将行程或多 POI 渲染成网页地图或生成腾讯地图小程序指南。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencentmap-map-assistant-skill","sourceUrl":"https://clawhub.ai/tencent-adm/tencentmap-map-assistant-skill","homepage":"https://clawhub.ai/tencent-adm/skills/tencentmap-map-assistant-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/tencent-adm/tencentmap-map-assistant-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/tencent-adm/skills/tencentmap-map-assistant-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"tencentmap-map-assistant technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:52:57.656Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:52:57.656Z","emptyReason":null},"stars":null,"forks":null,"downloads":1214,"packageName":null,"latestVersion":"1.5.2","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:52:57.578Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T00:52:57.656Z","lastCrawledAt":"2026-10-11T00:52:57.578Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T00:52:57.578Z","lastVerifiedAt":null,"highlights":[{"version":"1.5.2","createdAt":"2026-08-12T08:01:52.517Z","changelog":"tencentmap-map-assistant-skill v1.5.2 - Improved Key 管理: Now supports a prioritized pool of saved Keys, automatic failover, and user notification on Key switching or all-Key failure, with detailed error reporting. - Updated documentation, especially SKILL.md, to reflect the enhanced Key management logic and user guidance for troubleshooting. - Added new JSAPI demo references to assist with map visualization. - Removed outdated QR code images and the obsolete skill-card.md for clarity and maintainability. - General documentation refinements to reflect these changes.","fileCount":228,"zipByteSize":461167},{"version":"1.5.1","createdAt":"2026-08-03T06:30:21.723Z","changelog":"v1.5.1 版本更新","fileCount":229,"zipByteSize":584051},{"version":"1.0.3","createdAt":"2026-07-09T07:18:51.650Z","changelog":"- 更新 Skill 版本至 1.4.8，完善文档细节说明 - 移除 skill-card.md，调整文档结构 - 修改 README.md 与 SKILL.md，优化官网链接描述及部分表述 - 新增脚本编译产物（__pycache__），无业务逻辑变更","fileCount":223,"zipByteSize":442127},{"version":"1.0.2","createdAt":"2026-07-02T07:28:08.531Z","changelog":"- Added Key detection and guided user flow for applying/using temp/official keys; outputs step-by-step options when Key is missing - Introduced new scripts: create_key.py, save_config.py, send_code.py, and a user-facing tempkey-guide.md for streamlined Key management - Updated usage instructions and documentation to clarify required data mapping and key handling, especially for generate_map_guide - Improved sample code and agent operation notes for more reliable POI data and end-to-end flow - Removed skill-card.md; internal references and guides adjusted for new key flow and experience consistency - Bumped version to 1.4.7","fileCount":222,"zipByteSize":417681},{"version":"1.0.1","createdAt":"2026-06-22T07:52:45.366Z","changelog":"- Updated to version 1.4.5 with an enhanced SKILL.md. - Added detailed documentation covering all supported features and usage examples. - New sections provide parameters, return values, and sample code for each method. - Clarified instructions for key configuration, result visualization, and integration with Tencent Map mini programs. - Improved guidance for out-of-the-box use, with or without a developer key.","fileCount":218,"zipByteSize":408649}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencentmap-map-assistant-skill","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s171cxjdnjyqjxa91pj2bfmr6x83gyg1:tencentmap-map-assistant-skill` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/tencent-adm/tencentmap-map-assistant-skill before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T03:54:57.625Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-tencent-adm-tencentmap-map-assistant-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:52:57.656Z","emptyReason":null},"readme":"Skill: tencentmap-map-assistant\n\nOwner: tencent-adm\n\nSummary: 腾讯地图·地图助手 Skill，一句自然语言调用腾讯地图全套能力，开箱即用。提供 AI 旅游攻略、地点搜索（含评分/人均/营业时间）、关键词提示、路线规划（驾车/步行/公交/骑行）、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询，并可将行程或多 POI 渲染成网页地图或生成腾讯地图小程序指南。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。\n\nTags: latest:1.5.2\n\nVersion history:\n\nv1.5.2 | 2026-08-12T08:01:52.517Z | auto\n\ntencentmap-map-assistant-skill v1.5.2\n\n- Improved Key 管理: Now supports a prioritized pool of saved Keys, automatic failover, and user notification on Key switching or all-Key failure, with detailed error reporting.\n- Updated documentation, especially SKILL.md, to reflect the enhanced Key management logic and user guidance for troubleshooting.\n- Added new JSAPI demo references to assist with map visualization.\n- Removed outdated QR code images and the obsolete skill-card.md for clarity and maintainability.\n- General documentation refinements to reflect these changes.\n\nv1.5.1 | 2026-08-03T06:30:21.723Z | user\n\nv1.5.1 版本更新\n\nv1.0.3 | 2026-07-09T07:18:51.650Z | auto\n\n- 更新 Skill 版本至 1.4.8，完善文档细节说明\n- 移除 skill-card.md，调整文档结构\n- 修改 README.md 与 SKILL.md，优化官网链接描述及部分表述\n- 新增脚本编译产物（__pycache__），无业务逻辑变更\n\nv1.0.2 | 2026-07-02T07:28:08.531Z | auto\n\n- Added Key detection and guided user flow for applying/using temp/official keys; outputs step-by-step options when Key is missing\n- Introduced new scripts: create_key.py, save_config.py, send_code.py, and a user-facing tempkey-guide.md for streamlined Key management\n- Updated usage instructions and documentation to clarify required data mapping and key handling, especially for generate_map_guide\n- Improved sample code and agent operation notes for more reliable POI data and end-to-end flow\n- Removed skill-card.md; internal references and guides adjusted for new key flow and experience consistency\n- Bumped version to 1.4.7\n\nv1.0.1 | 2026-06-22T07:52:45.366Z | auto\n\n- Updated to version 1.4.5 with an enhanced SKILL.md.\n- Added detailed documentation covering all supported features and usage examples.\n- New sections provide parameters, return values, and sample code for each method.\n- Clarified instructions for key configuration, result visualization, and integration with Tencent Map mini programs.\n- Improved guidance for out-of-the-box use, with or without a developer key.\n\nArchive index:\n\nArchive v1.5.2: 228 files, 461167 bytes\n\nFiles: README.md (9177b), references/agent-notes.md (7886b), references/api_reference.md (14209b), references/error-codes.md (2152b), references/jsapi-guide/jsapigl/demos/个性化地图_切换地图个性化样式.html (1535b), references/jsapi-guide/jsapigl/demos/个性化地图_玉露(绿色系活泼风格).html (933b), references/jsapi-guide/jsapigl/demos/个性化地图_墨渊(夜间模式效果).html (949b), references/jsapi-guide/jsapigl/demos/信息窗口_信息窗口偏移设置.html (3542b), references/jsapi-guide/jsapigl/demos/信息窗口_包含图文信息的信息窗口.html (1251b), references/jsapi-guide/jsapigl/demos/信息窗口_拖拽信息窗口.html (6678b), references/jsapi-guide/jsapigl/demos/信息窗口_点击标记弹出信息窗口.html (2746b), references/jsapi-guide/jsapigl/demos/信息窗口_简单信息窗口.html (1201b), references/jsapi-guide/jsapigl/demos/信息窗口_自定义信息窗体.html (5685b), references/jsapi-guide/jsapigl/demos/几何计算库_判断多边形是否在另一个多边形内.html (4355b), references/jsapi-guide/jsapigl/demos/几何计算库_判断点与多边形的关系.html (3263b), references/jsapi-guide/jsapigl/demos/几何计算库_判断点是否在多边形边上.html (3223b), references/jsapi-guide/jsapigl/demos/几何计算库_计算区域面积.html (2215b), references/jsapi-guide/jsapigl/demos/几何计算库_计算多边形形心.html (2904b), references/jsapi-guide/jsapigl/demos/几何计算库_计算多边形的交集区域.html (5198b), references/jsapi-guide/jsapigl/demos/几何计算库_计算线上距离P点最近的点.html (3016b), references/jsapi-guide/jsapigl/demos/几何计算库_计算线与多边形是否相交.html (3887b), references/jsapi-guide/jsapigl/demos/几何计算库_计算路径距离.html (2103b), references/jsapi-guide/jsapigl/demos/几何计算库_路径顺逆时针判断与转换.html (4177b), references/jsapi-guide/jsapigl/demos/地图叠加图层_WMS标准图层.html (1736b), references/jsapi-guide/jsapigl/demos/地图叠加图层_自定义贴地图层.html (4301b), references/jsapi-guide/jsapigl/demos/地图叠加图层_静态图贴地图层.html (1289b), references/jsapi-guide/jsapigl/demos/地图操作示例_2D_3D模式切换.html (1498b), references/jsapi-guide/jsapigl/demos/地图操作示例_切换底图类型.html (1518b), references/jsapi-guide/jsapigl/demos/地图操作示例_创建地图.html (1138b), references/jsapi-guide/jsapigl/demos/地图操作示例_区域高亮.html (2798b), references/jsapi-guide/jsapigl/demos/地图操作示例_卫星地图.html (1130b), references/jsapi-guide/jsapigl/demos/地图操作示例_同时加载两个地图.html (1289b), references/jsapi-guide/jsapigl/demos/地图操作示例_地图加载完成事件.html (1408b), references/jsapi-guide/jsapigl/demos/地图操作示例_地图导出图片.html (2775b), references/jsapi-guide/jsapigl/demos/地图操作示例_地图平滑变化至指定状态.html (1089b), references/jsapi-guide/jsapigl/demos/地图操作示例_地图平移.html (1991b), references/jsapi-guide/jsapigl/demos/地图操作示例_地图设置缩放焦点.html (1613b), references/jsapi-guide/jsapigl/demos/地图操作示例_天空盒.html (3735b), references/jsapi-guide/jsapigl/demos/地图操作示例_实时路况.html (2309b), references/jsapi-guide/jsapigl/demos/地图操作示例_异步加载地图.html (1230b), references/jsapi-guide/jsapigl/demos/地图操作示例_点击地图拾取POI.html (1412b), references/jsapi-guide/jsapigl/demos/地图操作示例_点击地图拾取坐标.html (1574b), references/jsapi-guide/jsapigl/demos/地图操作示例_粒子路况.html (1459b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置_获取地图中心.html (2142b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置_获取地图显示范围.html (2985b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置_获取地图视角.html (2689b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置地图中心点偏移.html (1812b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置地图显示比例.html (1563b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置地图边界范围.html (1482b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置控件位置及样式.html (4100b), references/jsapi-guide/jsapigl/demos/地图操作示例_设置鼠标样式.html (2746b), references/jsapi-guide/jsapigl/demos/地图操作示例_调整图层顺序.html (3053b), references/jsapi-guide/jsapigl/demos/地图操作示例_配置矢量底图.html (5369b), references/jsapi-guide/jsapigl/demos/地图操作示例_销毁地图.html (1708b), references/jsapi-guide/jsapigl/demos/地图操作示例.md (61096b), references/jsapi-guide/jsapigl/demos/城市漫游_地面漫游.html (4509b), references/jsapi-guide/jsapigl/demos/城市漫游_空中漫游.html (4587b), references/jsapi-guide/jsapigl/demos/城市漫游_绕点环绕.html (2384b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_多边形拔起_3D棱柱.html (2245b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_多边形点击事件.html (5002b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_多边形选中高亮显示.html (9726b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_多边形飞地.html (3279b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_带飞地的区域实现高亮.html (3688b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_环形(带洞)多边形.html (2319b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_简单圆形.html (1276b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_简单多边形.html (1985b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_自定义多边形样式.html (3271b), references/jsapi-guide/jsapigl/demos/多边形&3D棱柱_自定义边线样式.html (2507b), references/jsapi-guide/jsapigl/demos/应用工具_开关编辑器键盘事件.html (8473b), references/jsapi-guide/jsapigl/demos/应用工具_测量工具.html (4174b), references/jsapi-guide/jsapigl/demos/应用工具_绘制几何图形.html (6296b), references/jsapi-guide/jsapigl/demos/应用工具_编辑几何图形.html (4853b), references/jsapi-guide/jsapigl/demos/应用工具_编辑器的禁用和启用.html (2468b), references/jsapi-guide/jsapigl/demos/应用工具_设置编辑点为GL模式.html (4418b), references/jsapi-guide/jsapigl/demos/折线_折线-动态箭头.html (2270b), references/jsapi-guide/jsapigl/demos/折线_折线-大圆航线.html (1340b), references/jsapi-guide/jsapigl/demos/折线_折线-彩虹线.html (2868b), references/jsapi-guide/jsapigl/demos/折线_折线-虚线样式.html (2188b), references/jsapi-guide/jsapigl/demos/折线_折线应用_路线规划.html (3570b), references/jsapi-guide/jsapigl/demos/折线_折线样式自定义.html (3619b)\n\nFile v1.5.2:SKILL.md\n\n---\nname: tencentmap-map-assistant-skill\ndescription: \"腾讯地图·地图助手 Skill，一句自然语言调用腾讯地图全套能力，开箱即用。提供 AI 旅游攻略、地点搜索（含评分/人均/营业时间）、关键词提示、路线规划（驾车/步行/公交/骑行）、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询，并可将行程或多 POI 渲染成网页地图或生成腾讯地图小程序指南。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。\"\nlicense: MIT\nversion: 1.5.2\ngit_url: https://github.com/TencentLBS/tencentmap-map-assistant\n---\n\n# 地图助手 Skill\n\n腾讯位置服务出品。用一句自然语言即可生成旅游攻略、搜索地点、规划路线、解析地址坐标，并可将结果渲染成网页地图或生成腾讯地图小程序指南。\n\n## 能力\n\n能力命名与腾讯位置服务官网 WebService API 对齐。完整参数签名见下方「参数与返回」。\n\n| 能力 | 说明 | 方法 |\n|------|------|------|\n| AI 旅游攻略 | 自然语言 query → 多日行程攻略，可联动腾讯地图小程序，与朋友共同编辑行程、规划多人出行 | `travel_guide` |\n| 个人地图指南 | 地点列表 → 个人专属地图（保存到腾讯地图小程序，手机随时查看） | `generate_map_guide` |\n| 地点搜索 | 城市/区域搜索、周边圆形搜索、POI 详情 | `poi_search` / `poi_nearby` / `poi_detail` |\n| 关键词输入提示 | 输入补全候选 POI | `poi_sug` |\n| 行政区划 | 省市区列表、下级区划、区划搜索 | `district_list` / `district_children` / `district_search` |\n| 地址解析 | 地址 → 坐标 | `geocoder` |\n| 逆地址解析 | 坐标 → 地址（可附周边 POI） | `regeocoder` |\n| IP 定位 | IP → 位置 | `ip_location` |\n| 路线规划 | 驾车 / 步行 / 公交 / 骑行 | `direction` |\n| 两点间距离 | 计算两点之间的驾车/步行/骑行距离与用时 | `distance_matrix` |\n| 天气查询 | 行政区/坐标 → 实时或预报天气 | `weather` |\n| 坐标系转换 | GPS(WGS-84) / 百度 / sogou / mapbar → GCJ-02 | `coord_translate` |\n| 行程 / POI 可视化 | 把行程或多 POI 结果渲染为网页地图 | — |\n\n## 安装\n\n首次使用前安装：\n\n```\npip install -e .\n```\n\n## 用法\n\n```python\nfrom tmap_client import TmapClient\n\nclient = TmapClient()\n\nresult = client.travel_guide(\"武汉5天攻略\")\npois = client.poi_search(\"黄鹤楼\", region=\"武汉\")\naddr = client.geocoder(\"深圳市腾讯滨海大厦\")\n```\n\n配置自己的腾讯位置服务 Key（持久化保存，之后自动启用）：\n\n```python\nfrom tmap_client import save_key_to_dotenv\nsave_key_to_dotenv(\"你的 Key\")\n```\n\n\n## Key 管理\n\n按此顺序自动获取 Key，通常无需干预：`TmapClient(key=...)` → 已保存的 Key。各来源的 Key 会全部进入候选池。\n\n- 无可用 Key → 读取 `tempkey-guide.md` 引导用户申请临时体验 Key。\n- 用户要固定使用或更换 Key → 调用 `save_key_to_dotenv(\"\")` 保存，之后自动生效。\n- Key 已配置但接口报错 → TmapClient 会按优先级自动轮询候选池中的可用 Key 并切换使用。切换后，必须告知用户已自动切换以及切换原因；若所有 Key 均不可用时抛出 TmapError（含每个 Key 的失败原因），必须读取 `references/error-codes.md`，对错误码给出修正方式告知用户。\n\n\n## 参数与返回\n\n### AI 旅游攻略 — travel_guide\n\n`travel_guide(query, lat=30.572815, lng=104.066801)`：自然语言 query → 多日行程攻略。同步等待，单次调用 30-50 秒。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `query` | str | 是 | 目的地 + 天数，例如 \"武汉5天攻略\" / \"成都3天美食游\" |\n| `lat`, `lng` | float | 否 | 用户当前位置（影响 A2A 上下文，不决定目的地） |\n\n**返回**：结构化攻略数据（`title`/`summary`/`days` 行程列表等），以及 **`output_markdown`**（成品攻略 md 文件路径，含小程序二维码，Read 后原样输出）。\n\n### 个人地图指南 — generate_map_guide\n\n`generate_map_guide(pois, city, title=\"我的指南\", query=\"\", description=\"\")`：将任意地点列表（搜索结果、路线点、打卡记录）一键保存为腾讯地图小程序里的个人专属地图，在手机上随时查看和导航。\n\n> **前置步骤**：构造 `pois` 前，先对每个地点调用 `poi_search()`拿到真实的 `id` 与 `location.lat` / `location.lng`，再映射成 `pois` 所需的 `poi_id` / `lat` / `lng`。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `pois` | List[Dict] | 是 | POI 列表，每个 POI 含 `name` / `lat` / `lng` / `poi_id`。这些值应取自 `poi_search()` / `poi_sug()` 的真实返回后填入 |\n| `city` | str | 是 | 城市名称 |\n| `title` | str | 否 | 指南标题，默认\"我的指南\" |\n| `query` | str | 否 | 用户原始输入（用于入库备注） |\n| `description` | str | 否 | 行程/路线描述文本，会嵌入输出 md 正文 |\n\n**返回**：`{travel_guide_id, qr_code, qr_path, mini_program_username, output_markdown}`\n\n### 地点搜索 — poi_search\n\n`poi_search(keyword, region=None, location=None, page_size=10, page_index=1)`：按城市或中心点检索 POI。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `keyword` | str | 是 | 搜索词 |\n| `region` | str | 二选一 | 城市名（\"深圳\"/\"武汉\"） |\n| `location` | str | 二选一 | 中心点 \"lat,lng\"，启用 5km 邻近搜索 |\n| `page_size` | int | 否 | 每页 1-20，默认 10 |\n| `page_index` | int | 否 | 页码，默认 1 |\n\n### 地点搜索（POI 详情）— poi_detail\n\n`poi_detail(poi_id)`：按 POI ID 取详情（来自 `poi_search` / `poi_sug` 返回，或 `travel_guide` 的 `poi_uid`）。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `poi_id` | str | 是 | POI 唯一 ID |\n\n### 地点搜索（周边）— poi_nearby\n\n`poi_nearby(keyword, location, radius=1000, page_size=10, page_index=1)`：圆形范围内的 POI 检索。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `keyword` | str | 是 | 搜索词（\"咖啡\" / \"加油站\"） |\n| `location` | str | 是 | 中心点 \"lat,lng\" |\n| `radius` | int | 否 | 半径（米），取值 10-1000，默认 1000 |\n| `page_size` / `page_index` | int | 否 | 同 `poi_search` |\n\n### 关键词输入提示 — poi_sug\n\n`poi_sug(keyword, region=None, location=None)`：候选 POI（常用于\"先 sug 拿 ID 再查 detail\"）。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `keyword` | str | 是 | 搜索词 |\n| `region` | str | 否 | 城市名 |\n| `location` | str | 否 | 中心点 \"lat,lng\" |\n\n### 路线规划 — direction\n\n`direction(from_addr, to_addr, mode=\"driving\", region=None)`：起终点 → 路线方案。地址/景点名自动转坐标（建议传 `region` 城市消歧）。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `from_addr` | str | 是 | 起点地址 / 景点名 / \"lat,lng\" |\n| `to_addr` | str | 是 | 终点地址 / 景点名 / \"lat,lng\" |\n| `mode` | str | 否 | `driving` / `walking` / `bicycling` / `transit`，默认 `driving` |\n| `region` | str | 否 | 城市名，辅助把\"象鼻山\"等景点名解析到正确城市 |\n\n### 地址解析 — geocoder\n\n`geocoder(address, policy=1)`：把地址 / 地标 / 景点名解析成坐标。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `address` | str | 是 | 地址或地点名。含城市更准；不含城市也可（靠默认 policy=1 兜底） |\n| `policy` | int | 否 | 解析策略。`1`=宽松（默认，支持\"象鼻山\"等景点/地标名）；`0`=标准（地址须含城市，否则报错） |\n\n### 逆地址解析 — regeocoder\n\n`regeocoder(lat, lng, get_poi=False)`：把坐标解析成语义化地址。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `lat`, `lng` | float | 是 | GCJ02 坐标 |\n| `get_poi` | bool | 否 | 是否附带周边 POI 列表，默认 False |\n\n### IP 定位 — ip_location\n\n`ip_location(ip=None)`：IP → 所在省市区。不传 IP 则定位调用方公网 IP。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `ip` | str | 否 | IPv4 字符串 |\n\n### 行政区划 — district_list / district_children / district_search\n\n```python\ndistrict_list() # 全国省级列表\ndistrict_children(parent_id) # 下级区划（parent_id=\"110000\" → 北京下属）\ndistrict_search(keyword) # 关键词搜区划\n```\n\n### 两点间距离 — distance_matrix\n\n`distance_matrix(origin, dest, mode=\"driving\")`：计算两点之间的驾车/步行/骑行距离与用时。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `origin` | str | 是 | 起点坐标 `\"lat,lng\"` |\n| `dest` | str | 是 | 终点坐标 `\"lat,lng\"` |\n| `mode` | str | 否 | `driving` / `walking` / `bicycling`，默认 `driving` |\n\n### 天气查询 — weather\n\n`weather(adcode=None, location=None, type=\"now\")`：查实时或预报天气。`adcode` 与 `location` 二选一。\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `adcode` | str | 否 | 行政区划代码，如北京 `\"110000\"` |\n| `location` | str | 否 | 坐标 `\"lat,lng\"` |\n| `type` | str | 否 | `now` 实时 / `future` 预报，默认 `now` |\n\n### 坐标系转换 — coord_translate\n\n`coord_translate(locations, type=1)`：把 GPS(WGS-84) / 百度 / sogou / mapbar 等坐标批量转成腾讯地图使用的 GCJ-02。单次最多 100 个点。**处理 GPS 原始坐标（如手机定位、GPX 轨迹、外部数据源）时必须先转再传给 `regeocoder` / `poi_nearby` / `direction` 等接口，否则会有几十米～百米级偏移。**\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `locations` | str \\| tuple \\| list | 是 | 支持 `\"lat,lng\"` / `\"lat1,lng1;lat2,lng2\"` 字符串、`(lat, lng)` 元组、`[(lat, lng), ...]` 列表 |\n| `type` | int | 否 | 输入坐标类型。**1=GPS(WGS-84)**（默认，最常用）/ 2=sogou 经纬度 / 3=baidu / 4=mapbar / 5=GCJ-02（不转）/ 6=sogou 墨卡托 |\n\n**返回**：单点入参 → `{\"lat\": .., \"lng\": ..}`；多点入参 → `[{\"lat\": .., \"lng\": ..}, ...]`；`raw=True` 时返回官方原始 JSON。\n\n```python\n# 单点 GPS → GCJ-02\ngcj = client.coord_translate((22.540601, 113.933970))\n# {'lat': 22.542..., 'lng': 113.939...}\n\n# 批量转换\ngcj_list = client.coord_translate([(22.5406, 113.9339), (39.9042, 116.4074)])\n```\n\n### 行程 / POI 可视化 HTML\n\n涉及\"多 POI 对比 / 路线 / 多天行程 / 个人专属地图\"等\"看图比看字直观\"的场景，可基于结构化数据渲染网页地图。地图底图使用腾讯地图 JSAPI GL，HTML 模板、底图 `\n
'''\n\nwith open(\"map.html\", \"w\", encoding=\"utf-8\") as f:\n f.write(html)\n```\n\n> 更多渲染能力（散点图、热力图、弧线图、轨迹回放等）参见 `references/jsapi-guide/`。\n\n## 🔒 隐私与数据\n\n- AI 旅游攻略（`travel_guide`）与个人地图指南（`generate_map_guide`）会将用户输入的行程/POI 数据发送至腾讯地图服务器，用于生成攻略内容和微信小程序二维码。服务器端数据留存与使用遵循[腾讯位置服务隐私政策](https://lbs.qq.com/userAgreements/agreements/privacy)。\n\n## 🔑 Key 策略\n\n| 场景 | 行为 |\n|:-----|:-----|\n| 未配置 Key | 需通过 tempkey 流程申请临时体验 Key，或配置正式 Key |\n| 已配置 Key | 走正式通道（apis.map.qq.com），使用你自己的额度 |\n| Key 优先级 | 传入参数 → 环境变量 `TMAP_KEY` → `~/.tencentmap/tempkey.json` |\n\nFile v1.5.2:references/jsapi-guide/README.md\n\n# 腾讯地图 JSAPI GL 资料（内嵌）\n\n> 本目录是腾讯地图 JS API GL 的完整开发资料，内嵌在本 skill 包里，\n> 在需要为旅游攻略 / 多 POI / 路线出 HTML 可视化时直接查阅。\n>\n> HTML 地图底图使用腾讯地图 JSAPI GL。底图 `\n```\n\ntempkey 生成的 Key 同时支持 JSAPI 底图加载和 WebService API 调用，放进 HTML `` 即可显示底图。未配置 Key 时需先通过 tempkey 流程申请临时体验 Key。\n\n> ⚠️ **安全提示**：将 Key 明文写在 HTML `\n\n\n```\n\n改造后，前端源码与网络请求都不再含 Key，达到防泄露目的。\n\n### 地图样式\n\n**使用系统默认样式即可，无需设置 `mapStyleId`**。若用户希望修改地图样式，可引导其前往腾讯位置服务官网登录账号，在控制台为对应 Key 配置样式后使用；下方样式表供已在控制台配置自定义样式的用户参考。\n\n```js\nconst map = new TMap.Map('map', {\n center: new TMap.LatLng(39.9, 116.4), zoom: 12\n // 使用系统默认样式；如需自定义样式，在官网控制台为 Key 配置后再设置 mapStyleId\n});\n```\n\n| styleId | 样式名称 | 说明 |\n|---------|---------|------|\n| style1 | 可视化官网黑光字 | 黑底 |\n| style2 | 星渊 | 深蓝黑底 |\n| style3 | 玉露 | 绿底 |\n| style4 | 黑色极简 | 黑底 |\n| style5 | 璃青 | 浅绿底 |\n| style6 | 玄青 | 深灰黑底 |\n| style7 | 浅色底图-可视化 | 浅灰白 |\n| style8 | 白浅 | 白色 |\n| style9 | 经典 | 标准 |\n\n> 以上样式均需在官网控制台为 Key 配置后可用。tempkey 及未配置的正式 Key 使用系统默认样式，无需设置 `mapStyleId`。\n\n## HTML 生成示例\n\n地图能力使用 `TMap.Map` + `TMap.MultiMarker` + `TMap.MultiPolyline` + `TMap.InfoWindow`。把 POI 数据换成 client 返回的真实坐标即可：\n\n```python\nimport os, json\n\n# POI 数据（实际用 client 返回的坐标）\npois = [\n {\"name\": \"象鼻山\", \"lat\": 25.2675, \"lng\": 110.2966},\n {\"name\": \"两江四湖\", \"lat\": 25.2798, \"lng\": 110.2904},\n {\"name\": \"靖江王府\", \"lat\": 25.2858, \"lng\": 110.2992},\n]\nmarkers_js = json.dumps(\n [{\"id\": str(i), \"position\": [p[\"lat\"], p[\"lng\"]], \"title\": p[\"name\"]} for i, p in enumerate(pois)],\n ensure_ascii=False,\n)\n\nhtml = f'''\n\n\n
'''\n\nout = os.path.expanduser(\"~/Documents/itinerary_map.html\")\nwith open(out, \"w\", encoding=\"utf-8\") as f:\n f.write(html)\nprint(out)\n```\n\n旅游攻略类 HTML 还可把 `travel_guide` 返回的 `qr_path` 嵌入网页右下角浮窗（约 120×120）；POI 按天分色 + 数字角标 + polyline 连线。\n\n## 画路线：polyline 解压\n\n`direction` 返回腾讯路线接口原生响应（`result.routes`）。驾车/步行/骑行的 `routes[0].polyline` 是**压缩格式的一维数组**，画线前需解压成 `[lat,lng]` 点序列：前两个值是首点真实经纬度，其后每个值是相对前一点的差值（×1e6），逐项累加还原。\n\n```python\ndef decode_polyline(coors):\n \"\"\"腾讯压缩 polyline 一维数组 → [[lat,lng], ...]\"\"\"\n if not coors or len(coors) < 2:\n return []\n pts = [[coors[0], coors[1]]]\n for i in range(2, len(coors) - 1, 2):\n lat = pts[-1][0] + coors[i] / 1_000_000.0\n lng = pts[-1][1] + coors[i + 1] / 1_000_000.0\n pts.append([round(lat, 6), round(lng, 6)])\n return pts\n```\n\n解压后转成 `new TMap.LatLng(lat, lng)` 数组喂给 `MultiPolyline` 的 `paths`。\n\n> 公交 `transit` 的 route 没有顶层 polyline，折线分散在 `steps` 各换乘段里（步行段的 `polyline` 字段、乘车段 `lines[0].polyline`），按需分别解压。\n\nFile v1.5.2:_meta.json\n\n{\n \"ownerId\": \"kn77cw5hbmapf54rv89jdqwp7x835m4k\",\n \"slug\": \"tencentmap-map-assistant-skill\",\n \"version\": \"1.5.2\",\n \"publishedAt\": 1786521712517\n}\n\nFile v1.5.2:references/agent-notes.md\n\n# 调用指引（供 AI 阅读）\n\n本文件补充 SKILL.md 未展开的调用细节，帮助 AI 稳定完成任务。\n\n## 能力命中本 skill 时，用 client 完成\n\n用户需求涉及旅游攻略、找地点、路线规划、地址坐标转换、行政区划、距离计算等，均通过 `TmapClient` 完成，返回的是腾讯位置服务真实数据。\n\n- client 仅依赖 `requests`，多数环境已自带，可直接调用；仅当报 `ModuleNotFoundError: requests` 时执行 `pip install requests` 后重试。\n- 调用报错时，读返回的报错信息定位。API 错误码见 `error-codes.md` 分类表，参数类错误可修正后重试；其余错误不可绕过或降级，引导用户修正。\n\n\n## Key 策略：检查 tempkey，按需配置正式 Key\n\n每个使用者的腾讯位置服务额度独立。\n\n- **Key 解析顺序**：用户传入参数 → 环境变量 `TMAP_KEY` → `~/.tencentmap/tempkey.json`（持久化 key 源，含手动指定的 Key 与申请的临时体验 Key）。\n- **无 Key 时**：client 初始化成功，但调用 WebService API 时会抛出 `TmapError`。此时 AI 应引导用户通过 tempkey 流程申请 AI 场景临时体验 Key（手机验证，1 年有效，覆盖 WebService API + JSAPI 底图加载）。**必须读取 `tempkey-guide.md` 获取完整申请流程**（协议展示、脚本调用、错误码表、输出模板等），严格按照其中步骤执行。\n- **配置正式 Key**：使用者提供 Key 时，用 `save_key_to_dotenv(\"Key\")` 持久化保存（写入 `~/.tencentmap/tempkey.json`），重新初始化 client 后自动走正式通道。\n\n```python\nfrom tmap_client import TmapClient, save_key_to_dotenv\nc = TmapClient() # 自动解析 Key（env / tempkey.json）\n# save_key_to_dotenv(\"XXX-...\") # 使用者提供 Key 时调用\n```\n\n## 返回结构：默认语义化文本\n\n所有 WebService 能力（搜索、提示、详情、地址解析、区划、IP、距离矩阵、路线规划）默认直接返回**语义化文本**——中文、带单位、可直接展示给用户。禁止重新解析 raw JSON 自己拼接文字。\n\n如需原始 JSON 做下游计算（例如取 route_id 调沿途搜索、取 poi_id/坐标调 generate_map_guide），传 `raw=True`：\n\n## 错误处理：直接展示错误信息\n\nAPI 报错时（TmapError），`e.message` 含错误码和原因描述。对应操作指引见 `references/error-codes.md`，按错误码查找后引导用户修正，不得自行估算或编造。\n\n```python\n# 默认：返回可读文本\ntext = client.poi_search(\"黄鹤楼\", region=\"武汉\")\n# → \"找到约223条结果，以下为其中10条\\n(1) 黄鹤楼...\"\n\n# raw=True：返回原始 JSON\ndata = client.poi_search(\"深圳北站\", region=\"深圳\", raw=True)\np1 = data[\"data\"][0] # 取 id、坐标等精确字段\n```\n\n> 行政区划三个方法的 `result` 是**二维数组**——`result[0]` 才是区划对象列表。\n\n路线规划 `direction` 仅在调用前自动把起终点的地址/景点名转成坐标，默认返回语义化文本。如需原始 JSON（例如取 `polyline` 画地图），传 `raw=True` 后从 `result.routes` 获取。其中驾车/步行/骑行的 `polyline` 为压缩格式，画线前需解压（解压方法见 `jsapi-guide/README.md`）。\n\n## travel_guide 的回复方式\n\n`travel_guide` 返回的 `output_markdown` 是成品攻略文件（含行程正文与小程序入口二维码图片）。\n\n**必须做的事（缺一不可）：**\n\n1. 用 Read 读取 `result[\"output_markdown\"]`，将文件内容**完整作为回复**——包含末尾的 `![腾讯地图小程序入口图](...)` 图片语法。**Markdown 图片语法 `![]()` 完全可以直接在 WorkBuddy 会话中渲染显示**，不需要转换成 base64、不需要上传、不需要用其他方式——直接输出 `![]()` 语法就能看到二维码图。\n2. **同时**将 `result[\"qr_path\"]` 指向的二维码 PNG 文件复制到当前工作空间，确保二维码作为实体文件留存在工作区，用户可以随时找到和使用。复制命令参考：macOS/Linux 用 `cp`，Windows 用 `copy`。示例：`cp /path/to/qrcodes/xxx.png <工作空间路径>/`\n\n文件末尾结构示例：\n\n```markdown\n---\n![腾讯地图小程序入口图](/path/to/qrcodes/travel_guide_xxx.png)\n\n👆 扫码保存自己的专属地图，在手机上随时查看和导航。\n```\n\n> ⚠️ Markdown 图片语法 `![...](...)` 可在 WorkBuddy 会话中内联渲染，请务必通过此方式展示二维码图片，而非仅提供文件路径、转 base64 或其他方式。\n\n## 网页生成（HTML 地图可视化）\n\n涉及\"多 POI 对比 / 路线 / 多天行程 / 个人专属地图\"等\"看图比看字更直观\"的场景，可基于结构化数据生成 HTML 网页地图。底图 key、HTML 生成示例、polyline 解压方法、各类 API 与 demo 全部见 `references/jsapi-guide/README.md`，照其中模板生成即可。\n\n> 使用系统默认样式即可。若用户希望修改地图样式，可引导其前往腾讯位置服务官网登录账号，在控制台为对应 Key 配置样式后使用。\n\n## 个人地图指南（generate_map_guide）\n\n`generate_map_guide` 是独立于 A2A 攻略的指南生成能力，可将任意 POI 列表直接生成腾讯地图小程序指南（含二维码），用户扫码即可在手机上查看、导航、分享、编辑。与 `travel_guide` 内含出码不同，本方法需显式调用。\n\n### 业务场景\n\n| 用户说… | 动作 |\n|---------|------|\n| \"帮我记录这几个打卡点\" / \"生成一个XX地图\" / \"存到手机上\" | 调用 `generate_map_guide()` 生成指南 |\n| \"帮我搜一下深圳的咖啡馆\" → 返回 ≥2 个 POI | 同一回复中调用 `generate_map_guide()` |\n| \"从A到B怎么走\" → direction 路线规划 | 同一回复中调用 `generate_map_guide()` |\n| 生成了 HTML 地图可视化 | 同一回复中调用 `generate_map_guide()`，HTML 桌面看 + 小程序手机导航 |\n| `travel_guide` 攻略 | 已内置出码，直接 Read `output_markdown`，**无需额外调用** |\n| 单点查询 | 只返回数据，不出码 |\n\n### 调用示例\n\n```python\n# 路线规划 + 出码的标准流程\nroute = client.direction(\"深圳北站\", \"深圳湾口岸\", mode=\"driving\")\n\n# 先用 poi_search 获取真实 POI（id + location 坐标），再映射生成指南\np1 = client.poi_search(\"深圳北站\", region=\"深圳\", raw=True)[\"data\"][0]\np2 = client.poi_search(\"深圳湾口岸\", region=\"深圳\", raw=True)[\"data\"][0]\nguide = client.generate_map_guide(\n [{\"name\": p1[\"title\"], \"lat\": p1[\"location\"][\"lat\"], \"lng\": p1[\"location\"][\"lng\"], \"poi_id\": p1[\"id\"], \"day\": 1, \"num\": 1},\n {\"name\": p2[\"title\"], \"lat\": p2[\"location\"][\"lat\"], \"lng\": p2[\"location\"][\"lng\"], \"poi_id\": p2[\"id\"], \"day\": 1, \"num\": 2}],\n city=\"深圳\",\n description=\"深圳北站 → 深圳湾口岸，约15公里，驾车约30分钟\"\n)\n# guide[\"output_markdown\"] → Read 后作为回复的一部分输出\n```\n\n### pois 字段说明\n\n> **数据来源**：`lat` / `lng` / `poi_id` 取自 `poi_search()` / `poi_sug()` 的真实返回（搜索结果中坐标位于 `location.lat/lng`、ID 为 `id`），映射后填入。生成指南前先逐点搜索。\n\n| 字段 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `name` | str | 是 | 地点名称，取自搜索返回的 `title` |\n| `lat` / `lng` | float | 是 | GCJ02 坐标，取自搜索返回的 `location.lat` / `location.lng` |\n| `poi_id` | str | 是 | POI ID，取自搜索返回的 `id`，保证定位精度 |\n| `day` | int | 否 | 天分组，默认 1 |\n| `num` | int | 否 | 序号，默认按输入顺序编号 |\n| `type` | int | 否 | POI 类型，默认 1。`2` 表示搜索词类型（需配合 `search_query`） |\n| `search_query` | str | 否 | 仅在 `type=2` 时使用 |\n| `inday` | int | 否 | 散点所属天数，默认 0 |\n\nFile v1.5.2:references/api_reference.md\n\n# 腾讯位置服务 AI 场景 Key 申请接口文档\n\n---\n\n## 域名\n\n| 项目 | 值 |\n|------|-----|\n| API 域名 | `lbsconsole.map.qq.com` |\n\n---\n\n## 通用说明\n\n### 鉴权与防重放\n\nSkill 三个接口（`/nosession/http/skill/*`）无需 Cookie 登录态，需在 HTTP Header 中携带：\n\n| Header | 必填 | 说明 |\n|--------|:----:|------|\n| `X-Skill-Nonce` | 是 | 随机字符串，用于防重放，时间窗内（默认 300 秒）只能使用一次 |\n| `X-Skill-Timestamp` | 是 | 客户端时间戳（秒级），与服务端偏差超时间窗则拒绝 |\n\n控制台接口（`/console/*`）走 Cookie 鉴权，不需要上述 Header。**Skill 不使用控制台接口。**\n\n### 统一响应格式\n\n```json\n{\n \"info\": {\n \"error\": 0,\n \"msg\": \"成功\"\n },\n \"detail\": { ... }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| info.error | int | 0=成功，非 0=失败（值即错误码） |\n| info.msg | string | 成功为 \"成功\"，失败为错误码字符串（如 \"SKILL_INVALID_PHONE\"） |\n| detail | object | 业务数据，失败时通常为空对象或不存在 |\n\n### 错误码\n\n| 错误码 | code | 触发场景 |\n|--------|------|---------|\n| `OK` | 0 | 成功 |\n| `MISSING_PARAM` | 2000 | 参数缺失 |\n| `ILLEGAL_PARAM` | 2999 | 参数非法 |\n| `SKILL_INVALID_PHONE` | 500081 | 手机号格式不正确 |\n| `SKILL_TIMESTAMP_EXPIRED` | 500071 | 时间戳超出时间窗 |\n| `SKILL_NONCE_REPLAY` | 500070 | nonce 已使用过 |\n| `SKILL_SMS_COOLDOWN` | 500072 | 发送冷却中 |\n| `SKILL_SMS_PHONE_DAY_LIMIT` | 500073 | 手机号当日发送达上限 |\n| `SKILL_SMS_IP_DAY_LIMIT` | 500074 | IP 当日发送达上限 |\n| `SKILL_VERIFY_CODE_EXCEEDED` | 500075 | 验证码错误超 3 次 |\n| `AUTH_EXPIRED` | 1007 | session_token 或 supplement_token 不存在/已过期 |\n| `AUTH_FAILED` | 1008 | 验证码错误 |\n| `SKILL_SMS_SEND_ERROR` | 500080 | 短信发送失败 |\n| `SKILL_USER_REGISTER_ERROR` | 500079 | 新用户注册失败 |\n| `SKILL_CREATE_IN_PROGRESS` | 500083 | 该手机号正在创建 Key（分布式锁） |\n| `SKILL_SUPPLEMENT_IN_PROGRESS` | 500088 | 该用户正在补额（分布式锁） |\n| `SKILL_NO_SUITABLE_KEY` | 500085 | mkey 不满足条件 |\n| `SKILL_AI_CLAIM_ONCE_USED` | 500084 | 已领取过 AI 场景 Key（且已到期，不再扩容） |\n| `SKILL_QUOTA_WRITE_ERROR` | 500086 | 临时额度写入失败 |\n| `SKILL_CLAIM_WRITE_ERROR` | 500089 | 领取记录写入失败 |\n| `INNER_ERROR` | 3001 | DB/Redis 异常 |\n\n---\n\n## 一、发送验证码\n\n### 基本信息\n\n| 项目 | 值 |\n|------|-----|\n| 路径 | `POST /nosession/http/skill/auth/send-code` |\n| Content-Type | application/json |\n| 鉴权 | Header nonce + timestamp |\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|:----:|------|\n| customer_phone | string | 是 | 中国大陆手机号，11 位，1 开头 |\n\n### 请求示例\n\n```bash\ncurl -s -X POST 'https://lbsconsole.map.qq.com/nosession/http/skill/auth/send-code' \\\n -H 'Content-Type: application/json' \\\n -H 'X-Skill-Nonce: abc123def456' \\\n -H 'X-Skill-Timestamp: 1752662400' \\\n -d '{\"customer_phone\":\"13800138000\"}'\n```\n\n### 响应示例\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"session_token\": \"sk_a1b2c3d4e5f67890123456789abcdef0\"\n }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| detail.session_token | string | 会话令牌，前缀 `sk_`，用于 create 接口。有效期 300 秒 |\n\n---\n\n## 二、创建临时 Key\n\n### 基本信息\n\n| 项目 | 值 |\n|------|-----|\n| 路径 | `POST /nosession/http/skill/v2/tempkey/create` |\n| Content-Type | application/json |\n| 鉴权 | Header nonce + timestamp + session_token 验证 |\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|:----:|------|\n| customer_phone | string | 是 | 中国大陆手机号 |\n| verify_code | string | 是 | 短信验证码（6 位数字） |\n| session_token | string | 是 | send-code 返回的会话令牌 |\n| scene | int | 否 | 场景：1=Skill（默认），2=MCP。**Skill 固定传 1** |\n\n### 响应形态\n\n| type | 含义 | 返回字段 | 触发场景 |\n|------|------|---------|---------|\n| `created` | Key 已就绪 | `key`, `expire_time`, `is_existing`(可选) | 新用户 / 老用户无合适 Key / 幂等返回(claim_type∈{1,2}) |\n| `reused` | 幂等返回已补额的老 Key | `key`, `expire_time`, `is_existing` | 老用户幂等命中且 claim_type=3（reuse） |\n| `select` | 返回 Key 列表 | `key_list`, `supplement_token`, `supplement_token_expire` | 老用户有名下满足条件的 Key |\n\n### 响应示例 1：type=created（新建 Key）\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"created\",\n \"key\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\",\n \"expire_time\": \"2027-07-17 19:59:59\"\n }\n}\n```\n\n### 响应示例 2：type=created（幂等返回已有 Key，claim_type∈{1,2}）\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"created\",\n \"key\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\",\n \"expire_time\": \"2027-07-17 19:59:59\",\n \"is_existing\": true\n }\n}\n```\n\n### 响应示例 3：type=reused（幂等返回已补额的老 Key，claim_type=3）\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"reused\",\n \"key\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\",\n \"expire_time\": \"2027-07-17 19:59:59\",\n \"is_existing\": true\n }\n}\n```\n\n### 响应示例 4：type=select（返回 Key 列表）\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"select\",\n \"key_list\": [\n {\n \"key_name\": \"我的地图应用\",\n \"key_value\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\"\n },\n {\n \"key_name\": \"测试Key\",\n \"key_value\": \"F8E2-WXYZ-ABCD-EFGH-IJKL\"\n }\n ],\n \"supplement_token\": \"sk_xxx_yyy_zzz\",\n \"supplement_token_expire\": 300\n }\n}\n```\n\n### 字段说明\n\n#### 顶层字段（位于 detail 对象内）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| type | string | `created` / `reused` / `select` |\n| key | string | type=created/reused 时返回，Key 值 |\n| expire_time | string | type=created/reused 时返回，到期时间 `YYYY-MM-DD HH:mm:ss` |\n| is_existing | bool | type=created/reused 时返回，true=幂等返回已有 Key |\n| key_list | array | type=select 时返回，合适 Key 列表 |\n| supplement_token | string | type=select 时返回，用于 supplement 接口 |\n| supplement_token_expire | int | token 过期剩余秒数（默认 300） |\n\n#### key_list 数组元素\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| key_name | string | Key 名称（appname） |\n| key_value | string | Key 值（完整值，前端脱敏展示） |\n\n### 业务流程\n\n```\n请求进入\n ├─ nonce + timestamp 校验\n ├─ 参数解析 + 手机号格式校验\n ├─ 分布式锁（per phone）\n ├─ IP / 手机号 日限额校验\n ├─ SMS 验证码校验\n ├─ 查询用户 sid = QueryUser(phone)\n │\n ├─ sid > 0（老用户）→ handleOldUser:\n │ ├─ 幂等检查 QueryActiveAiClaim(sid)\n │ │ ├─ claim_type=3 → type=reused, is_existing=true\n │ │ └─ claim_type∈{1,2} → type=created, is_existing=true\n │ ├─ FindSuitableKeys(sid)\n │ │ ├─ 有合适 Key → type=select, 返回 key_list + supplement_token\n │ │ └─ 无合适 Key → createAiKeyWithQuota(claim_type=2) → type=created\n │\n └─ sid == 0（新用户）:\n └─ 注册 + createAiKeyWithQuota(claim_type=1) → type=created\n```\n\n> **注意**：若 SID 曾扩容但 Key 已过期，create 返回错误码 `500084`（SKILL_AI_CLAIM_ONCE_USED），不再再次扩容。\n\n### 合适 Key 条件（8 个）\n\n1. `FIND_IN_SET(2, pf) > 0`（WebService 权限开启）\n2. `status = 1`（可用）\n3. `super = 0`（非超级 Key）\n4. `ws_whitelist` 为空（未设置 IP 白名单）\n5. `miniapp_whitelist` 为空（未设置小程序白名单）\n6. `sk` 为空（未开启签名鉴权）\n7. `web_whitelist` 为空（未设置 Web 白名单）\n8. 不在 ban 表中（`status=1 AND end_time > NOW()`）\n\n### claim_type 枚举\n\n| 值 | 含义 | 使用位置 |\n|----|------|---------|\n| 1 | 新用户新建 Key | create（新用户） |\n| 2 | 老用户新建 Key | create（老用户无合适Key）/ supplement(action=create) |\n| 3 | 老用户复用 Key | supplement(action=reuse) |\n\n---\n\n## 三、补额 / 新建 Key（supplement）\n\n### 基本信息\n\n| 项目 | 值 |\n|------|-----|\n| 路径 | `POST /nosession/http/skill/v2/tempkey/supplement` |\n| Content-Type | application/json |\n| 鉴权 | Header nonce + timestamp + supplement_token |\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|:----:|------|\n| supplement_token | string | 是 | create 接口 type=select 时返回的令牌 |\n| mkey | string | action=reuse 时必填 | 用户选定的 Key |\n| action | string | 否 | `reuse`（默认，复用老 Key）/ `create`（新建 Key） |\n\n### 请求示例 1：action=reuse（复用老 Key 补额）\n\n```bash\ncurl -s -X POST 'https://lbsconsole.map.qq.com/nosession/http/skill/v2/tempkey/supplement' \\\n -H 'Content-Type: application/json' \\\n -H 'X-Skill-Nonce: reuse001' \\\n -H 'X-Skill-Timestamp: 1752662460' \\\n -d '{\n \"supplement_token\": \"sk_xxx_yyy_zzz\",\n \"mkey\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\",\n \"action\": \"reuse\"\n }'\n```\n\n### 请求示例 2：action=create（新建 Key）\n\n```bash\ncurl -s -X POST 'https://lbsconsole.map.qq.com/nosession/http/skill/v2/tempkey/supplement' \\\n -H 'Content-Type: application/json' \\\n -H 'X-Skill-Nonce: create001' \\\n -H 'X-Skill-Timestamp: 1752662460' \\\n -d '{\n \"supplement_token\": \"sk_xxx_yyy_zzz\",\n \"action\": \"create\"\n }'\n```\n\n### 响应示例\n\n#### action=reuse（复用老 Key 补额）→ type=reused\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"reused\",\n \"key\": \"AB3D-CDEF-GHIJ-KLMN-OPQR\",\n \"expire_time\": \"2027-07-17 19:59:59\",\n \"is_existing\": true\n }\n}\n```\n\n#### action=create（新建 Key）→ type=created\n\n```json\n{\n \"info\": {\"error\": 0, \"msg\": \"成功\"},\n \"detail\": {\n \"type\": \"created\",\n \"key\": \"F8E2-WXYZ-ABCD-EFGH-IJKL\",\n \"expire_time\": \"2027-07-17 19:59:59\"\n }\n}\n```\n\n### 响应字段（supplement，位于 detail 对象内）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| type | string | `reused`（action=reuse，复用补额）/ `created`（action=create，新建 Key） |\n| key | string | Key 值 |\n| expire_time | string | 到期时间 `YYYY-MM-DD HH:mm:ss` |\n| is_existing | bool | `type=reused` 时为 true；`type=created` 时不返回 |\n\n### 处理流程\n\n#### 公共流程\n\n```\n0. nonce + timestamp 校验\n1. 验证 supplement_token → 获取 sid\n2. 分布式锁（per sid）\n3. mkey 校验（仅 action=reuse：3 个条件）\n4. 幂等检查 CheckAiClaimOnce\n5. 消费 token（一次性）\n```\n\n#### action=reuse 分支\n\n```\n6. ComputeSupplementMissing → 查 custom + tmp_quota_record，算差额\n7. 事务（GORM Transaction）：\n ├─ 写 tmp_quota_record（source=1 AI场景）\n └─ 写 t_ai_key_claim（claim_type=3）\n8. 重建索引\n10. 返回老 Key（type=reused, is_existing=true）\n```\n\n#### action=create 分支\n\n```\n6. CreateSkillApp + CreateSkillKey → 创建新 Key\n7. buildInitQuotaRecords → 构建全量 AI 基线配额\n8. 事务（GORM Transaction）：\n ├─ 写 tmp_quota_record（source=1 AI场景）\n └─ 写 t_ai_key_claim（claim_type=2）\n9. 重建索引\n10. 返回新 Key（type=created）\n```\n\n### 补额差额逻辑（action=reuse）\n\n对每个 AI 基线接口，PV 和 QPS 独立计算：\n\n```\ndesired = baseline - formal （正式配额已够则 desired <= 0，不写）\n```\n\n| desired | 已有临时配额 | 过期时间 vs 365天 | 操作 | 写入值 |\n|---------|-------------|------------------|------|--------|\n| > 0 | < desired | 任意 | 提升额度 | `desired` |\n| > 0 | >= desired | >= 365天 | 不动 | — |\n| > 0 | >= desired | < 365天 | 续期（不降额） | `existing` |\n| > 0 | = 0 | — | 新建 | `desired` |\n| <= 0 | 任意 | 任意 | 不动 | — |\n\n**提升额度时**：原过期时间 > 365天则保持原值，否则用 365天。\n\n**已过期的临时配额**（`expire_time <= NOW()`）不计入已有额度，会被覆盖。\n\n---\n\n## 四、控制台临时配额列表（Skill 不使用）\n\n> **说明**：此接口走 Cookie 鉴权，Skill 模式下用户无登录态，不使用此接口。仅作记录。\n\n| 项目 | 值 |\n|------|-----|\n| 路径 | `GET /console/tmp_quota_list` |\n| 鉴权 | 控制台 Cookie（中间件解析 sid） |\n\n请求参数：`mkey`（必填）、`funcid`（必填，指定接口 ID）。\n\n---\n\n## 五、控制台配额查询 OrderStat（Skill 不使用）\n\n> **说明**：此接口走 Cookie 鉴权，Skill 模式下用户无登录态，不使用此接口。仅作记录。\n\n| 项目 | 值 |\n|------|-----|\n| 路径 | `GET /console/orderstat` |\n| 鉴权 | 控制台 Cookie（中间件解析 sid） |\n\n请求参数：`mkey`（必填）、`function_type`/`key_word`/`funcid`/`showinner`（可选）。\n\n---\n\n## 接口清单\n\n| 接口 | Method | 路径 | 鉴权 | Skill 使用 |\n|------|--------|------|------|:----------:|\n| 发送验证码 | POST | `/nosession/http/skill/auth/send-code` | nonce + timestamp | ✅ |\n| 创建临时 Key | POST | `/nosession/http/skill/v2/tempkey/create` | nonce + timestamp + session_token | ✅ |\n| 补额/新建 Key | POST | `/nosession/http/skill/v2/tempkey/supplement` | nonce + timestamp + supplement_token | ✅ |\n| 临时配额列表 | GET | `/console/tmp_quota_list` | Cookie | ❌ |\n| 配额查询（OrderStat） | GET | `/console/orderstat` | Cookie | ❌ |\n\n---\n\n## AI 场景额度规格\n\n| 项目 | 说明 |\n|------|------|\n| 有效期 | 1 年（365 天） |\n| 每个 SID 限制 | 每个 SID 仅可使用一次 AI 场景扩容机会（无论扩到老 Key 还是新建 Key） |\n| 配额（每个接口） | PV = 5000 次/天，QPS = 5 次/秒 |\n| 接口范围 | WebService API（AI 场景基线，具体清单以控制台为准） |\n| 过期处理 | 临时额度到期后停用，不再允许再次扩容，引导用户前往 lbs.qq.com 分配正式额度或办理商业授权 |\n\nFile v1.5.2:references/error-codes.md\n\n# 腾讯地图 API 错误码速查\n\nAPI 报错时把原始错误码 + 错误信息如实呈现给用户，禁止自行判断原因\n控制台 Key 管理：https://lbs.qq.com/dev/console/key/manage\n控制台工单：https://lbs.qq.com/dev/console/ticket/create\n\n## Key 不可用时的处理\n\n`TmapClient` 调用时会按优先级自动轮询候选池中的所有可用 Key，遇到失败自动切换下一个。当所有 Key 均不可用时抛出 `TmapError`（异常信息中列出每个 Key 的失败原因及错误码），此时 AI 须按下表查出每个错误码的对应修正方式并告知用户，引导其前往控制台修改配置或按 `tempkey-guide.md` 重新申请。\n\n## 鉴权 / 配额类\n\n| 错误码 | 原因 | 操作步骤 |\n|--------|------|----------|\n| 110 | 请求来源未授权 | 在控制台 Key 管理页找到对应 Key，检查 Referer 白名单或 IP 白名单是否包含当前请求来源 |\n| 111 | 签名验证失败 | 在控制台找到对应 Key，点击编辑，将正确的 Secret Key 填入后保存 |\n| 112 | IP 未被授权 | 在控制台找到对应 Key，编辑 IP 白名单，添加当前出口 IP |\n| 113 | 功能未授权 | 在控制台找到对应 Key，编辑其配置，开启所需 API 权限 |\n| 120 | QPS 超限 | 降低调用频率，或在「配额管理 → Key 额度」中调整该 Key 的 QPS 配额 |\n| 121 | 日调用量达上限 | 在「配额管理 → Key 额度」中调整日调用量配额 |\n| 160 | sig 不支持此请求类型 | — |\n| 161 | sig 不支持和非 object POST JSON 一起用 | — |\n| 190 | Key 无效 | 确认该 Key 是否存在、是否被删除或已过期 |\n| 199 | Key 未开启 WebService | 控制台 → 应用管理 → 我的应用 → 找到 Key → 编辑 → 勾选 WebService API |\n\n## 参数错误（301-408）\n\n错误码 301-408 统一为「参数错误」，按报错信息中的具体说明修正即可。\n\n其中 **311（key格式错误）** 属于 Key 类错误：用户填错、粘贴不全等场景会命中，处理方式见上方「Key 不可用时的处理」。\n\n## 系统错误（500+）\n\n后端异常，前往控制台创建工单报备。\n\nFile v1.5.2:references/jsapi-guide/jsapigl/demos/地图操作示例.md\n\n# 地图操作示例 Demo 合集\n\n> 本文件合并自 28 个原始 demo HTML，每节为一个独立可运行示例。使用时把对应代码块中的 JS 部分套入标准 HTML 骨架（见 `jsapi-guide/README.md` 的「HTML 生成示例」，底图 ``），或直接整块复制替换 `` 内容。\n\n\n## 2D_3D模式切换\n\n```html\n\n\n\n\n \n \n \n 2D/3D模式切换\n\n\n\n\n\n
\n \n \n \n\n\n\n```\n\n\n## 切换底图类型\n\n```html\n\n\n\n\n \n \n \n 切换底图类型\n\n\n\n\n\n
\n\t\t\n\t\t\n\t\t\n\n\n\n```\n\n\n## 创建地图\n\n```html\n\n\n\n\n \n \n \n 创建地图\n\n\n\n\n\n
\n \n\n\n\n```\n\n\n## 区域高亮\n\n```html\n\n\n \n \n \n \n 区域高亮\n \n \n \n \n
\n \n \n\n```\n\n\n## 卫星地图\n\n```html\n\n\n\n\n \n \n \n 卫星地图\n\n\n\n\n\n
\n \n\n\n\n```\n\n\n## 同时加载两个地图\n\n```html\n\n\n\n\n \n \n \n 同时加载2个地图\n\n\n\n\n\n
\n

地图一

\n
\n

地图二

\n \n\n\n\n```\n\n\n## 地图加载完成事件\n\n```html\n\n\n\n\n \n \n \n 地图加载完成事件\n\n\n\n\n\n
\n
地图正在加载中......
\n \n\n\n\n```\n\n\n## 地图导出图片\n\n```html\n\n\n \n \n \n \n 地图导出为图片\n \n \n \n \n\n
\n \n \n \n \n \n\n```\n\n\n## 地图平滑变化至指定状态\n\n```html\n\n\n\n\n\t\n\t\n\t\n\t地图平滑变化至指定状态\n\n\n\n\n\n
\n\n\n\n\n\n```\n\n\n## 地图平移\n\n```html\n\n\n\n\n \n \n \n 地图平移事件\n\n\n\n\n\n
\n
\n

\n

当前中心点：

\n
\n\n \n\n\n\n```\n\n\n## 地图设置缩放焦点\n\n```html\n\n\n\n\n \n \n \n 地图设置缩放焦点\n\n\n\n\n\n
\n

地图一: 根据鼠标/双指位置缩放

\n
\n

地图二：根据地图中心点缩放

\n \n\n\n\n```\n\n\n## 天空盒\n\n```html\n\n\n \n \n \n \n 天空盒\n \n \n\n \n
\n \n
\n
\n \n \n \n\n```\n\n\n## 实时路况\n\n```html\n\n\n \n \n \n \n 实时路况\n \n \n \n\n \n
\n

\n 设置路况底图透明度：\n 1\n

\n
\n
\n \n \n\n```\n\n\n## 异步加载地图\n\n```html\n\n\n\n\n \n \n \n 异步加载地图\n\n\n\n\n\n
\n \n\n\n\n```\n\n\n## 点击地图拾取POI\n\n```html\n\n\n\n\n \n \n \n 点击地图拾取POI\n \n\n\n\n\n
\n \n\n\n\n```\n\n\n## 点击地图拾取坐标\n\n```html\n\n\n\n\n \n \n \n 点击地图拾取坐标\n\n\n\n\n\n
\n
当前点击坐标为：
\n \n\n\n\n```\n\n\n## 粒子路况\n\n```html\n\n\n \n \n \n \n 粒子路况\n \n \n \n\n \n
\n \n \n\n```\n\n\n## 设置_获取地图中心\n\n```html\n\n\n\n\n \n \n \n 设置/获取地图中心点\n\n\n\n\n\n
\n
\n \n \n

当前地图中心为: 39.984104, 116.307503

\n
\n \n\n\n\n```\n\n\n## 设置_获取地图显示范围\n\n```html\n\n\n\n\n \n \n \n 设置/获取地图显示范围\n\n\n\n\n
\n
\n

当前地图中心点：39.984104, 116.307503

\n

\n \n \n
\n \n \n\n\n```\n\n\n## 设置_获取地图视角\n\n```html\n\n\n\n\n \n \n \n 设置/获取地图视角\n\n\n\n\n\n
\n
\n \n \n

当前地图俯仰角度为: 10

\n

当前地图旋转角度为: 20

\n
\n \n\n\n\n```\n\n\n## 设置地图中心点偏移\n\n```html\n\n\n\n\n \n \n \n map中心点偏移\n\n\n\n\n\n\t
\n\t
\n\t\n\n\n\n```\n\n\n## 设置地图显示比例\n\n```html\n\n\n\n\n \n \n \n 地图显示比例设置\n\n\n\n\n\n
\n\t\t\n\t\t\n\n\n\n```\n\n\n## 设置地图边界范围\n\n```html\n\n\n\n\n\t设置地图边界范围\n\t\n\t\n\t\n\n\n\n\n\t
\n \n\n\t\n\t\n\n\n\n```\n\n\n## 设置控件位置及样式\n\n```html\n\n\n\n\n \n \n \n 地图控件设置\n\n\n\n\n\n
\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n \n \n\t\t\n\n\n\n```\n\n\n## 设置鼠标样式\n\n```html\n\n\n\n\n 自定义鼠标样式\n \n \n \n \n\n\n\n
\n \n \n\n\n\n```\n\n\n## 调整图层顺序\n\n```html\n\n\n\n \n \n \n 调整图层顺序\n\n\n\n\n\n
\n \n \n
\n`），或直接整块复制替换 `` 内容。\n\n\n## Marker文本背景色\n\n```html\n\n\n\n\n \n \n \n 设置Marker文本背景\n\n\n\n\n\n
\n \n \n
\n
\n \n\n\n\n```\n\n\n## Marker随地图放大缩小\n\n```html\n\n\n\n\n \n \n \n Marker自动缩放\n\n\n\n\n\n
\n \n
\n
\n \n\n\n\n```\n\n\n## marker拖动\n\n```html\n\n\n\n\n \n \n \n 拖动marker\n\n\n\n\n\n
\n
点击Marker后选中目标，然后进行拖动。
\n \n \n\n```\n\n\n## marker轨迹回放-全局模式\n\n```html\n\n\n\n\n \n \n \n marker轨迹回放-全局模式\n\n\n\n\n\n
\n\n\n\n\n```\n\n\n## marker轨迹回放-跟随模式\n\n```html\n\n\n \n \n \n \n marker轨迹回放-跟随模式\n \n \n \n\n \n
\n \n \n \n \n

\n \n \n

\n
\n

\n

当前限制小车最大移动距离：0米

\n

当前小车行驶距离：0米

\n

\n
\n
\n
\n \n \n\n```\n\n\n## 为多个marker添加事件\n\n```html\n\n\n\n\n \n \n \n 为多个marker添加事件\n\n\n\n\n\n
\n
\n \n \n

\n

markerID:marker1

\n

当前marker位置：39.984104,116.407503

\n
\n\n \n\n\n\n```\n\n\n## 图文标记\n\n```html\n\n\n \n \n \n \n 图文标记\n \n \n \n\n \n
\n \n \n\n```\n\n\n## 文本标记开启碰撞避让\n\n```html\n\n\n\n\n\t\n\t\n\t\n\t文本标记开启碰撞避让\n\n\n\n\n\n
\n\n\n\n\n```\n\n\n## 文本标记样式自定义\n\n```html\n\n\n\n\n \n \n \n 文本标记样式自定义\n\n\n\n\n\n
\n \n \n
\n
\n\n\n\n\n```\n\n\n## 文本标记点击事件\n\n```html\n\n\n\n\n \n \n \n 文本标记点击事件\n\n\n\n\n\n
\n \n \n
\n
\n
\n
\n\n\n\n\n```\n\n\n## 文本标记背景\n\n```html\n\n\n\n\n \n \n \n 设置文本标记背景\n\n\n\n\n\n
\n \n \n
\n
\n \n\n\n\n```\n\n\n## 普通Marker\n\n```html\n\n\n \n \n \n \n 普通Marker\n \n \n \n \n
\n \n \n
\n
\n \n```\n\ntempkey 生成的 Key 同时支持 JSAPI 底图加载和 WebService API 调用，放进 HTML `` 即可显示底图。未配置 Key 时需先通过 tempkey 流程申请临时体验 Key。\n\n> ⚠️ **安全提示**：将 Key 明文写在 HTML `