tencent-map – OpenClaw Skill

---

name: tencent-map description: 腾讯地图Web服务API集成，用于地点搜索、路线规划、逆地理编码等功能 author: OpenClaw Community version: 1.0.0 homepage: https://lbs.qq.com/dev/console/application/ metadata: {"clawdbot":{"emoji":"🗺️","requires":{"bins":["curl","python3"],"env":["TENCENT_MAP_KEY"]},"primaryEnv":"TENCENT_MAP_KEY"}}

腾讯地图API技能

集成腾讯地图Web服务API，提供地点搜索、路线规划、逆地理编码等功能。

设置

1. 在腾讯位置服务控制台申请密钥
2. 设置环境变量：

   export TENCENT_MAP_KEY="YOUR_TENCENT_MAP_KEY"
   

功能

1. 地点搜索 (search)

搜索指定关键词的地点信息

# 基础搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州"

# 带分页搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州" 1 20

# 指定区域搜索
bash {baseDir}/scripts/tencent_map.sh search "花店" "广州天河区"

2. 逆地理编码 (reverse_geocode)

根据经纬度获取详细地址信息

bash {baseDir}/scripts/tencent_map.sh reverse_geocode 23.129405 113.264287

3. 地理编码 (geocode)

根据地址获取经纬度坐标

bash {baseDir}/scripts/tencent_map.sh geocode "广州市天河区珠江新城"

4. 路线规划 (route)

计算两点间的路线信息

bash {baseDir}/scripts/tencent_map.sh route "起点地址" "终点地址" "driving|walking|transit"

5. 周边搜索 (around)

搜索指定坐标周围的POI

bash {baseDir}/scripts/tencent_map.sh around 23.129405 113.264287 "花店" 3000

参数

• search: keyword, region, page_index, page_size
• reverse_geocode: latitude, longitude
• geocode: address
• route: from, to, mode
• around: latitude, longitude, keyword, radius

返回格式

所有命令均返回标准化的JSON格式，包含状态、结果和错误信息。

限制

• 每日调用次数限制根据腾讯地图API套餐而定
• 搜索结果最多返回20条/页
• 需要有效的腾讯地图API密钥

腾讯地图API技能

这是一个集成腾讯地图Web服务API的OpenClaw技能，提供地点搜索、逆地理编码、地理编码、路线规划等功能。

功能特性

• 地点搜索: 按关键词搜索地点信息
• 逆地理编码: 根据经纬度获取地址详情
• 地理编码: 根据地址获取经纬度坐标
• 周边搜索: 搜索指定坐标周围的POI
• 标准化输出: 所有结果统一为结构化JSON格式

安装

1. 将此技能文件夹复制到OpenClaw的skills目录
2. 确保系统已安装curl和python3
3. 从腾讯位置服务获取API密钥

配置

设置环境变量：

export TENCENT_MAP_KEY="YOUR_TENCENT_MAP_KEY"

使用示例

搜索花店

# 搜索广州地区的花店
bash /path/to/tencent_map.sh search "花店" "广州"

# 搜索天河区的花店，第一页，每页20个结果
bash /path/to/tencent_map.sh search "花店" "广州天河区" 1 20

逆地理编码

# 获取指定坐标的地址信息
bash /path/to/tencent_map.sh reverse_geocode 23.129405 113.264287

地理编码

# 获取地址的坐标
bash /path/to/tencent_map.sh geocode "广州市天河区珠江新城"

周边搜索

# 搜索指定坐标周围3公里内的花店
bash /path/to/tencent_map.sh around 23.129405 113.264287 "花店" 3000

输出格式

所有命令返回标准化JSON格式：

{
  "status": 0,
  "message": "success",
  "pois": [
    {
      "id": "poi_id",
      "title": "地点名称",
      "address": "详细地址",
      "category": "类别",
      "tel": "电话号码",
      "location": {
        "lat": 23.129405,
        "lng": 113.264287
      },
      "overall_rating": 4.5
    }
  ],
  "count": 10
}

注意事项

• 需要有效的腾讯地图API密钥
• API调用受腾讯地图服务条款限制
• 请遵守每日调用次数限制