What makes Gaode Map Personal - 高德官方个人专属地图 Skill notable?

1.4K downloads. Trust evidence available

How should Gaode Map Personal - 高德官方个人专属地图 Skill be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Gaode Map Personal - 高德官方个人专属地图 Skill

高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Skill: Gaode Map Personal - 高德官方个人专属地图 Skill Owner: lbs-amap Summary: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-20T02:44:16.108Z | user 首次发布：高德地图个人专属地图生成工具，支持地理编码、POI搜索、路径规划，生成可在高德地图App中扫码打开的个人地图 Archive index: Archive v1.0.0: 7 files, 14572 bytes

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.0release · observed Apr 20, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: medium.

clawhub skill install s175kkx7bgg448fksjnhth7b1n83p4n5:personal-map

Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lbs-amap-personal-map/snapshot"

Documentation

CLAWHUB

10,561 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: personal-map
display_name: Gaode Map Personal - 高德官方个人专属地图 Skill
description: 高德地图个人专属地图生成工具。封装了高德开放平台的Web服务API，提供地理编码、POI搜索、路径规划、周边搜索、天气查询等能力，最终生成可在高德地图App中打开的个人地图小程序二维码。当用户提到以下任意场景时，都应主动使用本技能：查找附近的餐厅/景点/商场等POI、规划从A到B的路线（步行/驾车/公交/骑行）、生成旅游行程/出行计划/打卡地图、在地图上标记多个地点、分享地图给他人、查询某地天气、将地址转换为坐标或反向解析、制作个人专属地图、行程规划、路线规划、地图分享。即使用户没有明确说"生成地图"，只要涉及地理位置、出行、导航、打卡、行程等话题，都应考虑使用本技能。
version: 1.0.0
author: 高德开放平台
tags:
  - 地图
  - 高德
  - Map
  - 个人地图
  - POI
  - 路径规划
metadata:
  openclaw:
    requires:
      env:
        - AMAP_API_KEY
    primaryEnv: AMAP_API_KEY
---

# 高德个人地图 Skill

## 概述

本 Skill 封装了高德开放平台的 Web 服务 API，提供地理编码、POI 搜索、路径规划等核心能力，根据用户描述生成个人专属地图，并支持在高德地图 App 中扫码打开。

**重要**：所有调用此技能的会话，最终都应调用 `maps_schema_personal_map` 生成个人地图二维码，并通过以下方式展示给用户：
1. **下载二维码图片到本地**（推荐保存到工作目录）
2. **使用 `present` 工具展示图片**
3. **在回复中直接嵌入 Markdown 图片**（双重保障）
4. **提供备用 URL 链接**（防止图片展示失败）

这样可以确保用户能够可靠地看到并保存二维码。

## 接口说明

### 1. 地理编码

- **`maps_geo`**：地址 → 经纬度坐标
  - 参数：`address`（详细地址）、`city`（城市，可选）
  - 返回：经纬度坐标、格式化地址

- **`maps_regeocode`**：经纬度坐标 → 结构化地址
  - 参数：`longitude`（经度）、`latitude`（纬度）
  - 返回：国家、省份、城市、区县等完整地址信息

### 2. POI 搜索

- **`maps_text_search`**：关键词搜索兴趣点
  - 参数：`keywords`（搜索关键词）、`city`（城市，可选）、`offset`（每页记录数，默认 20）
  - 返回：POI 列表（名称、坐标、地址、电话）

- **`maps_around_search`**：周边兴趣点搜索
  - 参数：`keywords`、`location`（中心点"经度,纬度"）、`radius`（搜索半径，单位米，默认 1000）、`types`（POI 类型，可选）、`offset`（默认 20）、`page`（默认 1）
  - 返回：周边 POI 列表（含距离信息）

### 3. 路径规划

- **`maps_direction_walking`**：步行路线规划
  - 参数：`origin`（起点"经度,纬度"）、`destination`（终点"经度,纬度"）

- **`maps_direction_driving`**：驾车路线规划
  - 参数：`origin`、`destination`

- **`maps_direction_transit_integrated`**：公共交通路线规划
  - 参数：`origin`、`destination`、`city`（城市，默认"北京"）

### 4. 位置服务

- **`maps_ip_location`**：IP 地址 → 地理位置
  - 参数：`ip`（IP 地址）
  - 返回：省份、城市、行政区、ISP 等信息

### 5. 地图生成（核心）

- **`maps_schema_personal_map`**：生成个人地图小程序二维码
  - 参数：
    - `orgName`（地图名称）
    - `lineList`（行程列表，每条路线最多 16 个点）
    - `sceneType`（场景类型，可选，默认 `1`）：
      - `1` — 创建资源点且创建路线（默认，通用场景）
      - `2` — 仅创建资源点（搜索类数据，多个点之间无关联关系）
      - `3` — 仅创建路线（路径规划类数据，多个点有关联关系，如起终点、换乘点）
  - 返回：`qr_code_url`（二维码图片链接）、`lineList`（行程数据）

  **sceneType 选择指引：**
  - 用户做的是**搜索**（找餐厅、找景点、找周边 POI 等）→ 用 `sceneType=2`
  - 用户做的是**路径规划**（从 A 到 B、导航、换乘等）→ 用 `sceneType=3`
  - 两者都有，或不确定 → 用默认 `sceneType=1`

## 使用前提

1. 申请高德地图开发者账号并获取 API Key（https://lbs.amap.com/）
2. 配置环境变量：`export AMAP_API_KEY='your_api_key_here'`
3. 确保网络连接正常

## 异常处理

所有接口在出错时均返回结构化错误信息，不会抛出异常：

```python
{"error": "错误类型", "message": "具体原因"}
```

常见错误类型：`API Key 缺失`、`请求失败`、`搜索失败`、`路径规划失败`、`生成地图行程失败`。

检查返回值的推荐方式：
```python
result = client.maps_text_search("餐厅", "北京")
if isinstance(result, list) and result and "error" in result[0]:
    print(f"错误: {result[0]['message']}")
```

## 使用示例

### 初始化客户端

```python
from scripts.amap_personal_map_client import AMapPersonalMapClient

client = AMapPersonalMapClient()  # 读取环境变量 AMAP_API_KEY
# 或直接传入：client = AMapPersonalMapClient(api_key='your_api_key_here')
```

### 地理编码

```python
# 地址转坐标
result = client.

_meta.json

{
  "ownerId": "kn73td2wbekk991h1j29rjzba982bv3e",
  "slug": "personal-map",
  "version": "1.0.0",
  "publishedAt": 1776653056108
}

skill-card.md

## Description:

Generates personal Gaode Map QR codes and supports geocoding, reverse geocoding, POI search, nearby search, route planning, and IP location through the AMap Web Service API.

This skill is ready for commercial/non-commercial use.

## Publisher:

[lbs-amap](https://clawhub.ai/user/lbs-amap)

### License/Terms of Use:

MIT-0

## Use Case:

External users and developers use this skill to turn address, POI, nearby-place, and route requests into Gaode Map personal-map QR codes that can be opened in the Gaode Map app.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Sensitive addresses, trips, customer locations, or private itineraries may be sent to AMap services and to a QR generation service.

Mitigation: Use the skill only when sharing that location data with those services is acceptable, and avoid private or regulated location data unless appropriate approval is in place.

Risk: Generated QR images, schema URLs, and fallback links can reveal personal map or itinerary details if saved or shared broadly.

Mitigation: Store generated files in a controlled workspace, limit redistribution of QR codes and URLs, and remove generated artifacts when they are no longer needed.

Risk: The artifact instructs sessions to generate a personal-map QR code broadly, which can be surprising when the user only wanted search or routing information.

Mitigation: Confirm the user wants a QR code or personal-map link before generating, downloading, or presenting map artifacts.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/lbs-amap/skills/personal-map)
- [ClawHub publisher profile](https://clawhub.ai/user/lbs-amap)
- [Gaode Open Platform](https://lbs.amap.com/)
- [QR code generation service endpoint](https://api.qrserver.com/v1/create-qr-code/)

## Skill Output:

**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Files, Guidance]

**Output Format:** [Markdown guidance with Python examples, shell environment setup, JSON-like API results, URLs, and local QR image files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires AMAP_API_KEY; map and itinerary data may be sent to AMap services and QR generation services when QR code output is requested.]

## Skill Version(s):

1.0.0 (source: server release evidence, SKILL.md frontmatter, and config.json; artifact changelog also mentions v1.2.0)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

config.json

{
  "skill": {
    "name": "personal-map",
    "version": "1.0.0",
    "description": "高德个人地图Skill，直接调用高德地图官方RESTful API，提供完整的地理信息服务能力，并支持地图在高德App中扫码查看及分析给他人",
    "author": "高德开放平台",
    "license": "MIT"
  },
  "dependencies": {
    "requests": "^2.25.1"
  },
  "env_vars": {
    "AMAP_API_KEY": {
      "description": "高德地图API Key。首次使用时，系统会自动检测并提示配置。获取步骤：1. 访问 https://lbs.amap.com/ 2. 注册/登录账号 3. 创建应用获取 Web服务 API Key。配置方式：export AMAP_API_KEY='your_api_key_here' 或在初始化时传入",
      "required": true
    }
  },
  "entry_point": "scripts/amap_personal_map_client.py"
}

requirements.txt

# 高德地图 Personal-Map Skill 依赖包
# 
# 安装方式：
#   pip install -r requirements.txt
#
# 或者使用虚拟环境：
#   python -m venv venv
#   source venv/bin/activate  # Linux/Mac
#   # 或 venv\Scripts\activate  # Windows
#   pip install -r requirements.txt

# HTTP 请求库，用于调用高德地图 API
requests>=2.25.1

Github ReposUpdated 20h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.